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 는 로깅을 오프 하기 위해서 사용되는 특수한 레벨입니다.

SEVERE

public static final Level  SEVERE

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

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

WARNING

public static final Level  WARNING

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

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

INFO

public static final Level  INFO

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

통상, INFO 메세지는 콘솔 또는 콘솔에 상당하는 것에 기입해집니다. 따라서, INFO 레벨은 최종 사용자와 시스템 관리 책임자가 이해로 나무꽤 중요한 메세지에게만 사용하지 않으면 안됩니다.

CONFIG

public static final Level  CONFIG

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

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

FINE

public static final Level  FINE

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

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

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

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

FINER

public static final Level  FINER

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

FINEST

public static final Level  FINEST

FINEST 는 매우 상세한 트레이스 메세지를 나타냅니다.

ALL

public static final Level  ALL

ALL 는 모든 메세지의 로그를 취하는 것을 나타냅니다.

생성자의 상세

Level

protected Level(String  name,
                int value)

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

이 constructor 은 서브 클래스화할 수 있게 「protect」가 되어 있습니다. 일반적으로, 로그의 클라이언트는 SEVERE 또는 FINEST 등의 정수 Level 오브젝트의 어느쪽이든을 사용할 필요가 있습니다. 다만, 클라이언트가 새로운 로그 레벨을 추가할 필요가 있는 경우는 Level 를 서브 클래스화해 새로운 정수를 정의할 수가 있습니다.

파라미터:

name - Level 의 이름. 예를 들어 "SEVERE#

value - 레벨의 정수치

Level

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

지정된 정수치와 지정된 지역 대응 리소스명으로 이름 첨부 Level 를 작성합니다.

파라미터:

name - Level 의 이름. 예를 들어 "SEVERE#

value - 레벨의 정수치

resourceBundleName - 지정된 이름의 지역 대응에 사용되는 리소스 번들명 (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"

반환값:

구문 분석 되는 값

예외:

NullPointerException - 이름이 null 의 경우

IllegalArgumentException - 치가 기존의 이름의 1 개에서도 정수치도 아닌 경우

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