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

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 может содержать тип процессора, глубину графики, внешний вид графического интерфейса пользователя и т. д. Этот уровень инициализирован значением 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)

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

Обратите внимание, что этот конструктор имеет модификатор «protected», чтобы разрешить создание подклассов. В общем случае клиенты ведения журнала должны использовать один из постоянных объектов Level, таких как 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()

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

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

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 тогда и только тогда, когда два объекта имеют одинаковое значение уровня.

См. также:

hashCode

public int hashCode()

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

Переопределяет:

hashCode в классе Object

Возвращает:

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

См. также:

© 1993, 2023, 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://docs.oracle.com/en/java/javase/21/docs/api/java.logging/java/util/logging/Level.html