LogRecord (Java 2 플랫폼 SE v1. 4.0)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2
Platform
Std. Ed. v1. 4.0

전의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요: 상자 | 필드 | constructor | 메소드

상세: 필드 | constructor | 메소드

java.util.logging
클래스 LogRecord

java.lang.Object 
  |
  +--java.util.logging.LogRecord

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

public class LogRecord
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 로그 메세지

메소드의 상세

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 constructor 에 할당할 수 있어 constructor 은 신규의 각 LogRecord 에 승순으로 일의의 순차 순서 번호를 할당합니다.

반환값:: 순차 순서 번호

setSequenceNumber

public void setSequenceNumber(long seq)

순차 순서 번호를 설정합니다.

통상, 순차 순서 번호는 LogRecord constructor 에 할당할 수 있습니다. 따라서, 통상 이 메소드를 사용할 필요가 없습니다.

getSourceClassName

public String  getSourceClassName()

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

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

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

반환값:: 소스 클래스의 이름

setSourceClassName

public void setSourceClassName(String  sourceClassName)

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

파라미터:: sourceClassName - 소스 클래스의 이름

getSourceMethodName

public String  getSourceMethodName()

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

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

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

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

setSourceMethodName

public void setSourceMethodName(String  sourceMethodName)

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

파라미터:: sourceMethodName - 소스 메소드의 이름

getMessage

public String  getMessage()

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

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

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

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

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

setMessage

public void setMessage(String  message)

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

파라미터:: message - 미변환의 메세지 캐릭터 라인

getParameters

public Object [] getParameters()

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

반환값:: 로그 메세지의 파라미터. 파라미터가 없는 경우는 null 의 경우가 있다

setParameters

public void setParameters(Object [] parameters)

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

파라미터:: parameters - 로그 메세지의 파라미터

getThreadID

public int getThreadID()

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

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

반환값:: 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 를 설정합니다.

개요