Класс уровня

Все реализованные интерфейсы:
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 Level ALL

ALL указывает, что все сообщения должны быть зарегистрированы.
static Level CONFIG

CONFIG — уровень сообщений для сообщений статической конфигурации.
static Level FINE

FINE — уровень сообщений, предоставляющий информацию для отслеживания.
static Level FINER

FINER указывает сообщение для отслеживания с довольно подробной информацией.
static Level FINEST

FINEST указывает сообщение для отслеживания с очень подробной информацией.
static Level INFO

INFO — уровень сообщений для информационных сообщений.
static Level OFF

OFF — специальный уровень, который можно использовать для отключения регистрации.
static Level SEVERE

SEVERE — уровень сообщений, указывающий на серьезную ошибку.
static Level WARNING

WARNING — уровень сообщений, указывающий на потенциальную проблему.

Конструкторы

Модификатор Конструктор Описание
protected Level​(String name, int value)

Создать именованный уровень с заданным целочисленным значением.
protected Level​(String name, int value, String resourceBundleName)

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

Методы

Модификатор и тип Метод Описание
boolean equals​(Object ox)

Сравнить два объекта для равенства значений.
String getLocalizedName()

Возвратить локализованное строковое имя уровня для текущей локальной настройки по умолчанию.
String getName()

Возвратить нелокализованное строковое имя уровня.
String getResourceBundleName()

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

Вычислить хэш-код.
int intValue()

Получить целочисленное значение для этого уровня.
static Level parse​(String name)

Распарсить строку имени уровня в уровень Level.
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)

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

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

hashCode

public int hashCode()

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

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

© 1993, 2020, 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/11/docs/api/java.logging/java/util/logging/Level.html

Spec-Zone .ru
спецификации, руководства, описания, API