Уровень класса

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 final Level`	`ALL`	ALL указывает, что все сообщения должны быть зарегистрированы.
`static final Level`	`CONFIG`	CONFIG — уровень сообщений для сообщений о статической конфигурации.
`static final Level`	`FINE`	FINE — уровень сообщений, предоставляющий отладочную информацию.
`static final Level`	`FINER`	FINER указывает сообщение отладки с довольно подробной информацией.
`static final Level`	`FINEST`	FINEST указывает сообщение отладки с очень подробной информацией.
`static final Level`	`INFO`	INFO — уровень сообщений для информационных сообщений.
`static final Level`	`OFF`	OFF — специальный уровень, который может быть использован для отключения регистрации.
`static final Level`	`SEVERE`	SEVERE — уровень сообщений, указывающий на серьезную ошибку.
`static final Level`	`WARNING`	WARNING — уровень сообщений, указывающий на потенциальную проблему.

Краткое описание конструкторов

Level(String name,
 int value)

Level(String name,
 int value,
 String resourceBundleName)

Модификатор	Конструктор	Описание
`protected`	Создает уровень с заданным именем и целочисленным значением.
`protected`	Создает уровень с заданным именем, целочисленным значением и именем ресурса локализации.

Краткое описание методов

Модификатор и тип	Метод	Описание
`boolean`	`equals(Object ox)`	Сравнение двух объектов на равенство по значению.
`String`	`getLocalizedName()`	Возвращает локализованное строковое имя уровня для текущей локале.
`String`	`getName()`	Возвращает нелокализованное строковое имя уровня.
`String`	`getResourceBundleName()`	Возвращает имя пакета локализации уровня или null, если пакет локализации не определен.
`int`	`hashCode()`	Генерирует хэш-код.
`final int`	`intValue()`	Получение целочисленного значения для данного уровня.
`static Level`	`parse(String name)`	Парсинг строкового имени уровня в уровень Level.
`final 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 и определить новые константы.

Parameters:: name — имя уровня, например "SEVERE".; value — целое значение для уровня.
Throws:: NullPointerException — если имя равно null

Level

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

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

Parameters:: name — имя уровня, например "SEVERE".; value — целое значение для уровня.; resourceBundleName — имя набора ресурсов локализации для использования при локализации заданного имени. Если resourceBundleName равно null или пустой строке, оно игнорируется.
Throws:: NullPointerException — если имя равно null

Подробное описание методов

getResourceBundleName

public String getResourceBundleName()

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

Returns:: имя набора ресурсов локализации

getName

public String getName()

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

Returns:: нелокализованное имя

getLocalizedName

public String getLocalizedName()

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

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

Returns:: локализованное имя

toString

public final String toString()

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

Overrides:: toString в классе Object
Returns:: нелокализованное имя уровня, например "INFO".

intValue

public final int intValue()

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

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

parse

public static Level parse(String name) throws IllegalArgumentException

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

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

Например:

"SEVERE"
"1000"

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

equals

public boolean equals(Object ox)

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

Overrides:

equals в классе Object

Parameters:

ox — ссылка на объект для сравнения.

Returns:

true, если и только если два объекта имеют одинаковое значение уровня.

See Also:

hashCode

public int hashCode()

Генерация хэш-кода.

Overrides:

hashCode в классе Object

Returns:

хэш-код, основанный на значении уровня

See Also:

© 1993, 2025, 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.logging/java/util/logging/Level.html