Spec-Zone.ru › OpenJDK 25

Класс 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

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

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 тогда и только тогда, когда значения уровней двух объектов совпадают.
См. также:
  • Object.hashCode()
  • HashMap

hashCode

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

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по API и документацию для разработчиков см. в разделе Документация Java SE, содержащем более подробные описания для разработчиков, обзоры концепций, определения терминов, способы обхода проблем и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или её аффилированных лиц в США и других странах.
Авторское право © 1993, 2025, Oracle и/или её аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API