LogRecord (Java 2 Platform SE 5.0)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

개요: NESTED | 필드 | constructor | 메서드

상세: 필드 | 생성자 | 메서드

java.util.logging
클래스 LogRecord

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

모든 구현된 인터페이스:: Serializable

public class LogRecord
extends Object
implements Serializable
extends Object
implements Serializable

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

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

클라이언트 어플리케이션이, 소스 메서드명과 소스 클래스명을 명시적으로 지정하지 않는 경우, getSourceMethodName 또는 getSourceClassName 호출에 의해 최초로 액세스 되었을 때에 LogRecord 클래스는 호출해 스택을 분석해 자동적으로 이러한 이름을 추정하는 것에 주의해 주세요. 따라서, 로그 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를 구축합니다.

순서 프로퍼티는 새로운 일의의 값으로 초기화됩니다. 이러한 연속하는 값은 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()

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

이 sourceMethodName는 검증되지 않기 때문에 스프핑 될 가능성이 있는 것에 주의해 주세요. 이 정보는 로그 호출의 일부로서 제공되는지, 또는 로그의 체제에 의해 자동적으로 추정될까의 머지않아인가입니다. 후자의 경우, 이 정보는 근사적인 것에 지나지 않고, 실제 스택 프레임의 이전의 호출을 나타내고 있는 경우가 있습니다.

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

반환값:: 소스 메서드의 이름

setSourceMethodName

public void setSourceMethodName(String  sourceMethodName)

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

파라미터:: sourceMethodName - 소스 메서드명 (null인 경우가 있다)

getMessage

public String  getMessage()

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

null인 경우가 있어, 이것은 비어있는 캐릭터 라인 "" 과 동등합니다.

이 메세지는 파이널 텍스트 또는 지역 대응 키의 머지않아인가입니다.

포맷 처리시에 소스 로거가 지역 대응 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 식별자이며, 임의의 OS 식별자에 매핑 되는 경우로 여겨지지 않는 경우가 있습니다.

반환값:: 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 - throwable (null인 경우가 있다)

개요