java.util.logging
클래스 Level

java.lang.Object 
  java.util.logging.Level

모든 구현된 인터페이스:

Serializable

public class Level
extends Object 
implements Serializable 

Level 클래스는 로그 출력의 제어에 사용되는 표준 로그 레벨세트를 정의합니다. 로그 Level 객체는 순서 붙일 수 있는 것과 동시에 순서를 갖는 정수형에 의해 지정됩니다. 지정된 레벨에서의 로깅을 유효하게 하면, 보다 높은 모든 레벨에서의 로깅도 유효하게 됩니다.

보통, 클라이언트는 Level.SEVERE 등 정의 끝난 Level 정수를 사용할 필요가 있습니다.

레벨은 내림차순으로 다음과 같습니다.

• SEVERE (최고치)
• WARNING
• INFO
• CONFIG
• FINE
• FINER
• FINEST (최저치)

이것들 이외에 로깅을 오프 하기 위해서 사용되는 레벨 OFF 및 모든 메세지의 로깅을 유효하게 하기 위해서 사용되는 레벨 ALL가 있습니다.

Sun 이외가 Level를 상속하는 것으로 로그 레벨을 추가 정의하는 것이 가능합니다. 이러한 경우, 서브 클래스는 일의의 정수값 레벨을 선택해, 적절한 readResolve 메서드를 정의하는 것으로써, 직렬화를 통해 Object가 일의의 프로퍼티를 보관 유지할 수 있도록 주의할 필요가 있습니다.

도입된 버전 :

1.4

관련 항목:

직렬화 된 형식

필드 개요

static Level	ALL ALL는 모든 메세지의 로그를 취하는 것을 나타냅니다.
static Level	CONFIG CONFIG는 정적인 구성 메세지의 메세지 레벨입니다.
static Level	FINE FINE는 트레이스 정보를 제공하는 메세지 레벨입니다.
static Level	FINER FINER는 꽤 상세한 트레이스 메세지를 나타냅니다.
static Level	FINEST FINEST는 극히 상세한 트레이스 메세지를 나타냅니다.
static Level	INFO INFO는 메세지를 정보로서 제공하는 메세지 레벨입니다.
static Level	OFF OFF는 로그를 오프로 하기 위해서 사용 가능한 특수 레벨입니다.
static Level	SEVERE SEVERE는 중대한 장해를 나타내는 메세지 레벨입니다.
static Level	WARNING WARNING는 잠재적인 문제를 나타내는 메세지 레벨입니다.

생성자 개요

protected	Level (String name, int value) 지정된 정수값 로 이름 첨부 Level를 작성합니다.
protected	Level (String name, int value, String resourceBundleName) 지정된 정수값 와 지정된 지역 대응 자원명으로 이름 첨부 Level를 작성합니다.

메서드 개요

boolean	equals (Object ox) 2개의 객체의 값이 동일한지 어떤지를 비교합니다.
String	getLocalizedName () 현재의 디폴트 로케일에 대해서 Level 지역화 캐릭터 라인명을 리턴합니다.
String	getName () Level 지역 대응되어 있지 않은 캐릭터 라인명을 리턴합니다.
String	getResourceBundleName () 레벨의 지역 대응 자원 번들명, 또는 지역 대응 번들이 정의되어 있지 않은 경우는 null을 리턴합니다.
int	hashCode () 해시 코드를 생성합니다.
int	intValue () 이 레벨의 정수값을 취득합니다.
static Level	parse (String name) 레벨명의 캐릭터 라인을 Level에 구문 분석 합니다.
String	toString () 객체의 캐릭터 라인 표현을 리턴합니다.

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

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

필드의 상세

OFF

public static final Level  OFF

OFF는 로그를 오프로 하기 위해서 사용 가능한 특수 레벨입니다. 이 레벨은, Integer.MAX_VALUE에 초기화됩니다.

SEVERE

public static final Level  SEVERE

SEVERE는 중대한 장해를 나타내는 메세지 레벨입니다.

일반적으로 SEVERE 메세지는 정상적인 프로그램의 실행을 방해한다, 꽤 중요한 이벤트를 설명합니다. 이 메세지는 최종 사용자와 시스템 관리 책임자에 있어 알기 쉬운 것으로 않으면 안됩니다. 이 레벨은, 1000에 초기화됩니다.

WARNING

public static final Level  WARNING

WARNING는 잠재적인 문제를 나타내는 메세지 레벨입니다.

일반적으로 WARNING 메세지에서는 최종 사용자 또는 시스템 관리 책임자가 관심을 가진다, 또는 잠재적인 문제를 나타내는 이벤트를 설명합니다. 이 레벨은 900에 초기화됩니다.

INFO

public static final Level  INFO

INFO는 메세지를 정보로서 제공하는 메세지 레벨입니다.

보통, INFO 메세지는 콘솔 또는 콘솔에 상당하는 것에 출력해집니다. 따라서, INFO 레벨은 최종 사용자와 시스템 관리 책임자를 이해할 수 있는 적당히 중요한 메세지에게만 사용하지 않으면 안됩니다. 이 레벨은 800에 초기화됩니다.

CONFIG

public static final Level  CONFIG

CONFIG는 정적인 구성 메세지의 메세지 레벨입니다.

CONFIG 메세지는 다양한 정적 구성 정보를 제공해, 특정의 구성에 관련된 디버그 문제에 도움이 되는 것을 도하고 있습니다. 예를 들어 CONFIG 메세지에는 CPU 형태, 그래픽의 심도, GUI Look & Feel 등이 포함됩니다. 이 레벨은 700에 초기화됩니다.

FINE

public static final Level  FINE

FINE는 트레이스 정보를 제공하는 메세지 레벨입니다.

FINE, FINER 및 FINEST는 비교적 상세한 트레이스를 위해서 사용됩니다. 3개의 레벨의 정확한 미는 하부조직에 따라서 다릅니다만, 일반적으로는 FINEST는 가장 다량의 상세 출력에 사용되어 FINER는 약간 적은 상세 출력에 사용되어 FINE는 가장 소량에서 가장 중요한 메세지에 사용됩니다.

일반적으로 FINE 레벨은 특정의 하부조직에 특별한 관심을 가지지 않는 개발자에게 있어 넓게 흥미가 있는 정보를 위해서 사용됩니다.

FINE 메세지는 복구 가능한 작은 장해등의 메세지를 포함한 경우가 있습니다. 또, 퍼포먼스의 잠재적인 불편을 나타내는 문제는 FINE 로서 로그를 취할만한 가값이 있습니다. 이 레벨은 500에 초기화됩니다.

FINER

public static final Level  FINER

FINER는 꽤 상세한 트레이스 메세지를 나타냅니다. 디폴트로 예외의 입력, 돌아와, Throw등의 로그 호출은 이 레벨로 트레이스 됩니다. 이 레벨은 400에 초기화됩니다.

FINEST

public static final Level  FINEST

FINEST는 극히 상세한 트레이스 메세지를 나타냅니다. 이 레벨은 300에 초기화됩니다.

ALL

public static final Level  ALL

ALL는 모든 메세지의 로그를 취하는 것을 나타냅니다. 이 레벨은 Integer.MIN_VALUE에 초기화됩니다.

생성자 상세

Level

protected Level(String  name,
                int value)

지정된 정수값 로 이름 첨부 Level를 작성합니다.

이 생성자는 상속할 수 있도록 「protect」가 되어 있습니다. 일반적으로 로그의 클라이언트는 SEVERE 또는 FINEST 등의 정수 Level 객체의 어느쪽이든을 사용할 필요가 있습니다. 다만, 클라이언트가 새로운 로그 레벨을 추가할 필요가 있는 경우는 Level를 상속해 새로운 정수를 정의할 수 있습니다 .

파라미터:

name - Level 이름. 예를 들어 「SEVERE」

value - 레벨의 정수값

예외:

NullPointerException - 이름이 null인 경우

Level

protected Level(String  name,
                int value,
                String  resourceBundleName)

지정된 정수값 와 지정된 지역 대응 자원명으로 이름 첨부 Level를 작성합니다.

파라미터:

name - Level 이름. 예를 들어 「SEVERE」

value - 레벨의 정수값

resourceBundleName - 지정된 이름의 지역 대응에 사용되는 자원 번들명. resourceBundleName가 null 또는 비어있는 캐릭터 라인의 경우, 이것은 무시된다

예외:

NullPointerException - 이름이 null인 경우

메서드의 상세

getResourceBundleName

public String  getResourceBundleName()

레벨의 지역 대응 자원 번들명, 또는 지역 대응 번들이 정의되어 있지 않은 경우는 null을 리턴합니다.

반환값:

지역 대응의 자원 번들명

getName

public String  getName()

Level 지역 대응되어 있지 않은 캐릭터 라인명을 리턴합니다.

반환값:

지역 대응되어 있지 않은 이름

getLocalizedName

public String  getLocalizedName()

현재의 디폴트 로케일에 대해서 Level 지역화 캐릭터 라인명을 리턴합니다.

지역 대응 정보를 사용할 수 없는 경우, 지역 대응되어 있지 않은 이름이 리턴됩니다 .

반환값:

지역 대응된 이름

toString

public final String  toString()

클래스 Object 기술:

객체의 캐릭터 라인 표현을 리턴합니다. 보통, toString 메서드는 이 객체를 「텍스트로 표현한다」캐릭터 라인을 리턴합니다. 이 결과는 인간이 읽을 수 있는 간결하고 유익한 정보여야 합니다. 모든 서브 클래스에서 이 메서드를 오버라이드(override) 하는 것을 추천합니다.

Object 클래스의 toString 메서드는 객체의 파생원의 클래스명, @ 부호 (@) 및 객체의 해시 코드의 부호 없음 16 진표현으로부터 구성되는 캐릭터 라인을 리턴합니다. 즉, 이 메서드는 다음의 값과 동일한 캐릭터 라인을 리턴합니다.

 getClass(). getName() + '@' + Integer.toHexString(hashCode())
 

오버라이드(override):

클래스 Object 내의 toString

반환값:

Level 지역 대응되어 있지 않은 이름. 예를 들어 「INFO」

intValue

public final int intValue()

이 레벨의 정수값을 취득합니다. 이 정수값는 Level 객체간의 순서부의 효율적인 비교에 사용됩니다.

반환값:

이 레벨의 정수값

parse

public static Level  parse(String  name)
                   throws IllegalArgumentException 

레벨명의 캐릭터 라인을 Level에 구문 분석 합니다.

인수 캐릭터 라인은 레벨명 또는 정수값 의 어느쪽이든으로 구성됩니다.

다음에 예를 나타냅니다.

• "SEVERE"
• "1000"

파라미터:

name - 구문 분석 되는 캐릭터 라인

반환값:

구문 분석 된 값. 기존의 이름 (예, 700)에 대응하는 정수를 건네주면, 관련된 이름 (예, CONFIG)이 리턴된다. 대응하지 않는 정수 (예, 1)를 건네주면, 그 값에 초기화된 새로운 레벨명이 리턴된다

예외:

NullPointerException - 이름이 null인 경우

IllegalArgumentException - 값이 유효하지 않은 경우. 유효한 값은, Integer.MIN_VALUE ~ Integer.MAX_VALUE 정수값 및 기존의 레벨명 모두. 기존의 이름은 이 클래스에 의해 정의된 레벨 (FINE, FINER, FINEST), 이 클래스에 의해 적절한 패키지 액세스로 작성된 레벨, 또는 서브 클래스에 의해 정의 혹은 작성된 새로운 레벨이다

equals

public boolean equals(Object  ox)

2개의 객체의 값이 동일한지 어떤지를 비교합니다.

오버라이드(override):

클래스 Object 내의 equals

파라미터:

ox - 비교 대상의 참조 객체

반환값:

2개의 객체가 같은 레벨의 값을 가지는 경우에게만 true

관련 항목:

Object.hashCode(), Hashtable

hashCode

public int hashCode()

해시 코드를 생성합니다.

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

레벨의 값에 근거하는 해시 코드

관련 항목:

Object.equals(java.lang.Object), Hashtable