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

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()`	Возвращает строковое представление уровня Level.

Методы, объявленные в классе 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()

Получить целочисленное значение для данного уровня. Это целочисленное значение может быть использовано для эффективного сравнения порядка между объектами 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, 2021, 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/17/docs/api/java.logging/java/util/logging/Level.html