Spec-Zone .ru
спецификации, руководства, описания, API
|
public class Level extends Object implements Serializable
Клиенты должны обычно использовать предопределенные константы Уровня, такие как Уровень. СЕРЬЕЗНЫЙ.
Уровни в порядке убывания:
Для третьих сторон возможно определить дополнительные уровни журналирования, разделяя Уровень на подклассы. В таких случаях подклассы должны заботиться, выбрал уникальные целочисленные значения уровня и гарантировать, что они поддерживают Объектное свойство уникальности через сериализацию, определяя подходящий readResolve метод.
Модификатор и Тип | Поле и Описание |
---|---|
static Level |
ВСЕ
ВСЕ указывает, что все сообщения должны быть зарегистрированы.
|
static Level |
КОНФИГУРАЦИЯ
КОНФИГУРАЦИЯ является уровнем сообщения для статических сообщений конфигурации.
|
static Level |
ПРЕКРАСНЫЙ
ПРЕКРАСНЫЙ уровень сообщения предоставляющая информация о трассировке.
|
static Level |
БОЛЕЕ ПРЕКРАСНЫЙ
БОЛЕЕ ПРЕКРАСНЫЙ указывает на довольно подробное сообщение трассировки.
|
static Level |
САМЫЙ ПРЕКРАСНЫЙ
САМЫЙ ПРЕКРАСНЫЙ указывает на очень подробное сообщение трассировки.
|
static Level |
ИНФОРМАЦИЯ
ИНФОРМАЦИЯ является уровнем сообщения для информационных сообщений.
|
static Level |
ПРОЧЬ
ПРОЧЬ специальный уровень, который может использоваться, чтобы выключить журналирование.
|
static Level |
СЕРЬЕЗНЫЙ
СЕРЬЕЗНЫЙ уровень сообщения, указывающий на серьезный отказ.
|
static Level |
ПРЕДУПРЕЖДЕНИЕ
ПРЕДУПРЕЖДЕНИЕ является уровнем сообщения, указывающим на потенциальную проблему.
|
Модификатор | Конструктор и Описание |
---|---|
protected |
Level(String name, int value)
Создайте именованный Уровень с данным целочисленным значением.
|
protected |
Level(String name, int value, String resourceBundleName)
Создайте именованный Уровень с данным целочисленным значением и данным именем ресурса локализации.
|
Модификатор и Тип | Метод и Описание |
---|---|
boolean |
equals(Object ox)
Сравните два объекта для равенства значения.
|
Строка |
getLocalizedName()
Возвратите локализованное имя строки Уровня для текущей локали значения по умолчанию.
|
Строка |
getName()
Возвратите нелокализованное имя строки Уровня.
|
Строка |
getResourceBundleName()
Возвратите имя пакета ресурса локализации уровня, или нуль, если никакой пакет локализации не определяется.
|
int |
hashCode()
Генерируйте хэш-код.
|
int |
intValue()
Получите целочисленное значение для этого уровня.
|
static Level |
parse(String name)
Проанализируйте строку имени уровня в Уровень.
|
Строка |
toString()
Возвращает строковое представление этого Уровня.
|
public static final Level OFF
Integer.MAX_VALUE
.public static final Level SEVERE
В общих СЕРЬЕЗНЫХ сообщениях должен описать события, которые имеют значительное значение и которые предотвратят нормальное выполнение программы. Они должны быть разумно понятными конечным пользователям и системным администраторам. Этот уровень инициализируется к 1000
.
public static final Level WARNING
В общих Предупреждающих сообщениях должен описать события, которые будут представлять интерес для конечных пользователей или администраторов системы, или которые указывают на потенциальные проблемы. Этот уровень инициализируется к 900
.
public static final Level INFO
Обычно сообщения ИНФОРМАЦИИ будут записаны консоли или ее эквиваленту. Таким образом, уровень ИНФОРМАЦИИ должен только использоваться для разумно существенных сообщений, которые будут иметь смысл к конечным пользователям и системным администраторам. Этот уровень инициализируется к 800
.
public static final Level CONFIG
Сообщения КОНФИГУРАЦИИ предназначаются, чтобы обеспечить множество статической конфигурационной информации, помочь в отладке проблем, которые могут быть связаны с определенными конфигурациями. Например, сообщение КОНФИГУРАЦИИ могло бы включать тип ЦП, графическую глубину, стиль GUI, и т.д. Этот уровень инициализируется к 700
.
public static final Level FINE
Все ПРЕКРАСНЫЕ, БОЛЕЕ ПРЕКРАСНЫЕ, и САМЫЙ ПРЕКРАСНЫЙ предназначаются для относительно подробной трассировки. Точное значение этих трех уровней изменится между подсистемами, но вообще, САМЫЙ ПРЕКРАСНЫЙ должен использоваться для самого пространного подробного вывода, БОЛЕЕ ПРЕКРАСНОГО для несколько менее подробного вывода, и ПРЕКРАСНЫЙ для самого низкого объема (и самый важный) сообщения.
Вообще ПРЕКРАСНЫЙ уровень должен использоваться для информации, которая будет широко интересна разработчикам, у которых нет специализированного интереса к определенной подсистеме.
ПРЕКРАСНЫЕ сообщения могли бы включать вещи как незначительные (восстанавливаемые) отказы. Проблемы, указывающие на потенциальные проблемы производительности, также стоят регистрировать как ПРЕКРАСНЫЙ. Этот уровень инициализируется к 500
.
public static final Level FINER
400
.public static final Level FINEST
300
.public static final Level ALL
Integer.MIN_VALUE
.protected Level(String name, int value)
Отметьте, что этот конструктор "защищается", чтобы позволить разделять на подклассы. В общих клиентах журналирования должен использовать один из постоянных объектов Уровня такой как СЕРЬЕЗНЫЙ или САМЫЙ ПРЕКРАСНЫЙ. Однако, если клиенты должны добавить новые уровни журналирования, они могут разделить Уровень на подклассы и определить новые константы.
name
- имя Уровня, например "СЕРЬЕЗНОГО".value
- целочисленное значение для уровня.NullPointerException
- если имя является нулемprotected Level(String name, int value, String resourceBundleName)
name
- имя Уровня, например "СЕРЬЕЗНОГО".value
- целочисленное значение для уровня.resourceBundleName
- имя ресурса связывается, чтобы использовать в локализации имени. Если resourceBundleName является нулем или пустой строкой, это игнорируется.NullPointerException
- если имя является нулемpublic String getResourceBundleName()
public String getName()
public String getLocalizedName()
Если никакая информация о локализации не доступна, нелокализованное имя возвращается.
public final String toString()
public final int intValue()
public static Level parse(String name) throws IllegalArgumentException
Строка параметра может состоять или из имени уровня или из целочисленного значения.
Например:
name
- строка, которая будет проанализированаCONFIG
). Передача целого числа, которое не делает (например, 1) возвратит новое имя уровня, инициализированное тому значению.NullPointerException
- если имя является нулемIllegalArgumentException
- если значение не допустимо. Допустимые значения являются целыми числами между Integer.MIN_VALUE
и Integer.MAX_VALUE
, и все известные имена уровня. Известные имена являются уровнями, определенными этим class (например, FINE
, FINER
, FINEST
), или создаваемый этим class с соответствующим доступом пакета, или новыми уровнями, определенными или создаваемыми подклассами.public boolean equals(Object ox)
equals
в class Object
ox
- ссылочный объект, с которым можно сравниться.Object.hashCode()
, HashMap
public int hashCode()
hashCode
в class Object
Object.equals(java.lang.Object)
, System.identityHashCode(java.lang.Object)
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92