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는 하늘의 캐릭터 라인을 돌려줍니다만, 이 처리는 서브 클래스에 의해 오버라이드(override) 되는 경우가 있습니다.

파라미터:

h - 타겟 핸들러

반환값:

헤더 캐릭터 라인

getTail

public String  getTail(Handler  h)

포맷 된 레코드 세트의 말미의 캐릭터 라인을 돌려줍니다.

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

파라미터:

h - 타겟 핸들러

반환값:

말미의 캐릭터 라인

formatMessage

public String  formatMessage(LogRecord  record)

로그 레코드로부터의 메세지 캐릭터 라인을 지역 대응하도록(듯이) 포맷 합니다. 이 메소드는 Formatter 의 서브 클래스가 포맷 처리를 용이하게 실행할 수 있게 제공됩니다.

메세지 캐릭터 라인은 레코드의 ResourceBundle 를 사용해, 우선 포맷 캐릭터 라인에 지역 대응됩니다. ResourceBundle 가 없는 경우, 또는 메세지 키가 발견되지 않는 경우는 키가 포맷 캐릭터 라인으로서 사용됩니다. 포맷 String 는 java.text 스타일의 포맷 처리를 사용합니다.

• 파라미터가 없는 경우, 포매터는 사용되지 않는다
• 파라미터가 있어, 캐릭터 라인에 "{0" 의 다음에 java.text.MessageFormat 가 포함되는 경우는 포매터는 캐릭터 라인의 포맷에 사용된다
• 그 이외의 경우는 포맷 처리는 실행되지 않는다

파라미터:

record - raw 메세지를 포함한 로그 레코드

반환값:

지역 대응하도록(듯이) 포맷 된 메세지