Уровень (Платформа Java SE 7)

java.lang. Объект
- java.util.logging. Уровень

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

Сериализуемый
```
public class Level
extends Object
implements Serializable
```
Класс Уровня определяет ряд стандартного журналирования уровней, которые могут использоваться, чтобы управлять выводом журналирования. Объекты Уровня журналирования упорядочиваются и определяются упорядоченными целыми числами. Включение регистрирующий на данном уровне также позволяет регистрировать во всех более высоких уровнях.
Клиенты должны обычно использовать предопределенные константы Уровня, такие как Уровень. СЕРЬЕЗНЫЙ.
Уровни в порядке убывания:
- СЕРЬЕЗНЫЙ (самое высокое значение)
- ПРЕДУПРЕЖДЕНИЕ
- ИНФОРМАЦИЯ
- КОНФИГУРАЦИЯ
- ПРЕКРАСНЫЙ
- БОЛЕЕ ПРЕКРАСНЫЙ
- САМЫЙ ПРЕКРАСНЫЙ (самое низкое значение)
Кроме того, есть уровень ОТ этого, может использоваться, чтобы выключить журналирование, и уровень ВСЕ, что может использоваться, чтобы позволить регистрировать всех сообщений.
Для третьих сторон возможно определить дополнительные уровни журналирования, разделяя Уровень на подклассы. В таких случаях подклассы должны заботиться, выбрал уникальные целочисленные значения уровня и гарантировать, что они поддерживают Объектное свойство уникальности через сериализацию, определяя подходящий readResolve метод.
С тех пор:

1.4

См. Также:
Сериализированная Форма

Полевая Сводка

Поля
Модификатор и Тип	Поле и Описание
`static Level`	`ВСЕ` ВСЕ указывает, что все сообщения должны быть зарегистрированы.
`static Level`	`КОНФИГУРАЦИЯ` КОНФИГУРАЦИЯ является уровнем сообщения для статических сообщений конфигурации.
`static Level`	`ПРЕКРАСНЫЙ` ПРЕКРАСНЫЙ уровень сообщения предоставляющая информация о трассировке.
`static Level`	`БОЛЕЕ ПРЕКРАСНЫЙ` БОЛЕЕ ПРЕКРАСНЫЙ указывает на довольно подробное сообщение трассировки.
`static Level`	`САМЫЙ ПРЕКРАСНЫЙ` САМЫЙ ПРЕКРАСНЫЙ указывает на очень подробное сообщение трассировки.
`static Level`	`ИНФОРМАЦИЯ` ИНФОРМАЦИЯ является уровнем сообщения для информационных сообщений.
`static Level`	`ПРОЧЬ` ПРОЧЬ специальный уровень, который может использоваться, чтобы выключить журналирование.
`static Level`	`СЕРЬЕЗНЫЙ` СЕРЬЕЗНЫЙ уровень сообщения, указывающий на серьезный отказ.
`static Level`	`ПРЕДУПРЕЖДЕНИЕ` ПРЕДУПРЕЖДЕНИЕ является уровнем сообщения, указывающим на потенциальную проблему.

Сводка конструктора

Конструкторы
Модификатор	Конструктор и Описание
`protected`	`Level(String name, int value)` Создайте именованный Уровень с данным целочисленным значением.
`protected`	`Level(String name, int value, String resourceBundleName)` Создайте именованный Уровень с данным целочисленным значением и данным именем ресурса локализации.

Сводка метода

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

Методы java.lang унаследованный от класса. Объект
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Полевая Деталь
  - ПРОЧЬ
```
public static final Level OFF
```
    ПРОЧЬ специальный уровень, который может использоваться, чтобы выключить журналирование. Этот уровень инициализируется к Integer.MAX_VALUE.
  - СЕРЬЕЗНЫЙ
```
public static final Level SEVERE
```
    СЕРЬЕЗНЫЙ уровень сообщения, указывающий на серьезный отказ.
    В общих СЕРЬЕЗНЫХ сообщениях должен описать события, которые имеют значительное значение и которые предотвратят нормальное выполнение программы. Они должны быть разумно понятными конечным пользователям и системным администраторам. Этот уровень инициализируется к 1000.
  - ПРЕДУПРЕЖДЕНИЕ
```
public static final Level WARNING
```
    ПРЕДУПРЕЖДЕНИЕ является уровнем сообщения, указывающим на потенциальную проблему.
    В общих Предупреждающих сообщениях должен описать события, которые будут представлять интерес для конечных пользователей или администраторов системы, или которые указывают на потенциальные проблемы. Этот уровень инициализируется к 900.
  - ИНФОРМАЦИЯ
```
public static final Level INFO
```
    ИНФОРМАЦИЯ является уровнем сообщения для информационных сообщений.
    Обычно сообщения ИНФОРМАЦИИ будут записаны консоли или ее эквиваленту. Таким образом, уровень ИНФОРМАЦИИ должен только использоваться для разумно существенных сообщений, которые будут иметь смысл к конечным пользователям и системным администраторам. Этот уровень инициализируется к 800.
  - КОНФИГУРАЦИЯ
```
public static final Level CONFIG
```
    КОНФИГУРАЦИЯ является уровнем сообщения для статических сообщений конфигурации.
    Сообщения КОНФИГУРАЦИИ предназначаются, чтобы обеспечить множество статической конфигурационной информации, помочь в отладке проблем, которые могут быть связаны с определенными конфигурациями. Например, сообщение КОНФИГУРАЦИИ могло бы включать тип ЦП, графическую глубину, стиль GUI, и т.д. Этот уровень инициализируется к 700.
  - ПРЕКРАСНЫЙ
```
public static final Level FINE
```
    ПРЕКРАСНЫЙ уровень сообщения предоставляющая информация о трассировке.
    Все ПРЕКРАСНЫЕ, БОЛЕЕ ПРЕКРАСНЫЕ, и САМЫЙ ПРЕКРАСНЫЙ предназначаются для относительно подробной трассировки. Точное значение этих трех уровней изменится между подсистемами, но вообще, САМЫЙ ПРЕКРАСНЫЙ должен использоваться для самого пространного подробного вывода, БОЛЕЕ ПРЕКРАСНОГО для несколько менее подробного вывода, и ПРЕКРАСНЫЙ для самого низкого объема (и самый важный) сообщения.
    Вообще ПРЕКРАСНЫЙ уровень должен использоваться для информации, которая будет широко интересна разработчикам, у которых нет специализированного интереса к определенной подсистеме.
    ПРЕКРАСНЫЕ сообщения могли бы включать вещи как незначительные (восстанавливаемые) отказы. Проблемы, указывающие на потенциальные проблемы производительности, также стоят регистрировать как ПРЕКРАСНЫЙ. Этот уровень инициализируется к 500.
  - БОЛЕЕ ПРЕКРАСНЫЙ
```
public static final Level FINER
```
    БОЛЕЕ ПРЕКРАСНЫЙ указывает на довольно подробное сообщение трассировки. Значением по умолчанию, регистрирующим призывы к вводу, возврат, или выдача исключения прослеживается на этом уровне. Этот уровень инициализируется к 400.
  - САМЫЙ ПРЕКРАСНЫЙ
```
public static final Level FINEST
```
    САМЫЙ ПРЕКРАСНЫЙ указывает на очень подробное сообщение трассировки. Этот уровень инициализируется к 300.
  - ВСЕ
```
public static final Level ALL
```
    ВСЕ указывает, что все сообщения должны быть зарегистрированы. Этот уровень инициализируется к Integer.MIN_VALUE.
- Деталь конструктора
  - Уровень
```
protected Level(String name,
     int value)
```
    Создайте именованный Уровень с данным целочисленным значением.
    Отметьте, что этот конструктор "защищается", чтобы позволить разделять на подклассы. В общих клиентах журналирования должен использовать один из постоянных объектов Уровня такой как СЕРЬЕЗНЫЙ или САМЫЙ ПРЕКРАСНЫЙ. Однако, если клиенты должны добавить новые уровни журналирования, они могут разделить Уровень на подклассы и определить новые константы.
    
    Параметры:
    name - имя Уровня, например "СЕРЬЕЗНОГО".
    value - целочисленное значение для уровня.
    
    Броски:
    
    NullPointerException - если имя является нулем
  - Уровень
```
protected Level(String name,
     int value,
     String resourceBundleName)
```
    Создайте именованный Уровень с данным целочисленным значением и данным именем ресурса локализации.
    
    Параметры:
    name - имя Уровня, например "СЕРЬЕЗНОГО".
    value - целочисленное значение для уровня.
    resourceBundleName - имя ресурса связывается, чтобы использовать в локализации имени. Если resourceBundleName является нулем или пустой строкой, это игнорируется.
    
    Броски:
    
    NullPointerException - если имя является нулем
- Деталь метода
  - getResourceBundleName
```
public String getResourceBundleName()
```
    Возвратите имя пакета ресурса локализации уровня, или нуль, если никакой пакет локализации не определяется.
    
    Возвраты:
    ресурс локализации связывает имя
  - getName
```
public String getName()
```
    Возвратите нелокализованное имя строки Уровня.
    
    Возвраты:
    нелокализованное имя
  - getLocalizedName
```
public String getLocalizedName()
```
    Возвратите локализованное имя строки Уровня для текущей локали по умолчанию.
    Если никакая информация о локализации не доступна, нелокализованное имя возвращается.
    
    Возвраты:
    локализованное имя
  - toString
```
public final String toString()
```
    Возвращает строковое представление этого Уровня.
    
    Переопределения:
    
    toString в классе Object
    
    Возвраты:
    нелокализованное имя Уровня, например "ИНФОРМАЦИЯ".
  - intValue
```
public final int intValue()
```
    Получите целочисленное значение для этого уровня. Это целочисленное значение может использоваться для эффективных сравнений упорядочивания между объектами Уровня.
    
    Возвраты:
    целочисленное значение для этого уровня.
  - синтаксический анализ
```
public static Level parse(String name)
                   throws IllegalArgumentException
```
    Проанализируйте строку имени уровня в Уровень.
    Строка параметра может состоять или из имени уровня или из целочисленного значения.
    Например:
    - "СЕРЬЕЗНЫЙ"
    - "1000"
    Параметры:
    name - строка, которая будет проанализирована
    
    Возвраты:
    Проанализированное значение. Передача целого числа, которое соответствует известному имени (например, 700) возвратит связанное имя (например, CONFIG). Передача целого числа, которое не делает (например, 1) возвратит новое имя уровня, инициализированное тому значению.
    
    Броски:
    
    NullPointerException - если имя является нулем
    
    IllegalArgumentException - если значение не допустимо. Допустимые значения являются целыми числами между Integer.MIN_VALUE и Integer.MAX_VALUE, и все известные имена уровня. Известные имена являются уровнями, определенными этим классом (например, FINE, FINER, FINEST), или создаваемый этим классом с соответствующим доступом пакета, или новыми уровнями, определенными или создаваемыми подклассами.
  - равняется
```
public boolean equals(Object ox)
```
    Сравните два объекта для равенства значения.
    
    Переопределения:
    
    equals в классе Object
    
    Параметры:
    ox - ссылочный объект, с которым можно сравниться.
    
    Возвраты:
    истина, если и только если у двух объектов есть то же самое значение уровня.
    См. Также:
    Object.hashCode(), HashMap
  - хэш-код
```
public int hashCode()
```
    Генерируйте хэш-код.
    
    Переопределения:
    
    hashCode в классе Object
    
    Возвраты:
    хэш-код, основанный на значении уровня
    См. Также:
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

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

Полевая Сводка

Сводка конструктора

Сводка метода

Методы java.lang унаследованный от класса. Объект

Полевая Деталь

ПРОЧЬ

СЕРЬЕЗНЫЙ

ПРЕДУПРЕЖДЕНИЕ

ИНФОРМАЦИЯ

КОНФИГУРАЦИЯ

ПРЕКРАСНЫЙ

БОЛЕЕ ПРЕКРАСНЫЙ

САМЫЙ ПРЕКРАСНЫЙ

ВСЕ

Деталь конструктора

Уровень

Уровень

Деталь метода

getResourceBundleName

getName

getLocalizedName

toString

intValue

синтаксический анализ

равняется

хэш-код