Класс Уровня

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

Все реализованные интерфейсы:: Serializable

public class Level
extends Object
implements Serializable

Класс Level определяет набор стандартных уровней ведения журнала, которые могут использоваться для управления выводом журнала. Объекты уровня ведения журнала упорядочены и задаются упорядоченными целыми числами. Включение ведения журнала на заданном уровне также включает ведение журнала на всех более высоких уровнях.

Клиенты обычно должны использовать предопределенные константы уровня, такие как Level.SEVERE.

Уровни в порядке убывания:

SEVERE (наибольшее значение)
WARNING
INFO
CONFIG
FINE
FINER
FINEST (наименьшее значение)

Кроме того, есть уровень OFF, который можно использовать для отключения ведения журнала, и уровень ALL, который можно использовать для включения ведения журнала всех сообщений.

Третьи стороны могут определять дополнительные уровни ведения журнала, наследуя класс Level. В таких случаях подклассы должны позаботиться о выборе уникальных целочисленных значений уровня и о поддержании свойства уникальности объекта при сериализации, определив подходящий метод readResolve.

С:: 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)` Создать именованный уровень с заданным целочисленным значением.
`protected`	`Level(String name, int value, String resourceBundleName)` Создать именованный уровень с заданным целочисленным значением и заданным именем ресурса локализации.

Методы

Модификатор и тип	Метод и описание
`boolean`	`equals(Object ox)` Сравнить два объекта на равенство значений.
`String`	`getLocalizedName()` Возвращает локализованное строковое имя уровня для текущего локального языка.
`String`	`getName()` Возвращает строковое имя уровня без локализации.
`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 может включать тип процессора, глубину графики, вид GUI и т. д. Этот уровень инициализирован значением 700.

FINE

public static final Level FINE

FINE — это уровень сообщений, предоставляющий информацию для отслеживания.

Все уровни FINE, FINER и FINEST предназначены для относительно подробного отслеживания. Точное значение трех уровней будет различаться между подсистемами, но в общем случае FINEST должен использоваться для наиболее объемного подробного вывода, FINER — для несколько менее подробного вывода, а FINE — для сообщений с наименьшим объемом (и наиболее важными).

В общем случае уровень FINE следует использовать для информации, которая будет широко интересна разработчикам, не имеющим специализированного интереса к конкретной подсистеме.

Сообщения FINE могут включать такие вещи, как незначительные (восстановимые) сбои. Проблемы, указывающие на потенциальные проблемы с производительностью, также заслуживают ведения журнала на уровне FINE. Этот уровень инициализирован значением 500.

FINER

public static final Level FINER

FINER указывает на довольно подробное сообщение об отслеживании. По умолчанию вызовы ведения журнала для входа, возвращения или выброса исключения отслеживаются на этом уровне. Этот уровень инициализирован значением 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)

Создает именованный уровень с заданным целочисленным значением.

Обратите внимание, что этот конструктор является «защищенным», чтобы разрешить наследование. В общем случае клиенты ведения журнала должны использовать один из константных объектов уровня, таких как SEVERE или FINEST. Однако, если клиентам нужно добавить новые уровни ведения журнала, они могут унаследовать Level и определить новые константы.

Параметры:: name — имя уровня, например «SEVERE».; value — целочисленное значение уровня.
Исключения:: NullPointerException — если имя равно null

Level

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

Создает именованный уровень с заданным целочисленным значением и именем ресурса локализации.

Параметры:: name — имя уровня, например «SEVERE».; value — целочисленное значение уровня.; resourceBundleName — имя ресурсного пакета для использования при локализации заданного имени. Если resourceBundleName равно null или пустой строке, оно игнорируется.
Исключения:: NullPointerException — если имя равно null

Методы

getResourceBundleName

public String getResourceBundleName()

Возвращает имя ресурсного пакета локализации уровня или null, если пакет локализации не определен.

Возвращает:: имя ресурсного пакета локализации

getName

public String getName()

Возвращает имя уровня без локализации.

Возвращает:: имя без локализации

getLocalizedName

public String getLocalizedName()

Возвращает локализованное имя уровня для текущего языка по умолчанию.

Если информация о локализации недоступна, возвращается имя без локализации.

Возвращает:: локализованное имя

toString

public final String toString()

Возвращает строковое представление этого уровня.

Переопределяет:: toString в классе Object
Возвращает:: имя уровня без локализации, например «INFO».

intValue

public final int intValue()

Получает целочисленное значение для этого уровня. Это целочисленное значение может использоваться для эффективного сравнения по порядку между объектами уровня.

Возвращает:: целочисленное значение для этого уровня.

parse

public static Level parse(String name)
                   throws IllegalArgumentException

Разбирает строку имени уровня в уровень.

Строка аргумента может содержать имя уровня или целочисленное значение.

Например:

"SEVERE"
"1000"

Параметры:: name — строка для разбора
Возвращает:: Разбор значения. Передача целого числа, соответствующего известному имени (например, 700), вернет связанное имя (например, CONFIG). Передача целого числа, которого нет (например, 1), вернет новое имя уровня, инициализированное этим значением.
Исключения:: NullPointerException — если имя равно null; IllegalArgumentException — если значение недействительно. Действительные значения — целые числа между Integer.MIN_VALUE и Integer.MAX_VALUE, и все известные имена уровней. Известные имена — уровни, определенные этим классом (например, FINE, FINER, FINEST), или созданные этим классом с соответствующим доступом к пакету, или новые уровни, определенные или созданные подклассами.

equals

public boolean equals(Object ox)

Сравнивает два объекта на равенство по значению.

Переопределяет:: equals в классе Object
Параметры:: ox — объект-ссылка для сравнения.
Возвращает:: true, если и только если два объекта имеют одинаковое значение уровня.
См. также:: Object.hashCode(), HashMap

hashCode

public int hashCode()

Генерирует хэш-код.

Переопределяет:: hashCode в классе Object
Возвращает:: хэш-код, основанный на значении уровня
См. также:: Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.