Класс Level

java.lang.Object

java.util.logging.Level

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

public class Level extends Object implements Serializable

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

Обычно клиентам следует использовать предопределённые константы Level, например Level.SEVERE.

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

SEVERE (наивысшее значение)
WARNING
INFO
CONFIG
FINE
FINER
FINEST (наименьшее значение)

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

Сторонние разработчики могут определять дополнительные уровни журналирования, создавая подклассы Level. В таких случаях подклассам следует выбирать уникальные целочисленные значения уровней и обеспечивать сохранение свойства уникальности Object при сериализации, определив подходящий метод 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`	Создаёт именованный уровень Level с заданным целочисленным значением.
`protected`	Создаёт именованный уровень Level с заданным целочисленным значением и заданным именем ресурса локализации.

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

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

Методы, объявленные в классе Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удалён в будущей версии. Финализация объявлена устаревшей и может быть удалена в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Переводит текущий поток в ожидание до его пробуждения, обычно посредством вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Переводит текущий поток в ожидание до его пробуждения, обычно посредством вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Переводит текущий поток в ожидание до его пробуждения, обычно посредством вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

Подробное описание полей

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)

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

Обратите внимание, что этот конструктор имеет модификатор доступа "protected", чтобы разрешить создание подклассов. Как правило, клиентам журналирования следует использовать один из объектов-констант Level, например SEVERE или FINEST. Однако, если клиентам необходимо добавить новые уровни журналирования, они могут создать подкласс Level и определить новые константы.

Параметры:: name — имя уровня Level, например "SEVERE".; value — целочисленное значение уровня.
Выбрасывает:: NullPointerException — если имя равно null

Level

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

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

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

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

getResourceBundleName

public String getResourceBundleName()

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

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

getName

public String getName()

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

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

getLocalizedName

public String getLocalizedName()

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

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

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

toString

public final String toString()

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

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

intValue

public final int intValue()

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

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

parse

public static Level parse(String name) throws IllegalArgumentException

Преобразует строковое имя уровня в объект Level.

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

Например:

"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, 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.