java.util.logging
클래스 LogRecord

java.lang.Object 
  java.util.logging.LogRecord

모든 구현된 인터페이스:

Serializable

public class LogRecord
extends Object 
implements Serializable 

LogRecord 객체를 사용해, 로그의 시스템와 개개의 로그 Handler 간의 로깅의 요구를 건네줍니다.

LogRecord 가 로그의 시스템에게 건네지면(자), LogRecord 는 논리적으로 그 시스템에 소속합니다. 클라이언트 어플리케이션이 사용하거나 갱신 해서는 안됩니다.

클라이언트 어플리케이션이 명시적인 소스 메소드명과 소스 클래스명을 지정하지 않았던 경우, LogRecord 클래스는, getSourceMethodName 또는 getSourceClassName 호출 경유로 그러한 이름이 처음으로 액세스 된 시점에서, 호출 스택을 분석하는 것으로 그러한 이름을 자동적으로 추측하는 것에 주의해 주세요. 따라서, 로깅 Handler 는, LogRecord 를 다른 thread에 건네주거나 RMI 경유로 송신하거나 한 후에 메소드명이나 클래스명의 정보를 취득할 수 있도록(듯이) 하고 싶은 경우는, getSourceClassName, getSourceMethodName 의 어느쪽이든을 호출하는 것으로, 값이 강제적으로 설정되도록(듯이) 해야 합니다.

직렬화에 관한 주의:

• LogRecord 클래스는 직렬화 가능하다
• 파라미터 배열의 객체는 직렬화할 수 없기 때문에, 직렬화시에 파라미터 배열의 모든 객체는 Object.toString 를 사용해 대응하는 String 로서 기입해진다
• ResourceBundle 는 직렬화 된 형식의 일부로서 전송 되지 않지만, 자원 번들명은 전송 되어 접수측의 객체의 readObject 메소드는 적절한 자원 번들을 검출하려고 한다

도입된 버젼:

1.4

관련 항목:

직렬화 된 형식

생성자 의 개요

LogRecord (Level level, String msg)
지정된 레벨과 메세지의 값을 가지는 LogRecord 를 구축합니다.

메소드의 개요

Level	getLevel () 로그 메세지 레벨, 예를 들어 Level.SEVERE 를 돌려줍니다.
String	getLoggerName () 소스 Logger 의 이름을 돌려줍니다.
String	getMessage () 지역화 또는 포맷 처리전에, 미변환의 로그 메세지를 돌려줍니다.
long	getMillis () 1970 년 이후의 이벤트의 시간을 돌려줍니다 (밀리 세컨드 단위).
Object []	getParameters () 로그 메세지에 파라미터를 돌려줍니다.
ResourceBundle	getResourceBundle () 로컬라이제이션리소스반돌을 돌려줍니다.
String	getResourceBundleName () 로컬라이제이션리소스반돌의 이름을 돌려줍니다.
long	getSequenceNumber () 순서 번호를 돌려줍니다.
String	getSourceClassName () 로깅의 요구를 발행했는지, 발행했다고 보여지는 클래스의 이름을 돌려줍니다.
String	getSourceMethodName () 로깅의 요구를 발행했는지, 발행했다고 보여지는 클래스의 이름을 돌려줍니다.
int	getThreadID () 메세지의 발생원의 thread의 식별자를 돌려줍니다.
Throwable	getThrown () 로그 레코드에 관련한 Throwable 를 돌려줍니다.
void	setLevel (Level level) 로그 메세지의 레벨, 예를 들어 Level.SEVERE 를 설정합니다.
void	setLoggerName (String name) 소스 Logger 의 이름을 설정합니다.
void	setMessage (String message) 지역화 또는 포맷 처리전에, 미변환의 로그 메세지를 설정합니다.
void	setMillis (long millis) 이벤트의 시간을 설정합니다.
void	setParameters (Object [] parameters) 로그 메세지에 파라미터를 설정합니다.
void	setResourceBundle (ResourceBundle bundle) 로컬라이제이션리소스반돌을 설정합니다.
void	setResourceBundleName (String name) 로컬라이제이션리소스반돌의 이름을 설정합니다.
void	setSequenceNumber (long seq) 순서 번호를 설정합니다.
void	setSourceClassName (String sourceClassName) 로깅의 요구를 발행했는지, 발행했다고 보여지는 클래스의 이름을 설정합니다.
void	setSourceMethodName (String sourceMethodName) 로깅의 요구를 발행했는지, 발행했다고 보여지는 메소드의 이름을 설정합니다.
void	setThreadID (int threadID) 메세지의 발생원의 thread의 식별자를 설정합니다.
void	setThrown (Throwable thrown) 로그 이벤트에 관련한 Throwable 를 설정합니다.

클래스 java.lang. Object 로부터 상속된 메소드

clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait

생성자 의 상세

LogRecord

public LogRecord(Level  level,
                 String  msg)

지정된 레벨과 메세지의 값을 가지는 LogRecord 를 구축합니다.

sequence 프로퍼티은 새로운 일의의 값으로 초기화됩니다. 이러한 연번치는, VM 내에서 승순에 할당할 수 있습니다.

millis 프로퍼티은, 현재의 시각에 초기화됩니다.

thread ID 프로퍼티은 현재의 thread에 대한 일의의 ID 로 초기화됩니다.

그 외 모든 프로퍼티은 null 에 초기화됩니다.

파라미터:

level - 로그 레벨의 값

msg - 로컬라이즈되어 있지 않은 raw 로그 메세지 (null 도 가능)

메소드의 상세

getLoggerName

public String  getLoggerName()

소스 Logger 의 이름을 돌려줍니다.

반환값:

소스 로거이름 (null 의 경우가 있다)

setLoggerName

public void setLoggerName(String  name)

소스 Logger 의 이름을 설정합니다.

파라미터:

name - 소스 로거이름 (null 의 경우가 있다)

getResourceBundle

public ResourceBundle  getResourceBundle()

로컬라이제이션리소스반돌을 돌려줍니다.

이것은, 메세지 캐릭터 라인의 포맷전에 그 캐릭터 라인을 로컬라이즈 하는데 사용해야 할 ResourceBundle 입니다. 메세지가 로컬라이즈 가능하지 않은 경우, 또는 적절한 ResourceBundle 가 사용 가능하지 않은 경우는, 결과가 null 가 됩니다.

setResourceBundle

public void setResourceBundle(ResourceBundle  bundle)

로컬라이제이션리소스반돌을 설정합니다.

파라미터:

bundle - 로컬라이제이션반돌 (null 의 경우가 있다)

getResourceBundleName

public String  getResourceBundleName()

로컬라이제이션리소스반돌의 이름을 돌려줍니다.

이것은, 메세지 캐릭터 라인의 포맷전에 그 캐릭터 라인을 로컬라이즈 하는데 사용해야 할 ResourceBundle 의 이름입니다. 메세지가 로컬라이즈 가능하지 않은 경우는, 결과가 null 가 됩니다.

setResourceBundleName

public void setResourceBundleName(String  name)

로컬라이제이션리소스반돌의 이름을 설정합니다.

파라미터:

name - 로컬라이제이션반돌의 이름 (null 의 경우가 있다)

getLevel

public Level  getLevel()

로그 메세지 레벨, 예를 들어 Level.SEVERE 를 돌려줍니다.

반환값:

로그 메세지의 레벨

setLevel

public void setLevel(Level  level)

로그 메세지의 레벨, 예를 들어 Level.SEVERE 를 설정합니다.

파라미터:

level - 로그 메세지의 레벨

getSequenceNumber

public long getSequenceNumber()

순서 번호를 돌려줍니다.

일반적으로, 순서 번호는 LogRecord 생성자 에 할당할 수 있어 생성자 은 신규의 각 LogRecord 에 승순으로 일의의 순서 번호를 할당합니다.

반환값:

순서 번호

setSequenceNumber

public void setSequenceNumber(long seq)

순서 번호를 설정합니다.

일반적으로, 순서 번호는 LogRecord 생성자 에 할당할 수 있습니다. 따라서, 일반적으로 이 메소드를 사용할 필요가 없습니다.

getSourceClassName

public String  getSourceClassName()

로깅의 요구를 발행했는지, 발행했다고 보여지는 클래스의 이름을 돌려줍니다.

이 sourceClassName 는 검증되지 않기 때문에, 스프핑 될 가능성이 있는 것에 주의해 주세요. 이 정보는, 로깅 호출의 일부로서 제공되었는지, 로깅후레임워크에 의해 자동적으로 추측된 것입니다. 후자의 경우, 이 정보는 개산치에 지나지 않고, 실제, 스택 프레임상의 이전의 호출을 기술한 것일 가능성이 있습니다.

정보가 취득되지 않는 경우는 null 의 경우가 있습니다.

반환값:

소스 클래스의 이름

setSourceClassName

public void setSourceClassName(String  sourceClassName)

로깅의 요구를 발행했는지, 발행했다고 보여지는 클래스의 이름을 설정합니다.

파라미터:

sourceClassName - 소스 클래스명 (null 의 경우가 있다)

getSourceMethodName

public String  getSourceMethodName()

로깅의 요구를 발행했는지, 발행했다고 보여지는 클래스의 이름을 돌려줍니다.

이 sourceClassName 는 검증되지 않기 때문에, 스프핑 될 가능성이 있는 것에 주의해 주세요. 이 정보는, 로깅 호출의 일부로서 제공되었는지, 로깅후레임워크에 의해 자동적으로 추측된 것입니다. 후자의 경우, 이 정보는 개산치에 지나지 않고, 실제, 스택 프레임상의 이전의 호출을 기술한 것일 가능성이 있습니다.

정보가 취득되지 않는 경우는 null 의 경우가 있습니다.

반환값:

소스 메소드의 이름

setSourceMethodName

public void setSourceMethodName(String  sourceMethodName)

로깅의 요구를 발행했는지, 발행했다고 보여지는 메소드의 이름을 설정합니다.

파라미터:

sourceMethodName - 소스 메소드명 (null 의 경우가 있다)

getMessage

public String  getMessage()

지역화 또는 포맷 처리전에, 미변환의 로그 메세지를 돌려줍니다.

null 의 경우가 있어, 이것은 빈 상태(empty)의 캐릭터 라인 "" 과 동등합니다.

이 메세지는, 파이널 텍스트 또는 로컬라이제이션키의 머지않아인가입니다.

포맷 처리시에, 소스 로거가 로컬라이제이션 ResourceBundle 를 가지고 있어 그 ResourceBundle 가 이 메세지 캐릭터 라인에 대한 엔트리를 가지고 있는 경우는, 메세지 캐릭터 라인은 로컬라이즈 된 값으로 옮겨집니다.

반환값:

미변환의 메세지 캐릭터 라인

setMessage

public void setMessage(String  message)

지역화 또는 포맷 처리전에, 미변환의 로그 메세지를 설정합니다.

파라미터:

message - 미변환의 메세지 캐릭터 라인 (null 의 경우도 있다)

getParameters

public Object [] getParameters()

로그 메세지에 파라미터를 돌려줍니다.

반환값:

로그 메세지의 파라미터 파라미터가 존재하지 않는 경우는 null

setParameters

public void setParameters(Object [] parameters)

로그 메세지에 파라미터를 설정합니다.

파라미터:

parameters - 로그 메세지의 파라미터(null 도 가능)

getThreadID

public int getThreadID()

메세지의 발생원의 thread의 식별자를 돌려줍니다.

이것은 Java VM 내의 thread 식별자이며, 임의의 operating system 식별자에 매핑 되는 경우로 여겨지지 않는 경우가 있습니다.

반환값:

thread ID

setThreadID

public void setThreadID(int threadID)

메세지의 발생원의 thread의 식별자를 설정합니다.

파라미터:

threadID - thread의 ID

getMillis

public long getMillis()

1970 년 이후의 이벤트의 시간을 돌려줍니다 (밀리 세컨드 단위).

반환값:

1970 년 이후의 이벤트의 시간 (밀리 세컨드 단위)

setMillis

public void setMillis(long millis)

이벤트의 시간을 설정합니다.

파라미터:

millis - 1970 년 이후의 이벤트의 시간 (밀리 세컨드 단위)

getThrown

public Throwable  getThrown()

로그 레코드에 관련한 Throwable 를 돌려줍니다.

이벤트가 예외를 포함한 경우, 이것은 예외 객체가 됩니다. 포함하지 않는 경우는 null 가 됩니다.

반환값:

throwable

setThrown

public void setThrown(Throwable  thrown)

로그 이벤트에 관련한 Throwable 를 설정합니다.

파라미터:

thrown - throw 가능 객체 (null 도 가능)