JavaTM Platform
Standard Ed. 6

java.util.logging
클래스 Formatter

java.lang.Object 
  상위를 확장 java.util.logging.Formatter
직계의 기존의 서브 클래스:
SimpleFormatter , XMLFormatter


public abstract class Formatter
extends Object

Formatter 는 LogRecord 의 포맷 처리를 지원합니다.  

일반적으로, 각 로깅 Handler 에는 Formatter 를 관련지을 수 있습니다. Formatter 는 LogRecord 를 받아, 그것을 캐릭터 라인으로 변환합니다.  

XMLFormatter 등의 일부의 포매터는, 일련의 포맷이 끝난 레코드의 전후에 선두 캐릭터 라인과 말미 캐릭터 라인을 부가할 필요가 있습니다. getHeader 및 getTail 메소드를 사용하면, 이러한 캐릭터 라인을 취득할 수 있습니다.

도입된 버젼:
1.4

생성자 의 개요
protected Formatter ()
          새로운 포매터를 구축합니다.
 
메소드의 개요
abstract  String format (LogRecord  record)
          지정된 로그 레코드를 포맷 해, 포맷 된 캐릭터 라인을 돌려줍니다.
 String formatMessage (LogRecord  record)
          로그 레코드로부터의 메세지 캐릭터 라인을 로컬라이즈 하도록(듯이) 포맷 합니다.
 String getHead (Handler  h)
          포맷 된 레코드세트의 헤더 캐릭터 라인을 돌려줍니다.
 String getTail (Handler  h)
          포맷 된 레코드 세트의 말미의 캐릭터 라인을 돌려줍니다.
 
클래스 java.lang. Object 로부터 상속된 메소드
clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait
 

생성자 의 상세

Formatter

protected Formatter()
새로운 포매터를 구축합니다.

메소드의 상세

format

public abstract String  format(LogRecord  record)
지정된 로그 레코드를 포맷 해, 포맷 된 캐릭터 라인을 돌려줍니다.  

일반적으로, 포맷 된 String 의 결과에는, 로컬라이즈 해 포맷 된 버젼의 LogRecord 의 메세지 필드가 포함됩니다. Formatter.formatMessage 의 편리한 메소드 (생략 가능)를 사용해, 메세지 필드를 로컬라이즈 해, 포맷 할 수가 있습니다.

파라미터:
record - 포맷 되는 로그 레코드
반환값:
포맷 된 로그 레코드

getHead

public String  getHead(Handler  h)
포맷 된 레코드세트의 헤더 캐릭터 라인을 돌려줍니다.  

이 base class는 빈 상태(empty)의 캐릭터 라인을 돌려줍니다만, 이 처리는 서브 클래스에 의해 오버라이드(override) 되는 경우가 있습니다.

파라미터:
h - 타겟 핸들러 (null 도 가능)
반환값:
헤더 캐릭터 라인

getTail

public String  getTail(Handler  h)
포맷 된 레코드 세트의 말미의 캐릭터 라인을 돌려줍니다.  

이 base class는 빈 상태(empty)의 캐릭터 라인을 돌려줍니다만, 이 처리는 서브 클래스에 의해 오버라이드(override) 되는 경우가 있습니다.

파라미터:
h - 타겟 핸들러 (null 도 가능)
반환값:
말미의 캐릭터 라인

formatMessage

public String  formatMessage(LogRecord  record)
로그 레코드로부터의 메세지 캐릭터 라인을 로컬라이즈 하도록(듯이) 포맷 합니다. 이 메소드는, Formatter 의 서브 클래스가 포맷 처리를 실행할 때에 사용 가능한 간이 수단으로서 제공되고 있습니다.  

메세지 캐릭터 라인은, 레코드의 ResourceBundle 를 사용해, 우선 포맷 캐릭터 라인에 로컬라이즈 됩니다. (ResourceBundle 가 존재하지 않는 경우 또는 메세지 키가 발견되지 않는 경우는, 그 키가 포맷 캐릭터 라인으로서 사용됩니다. ) 포맷 String 는, java.text 스타일의 포맷 처리를 사용합니다.

파라미터:
record - raw 메세지를 포함한 로그 레코드
반환값:
로컬라이즈 하도록(듯이) 포맷 된 메세지

JavaTM Platform
Standard Ed. 6

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.