Регистратор (Платформа Java SE 7)

java.lang. Объект
- java.util.logging. Регистратор

```
public class Logger
extends Object
```
Объект Регистратора используется, чтобы зарегистрировать сообщения для определенной системы или компонента приложения. Регистраторы обычно называют, используя иерархическое разделенное от точки пространство имен. Имена регистратора могут быть произвольными строками, но они должны обычно быть основаны на имени пакета или имени класса зарегистрированного компонента, такой как java.net или javax.swing. Кроме того, возможно создать "анонимные" Регистраторы, которые не сохранены в пространстве имен Logger.
Объекты регистратора могут быть получены запросами к одному из getLogger методов фабрики. Они или создадут новый Регистратор или возвратят подходящий существующий Регистратор. Важно отметить что Регистратор, возвращенный одним из getLogger методы фабрики могут быть собраны "мусор" в любое время, если сильная ссылка на Регистратор не сохраняется.
Журналирование сообщений будет передано зарегистрированным Объектам-обработчикам, которые могут передать сообщения ко множеству мест назначения, включая консоли, файлы, журналы ОС, и т.д.
Каждый Регистратор отслеживает "родительский" Регистратор, который является его самым близким существующим предком в пространстве имен Logger.
Каждому Регистратору связали "Уровень" с этим. Это отражает минимальный уровень, о котором заботится этот регистратор. Если уровень Регистратора устанавливается в null, то его эффективный уровень наследован от его родителя, который может поочередно получить это рекурсивно из его родителя, и так далее дерево.
Уровень журнала может быть сконфигурирован основанный на свойствах от конфигурационного файла журналирования, как описано в описании класса LogManager. Однако это может также быть динамически изменено запросами к методу Logger.setLevel. Если уровень регистратора изменяется, изменение может также влиять на дочерние регистраторы, так как любой дочерний регистратор, у которого есть null как его уровень, наследует свой эффективный уровень от его родителя.
На каждом вызове журналирования Регистратор первоначально выполняет дешевую проверку уровня запроса (например, СЕРЬЕЗНЫЙ или ПРЕКРАСНЫЙ) против эффективного уровня журнала регистратора. Если уровень запроса ниже чем уровень журнала, вызов журналирования сразу возвращается.
После передачи этого начального (дешевого) теста Регистратор выделит LogRecord, чтобы описать сообщение журналирования. Это тогда вызовет Фильтр (если есть), чтобы сделать, более подробное начинает работу, должна ли запись быть опубликована. Если это передаст это, то тогда опубликует LogRecord к его выходным Обработчикам. По умолчанию регистраторы также публикуют к Обработчикам их родителя, рекурсивно дерево.
Каждый Регистратор может сделать, чтобы ResourceBundle назвал связанным с этим. Именованный пакет будет использоваться для того, чтобы локализовать сообщения журналирования. Если Регистратор не сделает, чтобы его собственный ResourceBundle назвал, то он наследует имя ResourceBundle от своего родителя, рекурсивно дерево.
Большинство выходных методов регистратора берет параметр "сообщения". Этим параметром сообщения может быть или необработанное значение или ключ локализации. Во время форматирования, если регистратор имеет (или наследовался), ResourceBundle локализации и если у ResourceBundle есть отображение для строки сообщения, то строка сообщения заменяется локализованным значением. Иначе исходная строка сообщения используется. Как правило, средства форматирования используют java.text. Форматирование стиля MessageFormat, чтобы отформатировать параметры, таким образом, например строка формата" {0} {1}" отформатировала бы два параметра как строки.
Отображая имена ResourceBundle к ResourceBundles, Регистратор сначала попытается использовать ContextClassLoader Потока. Если это будет нулем, то он попробует SystemClassLoader вместо этого. Поскольку временная функция перехода в начальной реализации, если Регистратор неспособен определить местоположение ResourceBundle от ContextClassLoader или SystemClassLoader Регистратор, будет также искать стек класса и использовать последовательный вызов ClassLoaders, чтобы попытаться определить местоположение ResourceBundle. (Этот поиск стека вызовов должен позволить контейнеры переходу к использованию ContextClassLoaders и, вероятно, будет удален в будущих версиях.)
Форматирование (включая локализацию) является ответственностью выходного Обработчика, который будет обычно вызывать Средство форматирования.
Отметьте, что форматирование не должно произойти синхронно. Это может быть задержано, пока LogRecord фактически не пишется внешнему приемнику.
Методы журналирования группируются в пяти основных категориях:
- Есть ряд методов "журнала", которые берут уровень журнала, строку сообщения, и дополнительно некоторые параметры к строке сообщения.
- Есть ряд "logp" методы (для "журнала, точного"), которые походят на методы "журнала", но также и берут явное исходное имя класса и имя метода.
- Есть ряд "logrb" метод (для "журнала с пакетом ресурса"), которые походят на "logp" метод, но также и берут явное имя пакета ресурса для использования в локализации сообщения журнала.
- Есть методы удобства для того, чтобы проследить записи метода ("входящие" методы), возвраты метода ("выходящие" методы) и выдать исключения (методы "броска").
- Наконец, есть ряд методов удобства для использования в очень самых простых случаях, когда разработчик просто хочет зарегистрировать простую строку на данном уровне журнала. Эти методы называют в честь имен стандартного уровня ("серьезными", "предупреждение", "информация", и т.д.) и берут единственный параметр, строку сообщения.
Для методов, которые не берут явное исходное имя и имя метода, платформа Журналирования сделает "максимальные усилия", чтобы определить который класс и метод, вызванный в метод журналирования. Однако, важно понять, что эта автоматически выведенная информация может только быть приблизительной (или может даже быть вполне неправильным!). Виртуальным машинам позволяют сделать обширную оптимизацию, когда JITing и может полностью удалить стековые фреймы, лишая возможности достоверно определять местоположение класса вызова и метода.
Все методы на Регистраторе мультиориентированы на многопотоковое исполнение.
Разделение на подклассы информации: Отметьте, что класс LogManager может обеспечить свою собственную реализацию именованных Регистраторов для любой точки в пространстве имен. Поэтому, любые подклассы Регистратора (если они не реализуются в соединении с новым классом LogManager) должны заботиться, чтобы получить экземпляр Регистратора из класса LogManager и должны делегировать операции, такие как "isLoggable" и "журнал (Запись журнала)" к тому экземпляру. Отметьте, что, чтобы прервать весь вывод журналирования, подклассы должны только переопределить журнал (Запись журнала) метод. Все другие методы журналирования реализуются как запросы к этому журналу (Запись журнала) метод.
С тех пор:

1.4

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

Поля
Модификатор и Тип	Поле и Описание
`static Logger`	`глобальная переменная` Осуждаемый. Инициализация этого поля является склонной к мертвым блокировкам. Поле должно быть инициализировано инициализацией класса Регистратора, которая может вызвать мертвые блокировки с инициализацией класса LogManager. В таких случаях две инициализации класса ожидают друг друга, чтобы завершиться. Привилегированный способ получить глобальный объект регистратора через вызов `Logger.getGlobal()`. Для совместимости со старыми версиями JDK, где `Logger.getGlobal()` не доступное использование вызов `Logger.getLogger(Logger.GLOBAL_LOGGER_NAME)` или `Logger.getLogger("global")`.
`static String`	`GLOBAL_LOGGER_NAME` GLOBAL_LOGGER_NAME является именем для глобального регистратора.

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

Конструкторы
Модификатор	Конструктор и Описание
`protected`	`Logger(String name, String resourceBundleName)` Защищенный метод, чтобы создать регистратор для именованной подсистемы.

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

Методы
Модификатор и Тип	Метод и Описание
`void`	`addHandler(Handler handler)` Добавьте Обработчик журнала, чтобы получить сообщения журналирования.
`void`	`config(String msg)` Зарегистрируйте сообщение КОНФИГУРАЦИИ.
`void`	`entering(String sourceClass, String sourceMethod)` Зарегистрируйте запись метода.
`void`	`entering(String sourceClass, String sourceMethod, Object param1)` Зарегистрируйте запись метода с одним параметром.
`void`	`entering(String sourceClass, String sourceMethod, Object[] params)` Зарегистрируйте запись метода с массивом параметров.
`void`	`exiting(String sourceClass, String sourceMethod)` Зарегистрируйте возврат метода.
`void`	`exiting(String sourceClass, String sourceMethod, Object result)` Зарегистрируйте возврат метода с объектом результата.
`void`	`fine(String msg)` Зарегистрируйте ПРЕКРАСНОЕ сообщение.
`void`	`finer(String msg)` Зарегистрируйте БОЛЕЕ ПРЕКРАСНОЕ сообщение.
`void`	`finest(String msg)` Зарегистрируйте САМОЕ ПРЕКРАСНОЕ сообщение.
`static Logger`	`getAnonymousLogger()` Создайте анонимный Регистратор.
`static Logger`	`getAnonymousLogger(String resourceBundleName)` Создайте анонимный Регистратор.
`Фильтр`	`getFilter()` Получите текущий фильтр для этого Регистратора.
`static Logger`	`getGlobal()` Возвратите глобальный объект регистратора с Регистратором имени. GLOBAL_LOGGER_NAME.
`Обработчик[]`	`getHandlers()` Свяжите Обработчики с этим регистратором.
`Уровень`	`getLevel()` Получите Уровень журнала, который был определен для этого Регистратора.
`static Logger`	`getLogger(String name)` Найдите или создайте регистратор для именованной подсистемы.
`static Logger`	`getLogger(String name, String resourceBundleName)` Найдите или создайте регистратор для именованной подсистемы.
`Строка`	`getName()` Завоюйте репутацию для этого регистратора.
`Регистратор`	`getParent()` Возвратите родителя для этого Регистратора.
`ResourceBundle`	`getResourceBundle()` Получите пакет ресурса локализации для этого регистратора для текущей локали по умолчанию.
`Строка`	`getResourceBundleName()` Получите имя пакета ресурса локализации для этого регистратора.
`boolean`	`getUseParentHandlers()` Обнаружьте, отправляет ли этот регистратор свой вывод его родительскому регистратору.
`void`	`info(String msg)` Зарегистрируйте сообщение ИНФОРМАЦИИ.
`boolean`	`isLoggable(Level level)` Проверьте, было ли сообщение данного уровня бы фактически зарегистрировано этим регистратором.
`void`	`log(Level level, String msg)` Зарегистрируйте сообщение без параметров.
`void`	`log(Level level, String msg, Object param1)` Зарегистрируйте сообщение с одним объектным параметром.
`void`	`log(Level level, String msg, Object[] params)` Зарегистрируйте сообщение с массивом объектных параметров.
`void`	`log(Level level, String msg, Throwable thrown)` Зарегистрируйте сообщение со связанной информацией о Throwable.
`void`	`log(LogRecord record)` Зарегистрируйте LogRecord.
`void`	`logp(Level level, String sourceClass, String sourceMethod, String msg)` Зарегистрируйте сообщение, определяя исходный класс и метод, без параметров.
`void`	`logp(Level level, String sourceClass, String sourceMethod, String msg, Object param1)` Зарегистрируйте сообщение, определяя исходный класс и метод, с единственным объектным параметром к сообщению журнала.
`void`	`logp(Level level, String sourceClass, String sourceMethod, String msg, Object[] params)` Зарегистрируйте сообщение, определяя исходный класс и метод, с массивом объектных параметров.
`void`	`logp(Level level, String sourceClass, String sourceMethod, String msg, Throwable thrown)` Зарегистрируйте сообщение, определяя исходный класс и метод, со связанной информацией о Throwable.
`void`	`logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg)` Зарегистрируйте сообщение, определяя исходный класс, метод, и имя пакета ресурса без параметров.
`void`	`logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg, Object param1)` Зарегистрируйте сообщение, определяя исходный класс, метод, и имя пакета ресурса, с единственным объектным параметром к сообщению журнала.
`void`	`logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg, Object[] params)` Зарегистрируйте сообщение, определяя исходный класс, метод, и имя пакета ресурса, с массивом объектных параметров.
`void`	`logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg, Throwable thrown)` Зарегистрируйте сообщение, определяя исходный класс, метод, и имя пакета ресурса, со связанной информацией о Throwable.
`void`	`removeHandler(Handler handler)` Удалите Обработчик журнала.
`void`	`setFilter(Filter newFilter)` Установите фильтр, чтобы управлять выводом на этом Регистраторе.
`void`	`setLevel(Level newLevel)` Установите уровень журнала, определяющий, какие уровни сообщения будут зарегистрированы этим регистратором.
`void`	`setParent(Logger parent)` Установите родителя для этого Регистратора.
`void`	`setUseParentHandlers(boolean useParentHandlers)` Определите, должен ли этот регистратор отправить свой вывод его родительскому Регистратору.
`void`	`severe(String msg)` Зарегистрируйте СЕРЬЕЗНОЕ сообщение.
`void`	`throwing(String sourceClass, String sourceMethod, Throwable thrown)` Журнал, выдающий исключение.
`void`	`warning(String msg)` Зарегистрируйте Предупреждающее сообщение.

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

- Полевая Деталь
  - GLOBAL_LOGGER_NAME
```
public static final String GLOBAL_LOGGER_NAME
```
    GLOBAL_LOGGER_NAME является именем для глобального регистратора.
    
    С тех пор:
    
    1.6
    
    См. Также:
    Постоянные Значения полей
  - глобальная переменная
```
@Deprecated
public static final Logger global
```
    Осуждаемый. Инициализация этого поля является склонной к мертвым блокировкам. Поле должно быть инициализировано инициализацией класса Регистратора, которая может вызвать мертвые блокировки с инициализацией класса LogManager. В таких случаях две инициализации класса ожидают друг друга, чтобы завершиться. Привилегированный способ получить глобальный объект регистратора через вызов Logger.getGlobal(). Для совместимости со старыми версиями JDK, где Logger.getGlobal() не доступное использование вызов Logger.getLogger(Logger.GLOBAL_LOGGER_NAME) или Logger.getLogger("global").
    
    "Глобальный" объект Регистратора предоставляется как удобство разработчикам, которые делают случайное использование пакета Журналирования. Разработчики, которые делают серьезное использование пакета журналирования (например в продуктах) должны создать и использовать свои собственные объекты Регистратора с соответствующими именами, так, чтобы журналированием можно было управлять на подходящей гранулярности на регистратор. Разработчики также должны сохранить сильную ссылку на свои объекты Регистратора препятствовать тому, чтобы они были собраны "мусор".
- Деталь конструктора
  - Регистратор
```
protected Logger(String name,
      String resourceBundleName)
```
    Защищенный метод, чтобы создать регистратор для именованной подсистемы.
    Регистратор будет первоначально сконфигурирован с нулевым Уровнем и с набором useParentHandlers к истине.
    
    Параметры:
    name - Имя для регистратора. Это должно быть разделенным от точки именем и должно обычно быть основано на имени пакета или имени класса подсистемы, такой как java.net или javax.swing. Это может быть нуль для анонимных Регистраторов.
    resourceBundleName - имя ResourceBundle, который будет использоваться для того, чтобы локализовать сообщения для этого регистратора. Может быть нуль, если ни одно из сообщений не требует локализации.
    
    Броски:
    
    MissingResourceException - если resourceBundleName является ненулем, и никакой соответствующий ресурс не может быть найден.
- Деталь метода
  - getGlobal
```
public static final Logger getGlobal()
```
    Возвратите глобальный объект регистратора с Регистратором имени. GLOBAL_LOGGER_NAME.
    
    Возвраты:
    глобальный объект регистратора
    С тех пор:
    
    1.7
  - getLogger
```
public static Logger getLogger(String name)
```
    Найдите или создайте регистратор для именованной подсистемы. Если регистратор был уже создан с именем, это возвращается. Иначе новый регистратор создается.
    Если новый регистратор будет создаваться, то его уровень журнала будет сконфигурирован основанный на конфигурации LogManager, и это будет сконфигурированный, чтобы также отправить вывод журналирования Обработчикам его родителя. Это будет зарегистрировано в глобальном пространстве имен LogManager.
    Отметьте: LogManager может только сохранить слабую ссылку на недавно создаваемый Регистратор. Важно понять, что ранее создаваемый Регистратор с именем может быть собран "мусор" в любое время, если нет никакой сильной ссылки на Регистратор. В частности это означает что два компенсационных вызова как getLogger("MyLogger").log(...) может использовать различные объекты Регистратора по имени "MyLogger", если нет никакой сильной ссылки на Регистратор по имени "MyLogger" в другом месте в программе.
    
    Параметры:
    name - Имя для регистратора. Это должно быть разделенным от точки именем и должно обычно быть основано на имени пакета или имени класса подсистемы, такой как java.net или javax.swing
    
    Возвраты:
    подходящий Регистратор
    
    Броски:
    
    NullPointerException - если имя является нулем.
  - getLogger
```
public static Logger getLogger(String name,
               String resourceBundleName)
```
    Найдите или создайте регистратор для именованной подсистемы. Если регистратор был уже создан с именем, это возвращается. Иначе новый регистратор создается.
    Если новый регистратор будет создаваться, то его уровень журнала будет сконфигурирован основанный на LogManager, и это будет сконфигурированный, чтобы также отправить вывод журналирования Обработчикам его родителя. Это будет зарегистрировано в глобальном пространстве имен LogManager.
    Отметьте: LogManager может только сохранить слабую ссылку на недавно создаваемый Регистратор. Важно понять, что ранее создаваемый Регистратор с именем может быть собран "мусор" в любое время, если нет никакой сильной ссылки на Регистратор. В частности это означает что два компенсационных вызова как getLogger("MyLogger", ...).log(...) может использовать различные объекты Регистратора по имени "MyLogger", если нет никакой сильной ссылки на Регистратор по имени "MyLogger" в другом месте в программе.
    Если именованный Регистратор уже существует и еще не имеет пакета ресурса локализации тогда, данное имя пакета ресурса используется. Если именованный Регистратор уже существует и имеет различное имя пакета ресурса тогда, IllegalArgumentException бросается.
    
    Параметры:
    name - Имя для регистратора. Это должно быть разделенным от точки именем и должно обычно быть основано на имени пакета или имени класса подсистемы, такой как java.net или javax.swing
    resourceBundleName - имя ResourceBundle, который будет использоваться для того, чтобы локализовать сообщения для этого регистратора. Может быть null если ни одно из сообщений не требует локализации.
    
    Возвраты:
    подходящий Регистратор
    
    Броски:
    
    MissingResourceException - если resourceBundleName является ненулем, и никакой соответствующий ресурс не может быть найден.
    
    IllegalArgumentException - если Регистратор уже существует и использует различное имя пакета ресурса.
    
    NullPointerException - если имя является нулем.
  - getAnonymousLogger
```
public static Logger getAnonymousLogger()
```
    Создайте анонимный Регистратор. Недавно создаваемый Регистратор не регистрируется в пространстве имен LogManager. Не будет никаких проверок прав доступа на обновлениях к регистратору.
    Этот метод фабрики прежде всего предназначается для использования от апплетов. Поскольку получающийся Регистратор является анонимным, это может быть сохранено частным классом создания. Это устраняет потребность для нормальных проверок безопасности, которая поочередно позволяет недоверяемому коду апплета обновлять состояние управления Регистратора. Например апплет может сделать setLevel или addHandler на анонимном Регистраторе.
    Даже если новый регистратор является анонимным, он конфигурируется, чтобы иметь корневой регистратор ("") как его родитель. Это означает, что по умолчанию наследовало свой эффективный уровень и обработчики от корневого регистратора.
    
    Возвраты:
    недавно создаваемый частный Регистратор
  - getAnonymousLogger
```
public static Logger getAnonymousLogger(String resourceBundleName)
```
    Создайте анонимный Регистратор. Недавно создаваемый Регистратор не регистрируется в пространстве имен LogManager. Не будет никаких проверок прав доступа на обновлениях к регистратору.
    Этот метод фабрики прежде всего предназначается для использования от апплетов. Поскольку получающийся Регистратор является анонимным, это может быть сохранено частным классом создания. Это устраняет потребность для нормальных проверок безопасности, которая поочередно позволяет недоверяемому коду апплета обновлять состояние управления Регистратора. Например апплет может сделать setLevel или addHandler на анонимном Регистраторе.
    Даже если новый регистратор является анонимным, он конфигурируется, чтобы иметь корневой регистратор ("") как его родитель. Это означает, что по умолчанию наследовало свой эффективный уровень и обработчики от корневого регистратора.
    
    Параметры:
    resourceBundleName - имя ResourceBundle, который будет использоваться для того, чтобы локализовать сообщения для этого регистратора. Может быть нуль, если ни одно из сообщений не требует локализации.
    
    Возвраты:
    недавно создаваемый частный Регистратор
    
    Броски:
    
    MissingResourceException - если resourceBundleName является ненулем, и никакой соответствующий ресурс не может быть найден.
  - getResourceBundle
```
public ResourceBundle getResourceBundle()
```
    Получите пакет ресурса локализации для этого регистратора для текущей локали по умолчанию. Отметьте что, если результатом будет нуль, то Регистратор будет использовать пакет ресурса, наследованный от его родителя.
    
    Возвраты:
    пакет локализации (может быть нуль),
  - getResourceBundleName
```
public String getResourceBundleName()
```
    Получите имя пакета ресурса локализации для этого регистратора. Отметьте что, если результатом будет нуль, то Регистратор будет использовать имя пакета ресурса, наследованное от его родителя.
    
    Возвраты:
    имя пакета локализации (может быть нуль),
  - setFilter
```
public void setFilter(Filter newFilter)
               throws SecurityException
```
    Установите фильтр, чтобы управлять выводом на этом Регистраторе.
    После передачи начальной проверки "уровня" Регистратор вызовет этот Фильтр, чтобы проверить, должна ли запись журнала действительно быть опубликована.
    
    Параметры:
    newFilter - объект фильтра (может быть нуль),
    
    Броски:
    
    SecurityException - если менеджер безопасности существует и если вызывающая сторона не имеет контроля LoggingPermission.
  - getFilter
```
public Filter getFilter()
```
    Получите текущий фильтр для этого Регистратора.
    
    Возвраты:
    объект фильтра (может быть нуль),
  - журнал
```
public void log(LogRecord record)
```
    Зарегистрируйте LogRecord.
    Все другие методы журналирования в этом классе вызывают через этот метод, чтобы фактически выполнить любое журналирование. Подклассы могут переопределить этот единственный метод, чтобы получить все действие журнала.
    
    Параметры:
    record - LogRecord, который будет опубликован
  - журнал
```
public void log(Level level,
       String msg)
```
    Зарегистрируйте сообщение без параметров.
    Если регистратор в настоящий момент включается для данного уровня сообщения тогда, данное сообщение передается ко всем зарегистрированным выходным Объектам-обработчикам.
    
    Параметры:
    level - Один из идентификаторов уровня сообщения, например, СЕРЬЕЗНЫЙ
    msg - Строковое сообщение (или ключ в каталоге сообщений)
  - журнал
```
public void log(Level level,
       String msg,
       Object param1)
```
    Зарегистрируйте сообщение с одним объектным параметром.
    Если регистратор в настоящий момент включается для данного уровня сообщения тогда, соответствующий LogRecord создается и передается всем зарегистрированным выходным Объектам-обработчикам.
    
    Параметры:
    level - Один из идентификаторов уровня сообщения, например, СЕРЬЕЗНЫЙ
    msg - Строковое сообщение (или ключ в каталоге сообщений)
    param1 - параметр к сообщению
  - журнал
```
public void log(Level level,
       String msg,
       Object[] params)
```
    Зарегистрируйте сообщение с массивом объектных параметров.
    Если регистратор в настоящий момент включается для данного уровня сообщения тогда, соответствующий LogRecord создается и передается всем зарегистрированным выходным Объектам-обработчикам.
    
    Параметры:
    level - Один из идентификаторов уровня сообщения, например, СЕРЬЕЗНЫЙ
    msg - Строковое сообщение (или ключ в каталоге сообщений)
    params - массив параметров к сообщению
  - журнал
```
public void log(Level level,
       String msg,
       Throwable thrown)
```
    Зарегистрируйте сообщение со связанной информацией о Throwable.
    Если регистратор в настоящий момент включается для данного уровня сообщения тогда, данные параметры сохранены в LogRecord, который передается всем зарегистрированным выходным обработчикам.
    Отметьте, что брошенный параметр сохранен в LogRecord брошенное свойство, а не свойство параметров LogRecord. Таким образом обработанное особенно выходными Средствами форматирования и не обрабатывается как параметр форматирования к свойству сообщения LogRecord.
    
    Параметры:
    level - Один из идентификаторов уровня сообщения, например, СЕРЬЕЗНЫЙ
    msg - Строковое сообщение (или ключ в каталоге сообщений)
    thrown - Throwable связался с сообщением журнала.
  - logp
```
public void logp(Level level,
        String sourceClass,
        String sourceMethod,
        String msg)
```
    Зарегистрируйте сообщение, определяя исходный класс и метод, без параметров.
    Если регистратор в настоящий момент включается для данного уровня сообщения тогда, данное сообщение передается ко всем зарегистрированным выходным Объектам-обработчикам.
    
    Параметры:
    level - Один из идентификаторов уровня сообщения, например, СЕРЬЕЗНЫЙ
    sourceClass - имя класса, который выпустил запрос журналирования
    sourceMethod - имя метода, который выпустил запрос журналирования
    msg - Строковое сообщение (или ключ в каталоге сообщений)
  - logp
```
public void logp(Level level,
        String sourceClass,
        String sourceMethod,
        String msg,
        Object param1)
```
    Зарегистрируйте сообщение, определяя исходный класс и метод, с единственным объектным параметром к сообщению журнала.
    Если регистратор в настоящий момент включается для данного уровня сообщения тогда, соответствующий LogRecord создается и передается всем зарегистрированным выходным Объектам-обработчикам.
    
    Параметры:
    level - Один из идентификаторов уровня сообщения, например, СЕРЬЕЗНЫЙ
    sourceClass - имя класса, который выпустил запрос журналирования
    sourceMethod - имя метода, который выпустил запрос журналирования
    msg - Строковое сообщение (или ключ в каталоге сообщений)
    param1 - Параметр к сообщению журнала.
  - logp
```
public void logp(Level level,
        String sourceClass,
        String sourceMethod,
        String msg,
        Object[] params)
```
    Зарегистрируйте сообщение, определяя исходный класс и метод, с массивом объектных параметров.
    Если регистратор в настоящий момент включается для данного уровня сообщения тогда, соответствующий LogRecord создается и передается всем зарегистрированным выходным Объектам-обработчикам.
    
    Параметры:
    level - Один из идентификаторов уровня сообщения, например, СЕРЬЕЗНЫЙ
    sourceClass - имя класса, который выпустил запрос журналирования
    sourceMethod - имя метода, который выпустил запрос журналирования
    msg - Строковое сообщение (или ключ в каталоге сообщений)
    params - Массив параметров к сообщению
  - logp
```
public void logp(Level level,
        String sourceClass,
        String sourceMethod,
        String msg,
        Throwable thrown)
```
    Зарегистрируйте сообщение, определяя исходный класс и метод, со связанной информацией о Throwable.
    Если регистратор в настоящий момент включается для данного уровня сообщения тогда, данные параметры сохранены в LogRecord, который передается всем зарегистрированным выходным обработчикам.
    Отметьте, что брошенный параметр сохранен в LogRecord брошенное свойство, а не свойство параметров LogRecord. Таким образом обработанное особенно выходными Средствами форматирования и не обрабатывается как параметр форматирования к свойству сообщения LogRecord.
    
    Параметры:
    level - Один из идентификаторов уровня сообщения, например, СЕРЬЕЗНЫЙ
    sourceClass - имя класса, который выпустил запрос журналирования
    sourceMethod - имя метода, который выпустил запрос журналирования
    msg - Строковое сообщение (или ключ в каталоге сообщений)
    thrown - Throwable связался с сообщением журнала.
  - logrb
```
public void logrb(Level level,
         String sourceClass,
         String sourceMethod,
         String bundleName,
         String msg)
```
    Зарегистрируйте сообщение, определяя исходный класс, метод, и имя пакета ресурса без параметров.
    Если регистратор в настоящий момент включается для данного уровня сообщения тогда, данное сообщение передается ко всем зарегистрированным выходным Объектам-обработчикам.
    Строка сообщения локализуется, используя именованный пакет ресурса. Если имя пакета ресурса является нулем, или пустой Строкой или недопустимый тогда, строка сообщения не локализуется.
    
    Параметры:
    level - Один из идентификаторов уровня сообщения, например, СЕРЬЕЗНЫЙ
    sourceClass - имя класса, который выпустил запрос журналирования
    sourceMethod - имя метода, который выпустил запрос журналирования
    bundleName - имя пакета ресурса, чтобы локализовать сообщение, может быть нуль
    msg - Строковое сообщение (или ключ в каталоге сообщений)
  - logrb
```
public void logrb(Level level,
         String sourceClass,
         String sourceMethod,
         String bundleName,
         String msg,
         Object param1)
```
    Зарегистрируйте сообщение, определяя исходный класс, метод, и имя пакета ресурса, с единственным объектным параметром к сообщению журнала.
    Если регистратор в настоящий момент включается для данного уровня сообщения тогда, соответствующий LogRecord создается и передается всем зарегистрированным выходным Объектам-обработчикам.
    Строка сообщения локализуется, используя именованный пакет ресурса. Если имя пакета ресурса является нулем, или пустой Строкой или недопустимый тогда, строка сообщения не локализуется.
    
    Параметры:
    level - Один из идентификаторов уровня сообщения, например, СЕРЬЕЗНЫЙ
    sourceClass - имя класса, который выпустил запрос журналирования
    sourceMethod - имя метода, который выпустил запрос журналирования
    bundleName - имя пакета ресурса, чтобы локализовать сообщение, может быть нуль
    msg - Строковое сообщение (или ключ в каталоге сообщений)
    param1 - Параметр к сообщению журнала.
  - logrb
```
public void logrb(Level level,
         String sourceClass,
         String sourceMethod,
         String bundleName,
         String msg,
         Object[] params)
```
    Зарегистрируйте сообщение, определяя исходный класс, метод, и имя пакета ресурса, с массивом объектных параметров.
    Если регистратор в настоящий момент включается для данного уровня сообщения тогда, соответствующий LogRecord создается и передается всем зарегистрированным выходным Объектам-обработчикам.
    Строка сообщения локализуется, используя именованный пакет ресурса. Если имя пакета ресурса является нулем, или пустой Строкой или недопустимый тогда, строка сообщения не локализуется.
    
    Параметры:
    level - Один из идентификаторов уровня сообщения, например, СЕРЬЕЗНЫЙ
    sourceClass - имя класса, который выпустил запрос журналирования
    sourceMethod - имя метода, который выпустил запрос журналирования
    bundleName - имя пакета ресурса, чтобы локализовать сообщение, может быть нуль.
    msg - Строковое сообщение (или ключ в каталоге сообщений)
    params - Массив параметров к сообщению
  - logrb
```
public void logrb(Level level,
         String sourceClass,
         String sourceMethod,
         String bundleName,
         String msg,
         Throwable thrown)
```
    Зарегистрируйте сообщение, определяя исходный класс, метод, и имя пакета ресурса, со связанной информацией о Throwable.
    Если регистратор в настоящий момент включается для данного уровня сообщения тогда, данные параметры сохранены в LogRecord, который передается всем зарегистрированным выходным обработчикам.
    Строка сообщения локализуется, используя именованный пакет ресурса. Если имя пакета ресурса является нулем, или пустой Строкой или недопустимый тогда, строка сообщения не локализуется.
    Отметьте, что брошенный параметр сохранен в LogRecord брошенное свойство, а не свойство параметров LogRecord. Таким образом обработанное особенно выходными Средствами форматирования и не обрабатывается как параметр форматирования к свойству сообщения LogRecord.
    
    Параметры:
    level - Один из идентификаторов уровня сообщения, например, СЕРЬЕЗНЫЙ
    sourceClass - имя класса, который выпустил запрос журналирования
    sourceMethod - имя метода, который выпустил запрос журналирования
    bundleName - имя пакета ресурса, чтобы локализовать сообщение, может быть нуль
    msg - Строковое сообщение (или ключ в каталоге сообщений)
    thrown - Throwable связался с сообщением журнала.
  - ввод
```
public void entering(String sourceClass,
            String sourceMethod)
```
    Зарегистрируйте запись метода.
    Это - метод удобства, который может использоваться, чтобы зарегистрировать запись в метод. LogRecord с сообщением "ЗАПИСЬ", БОЛЕЕ ПРЕКРАСНЫЙ уровень журнала, и данный sourceMethod и sourceClass регистрируется.
    
    Параметры:
    sourceClass - имя класса, который выпустил запрос журналирования
    sourceMethod - имя метода, который вводится
  - ввод
```
public void entering(String sourceClass,
            String sourceMethod,
            Object param1)
```
    Зарегистрируйте запись метода с одним параметром.
    Это - метод удобства, который может использоваться, чтобы зарегистрировать запись в метод. LogRecord с сообщением "ЗАПИСЬ {0}", БОЛЕЕ ПРЕКРАСНЫЙ уровень журнала, и данный sourceMethod, sourceClass, и параметр регистрируется.
    
    Параметры:
    sourceClass - имя класса, который выпустил запрос журналирования
    sourceMethod - имя метода, который вводится
    param1 - параметр к вводимому методу
  - ввод
```
public void entering(String sourceClass,
            String sourceMethod,
            Object[] params)
```
    Зарегистрируйте запись метода с массивом параметров.
    Это - метод удобства, который может использоваться, чтобы зарегистрировать запись в метод. Регистрируется LogRecord с сообщением "ЗАПИСЬ" (сопровождаемый индикатором формата {N} для каждой записи в массиве параметра), БОЛЕЕ ПРЕКРАСНЫЙ уровень журнала, и данный sourceMethod, sourceClass, и параметры.
    
    Параметры:
    sourceClass - имя класса, который выпустил запрос журналирования
    sourceMethod - имя метода, который вводится
    params - массив параметров к вводимому методу
  - выход
```
public void exiting(String sourceClass,
           String sourceMethod)
```
    Зарегистрируйте возврат метода.
    Это - метод удобства, который может использоваться, чтобы зарегистрировать возврат из метода. LogRecord с сообщением "ВОЗВРАТ", БОЛЕЕ ПРЕКРАСНЫЙ уровень журнала, и данный sourceMethod и sourceClass регистрируется.
    
    Параметры:
    sourceClass - имя класса, который выпустил запрос журналирования
    sourceMethod - имя метода
  - выход
```
public void exiting(String sourceClass,
           String sourceMethod,
           Object result)
```
    Зарегистрируйте возврат метода с объектом результата.
    Это - метод удобства, который может использоваться, чтобы зарегистрировать возврат из метода. LogRecord с сообщением "ВОЗВРАТ {0}", БОЛЕЕ ПРЕКРАСНЫЙ уровень журнала, и давание sourceMethod, sourceClass, и объект результата регистрируется.
    
    Параметры:
    sourceClass - имя класса, который выпустил запрос журналирования
    sourceMethod - имя метода
    result - Объект, который возвращается
  - бросок
```
public void throwing(String sourceClass,
            String sourceMethod,
            Throwable thrown)
```
    Журнал, выдающий исключение.
    Это - метод удобства, чтобы зарегистрировать это, метод завершается, выдавая исключение. Журналирование делается, используя БОЛЕЕ ПРЕКРАСНЫЙ уровень.
    Если регистратор в настоящий момент включается для данного уровня сообщения тогда, данные параметры сохранены в LogRecord, который передается всем зарегистрированным выходным обработчикам. Сообщение LogRecord устанавливается "БРОСИТЬ".
    Отметьте, что брошенный параметр сохранен в LogRecord брошенное свойство, а не свойство параметров LogRecord. Таким образом обработанное особенно выходными Средствами форматирования и не обрабатывается как параметр форматирования к свойству сообщения LogRecord.
    
    Параметры:
    sourceClass - имя класса, который выпустил запрос журналирования
    sourceMethod - имя метода.
    thrown - Throwable, который бросается.
  - серьезный
```
public void severe(String msg)
```
    Зарегистрируйте СЕРЬЕЗНОЕ сообщение.
    Если регистратор в настоящий момент включается для СЕРЬЕЗНОГО уровня сообщения тогда, данное сообщение передается ко всем зарегистрированным выходным Объектам-обработчикам.
    
    Параметры:
    msg - Строковое сообщение (или ключ в каталоге сообщений)
  - предупреждение
```
public void warning(String msg)
```
    Зарегистрируйте Предупреждающее сообщение.
    Если регистратор в настоящий момент включается для уровня Предупреждающего сообщения тогда, данное сообщение передается ко всем зарегистрированным выходным Объектам-обработчикам.
    
    Параметры:
    msg - Строковое сообщение (или ключ в каталоге сообщений)
  - информация
```
public void info(String msg)
```
    Зарегистрируйте сообщение ИНФОРМАЦИИ.
    Если регистратор в настоящий момент включается для уровня сообщения ИНФОРМАЦИИ тогда, данное сообщение передается ко всем зарегистрированным выходным Объектам-обработчикам.
    
    Параметры:
    msg - Строковое сообщение (или ключ в каталоге сообщений)
  - конфигурация
```
public void config(String msg)
```
    Зарегистрируйте сообщение КОНФИГУРАЦИИ.
    Если регистратор в настоящий момент включается для уровня сообщения КОНФИГУРАЦИИ тогда, данное сообщение передается ко всем зарегистрированным выходным Объектам-обработчикам.
    
    Параметры:
    msg - Строковое сообщение (или ключ в каталоге сообщений)
  - прекрасный
```
public void fine(String msg)
```
    Зарегистрируйте ПРЕКРАСНОЕ сообщение.
    Если регистратор в настоящий момент включается для ПРЕКРАСНОГО уровня сообщения тогда, данное сообщение передается ко всем зарегистрированным выходным Объектам-обработчикам.
    
    Параметры:
    msg - Строковое сообщение (или ключ в каталоге сообщений)
  - более прекрасный
```
public void finer(String msg)
```
    Зарегистрируйте БОЛЕЕ ПРЕКРАСНОЕ сообщение.
    Если регистратор в настоящий момент включается для БОЛЕЕ ПРЕКРАСНОГО уровня сообщения тогда, данное сообщение передается ко всем зарегистрированным выходным Объектам-обработчикам.
    
    Параметры:
    msg - Строковое сообщение (или ключ в каталоге сообщений)
  - самый прекрасный
```
public void finest(String msg)
```
    Зарегистрируйте САМОЕ ПРЕКРАСНОЕ сообщение.
    Если регистратор в настоящий момент включается для САМОГО ПРЕКРАСНОГО уровня сообщения тогда, данное сообщение передается ко всем зарегистрированным выходным Объектам-обработчикам.
    
    Параметры:
    msg - Строковое сообщение (или ключ в каталоге сообщений)
  - setLevel
```
public void setLevel(Level newLevel)
              throws SecurityException
```
    Установите уровень журнала, определяющий, какие уровни сообщения будут зарегистрированы этим регистратором. Уровни сообщения ниже чем это значение будут отброшены. Уровень значения уровня. ПРОЧЬ может использоваться, чтобы выключить журналирование.
    Если новый уровень является нулем, это означает, что этот узел должен наследовать свой уровень от его самого близкого предка с определенным (ненулевым) значением уровня.
    
    Параметры:
    newLevel - новое значение для уровня журнала (может быть нуль),
    
    Броски:
    
    SecurityException - если менеджер безопасности существует и если вызывающая сторона не имеет контроля LoggingPermission.
  - getLevel
```
public Level getLevel()
```
    Получите Уровень журнала, который был определен для этого Регистратора. Результатом может быть нуль, что означает, что эффективный уровень этого регистратора будет наследован от его родителя.
    
    Возвраты:
    уровень этого Регистратора
  - isLoggable
```
public boolean isLoggable(Level level)
```
    Проверьте, было ли сообщение данного уровня бы фактически зарегистрировано этим регистратором. Эта проверка основана на Регистраторах эффективный уровень, который может быть наследован от его родителя.
    
    Параметры:
    level - сообщение, регистрирующее уровень
    
    Возвраты:
    истина, если данный уровень сообщения в настоящий момент регистрируется.
  - getName
```
public String getName()
```
    Завоюйте репутацию для этого регистратора.
    
    Возвраты:
    имя регистратора. Будет нуль для анонимных Регистраторов.
  - addHandler
```
public void addHandler(Handler handler)
                throws SecurityException
```
    Добавьте Обработчик журнала, чтобы получить сообщения журналирования.
    По умолчанию Регистраторы также отправляют свой вывод их родительскому регистратору. Обычно корневой Регистратор конфигурируется с рядом Обработчиков, которые по существу действуют как обработчики по умолчанию для всех регистраторов.
    
    Параметры:
    handler - Обработчик журналирования
    
    Броски:
    
    SecurityException - если менеджер безопасности существует и если вызывающая сторона не имеет контроля LoggingPermission.
  - removeHandler
```
public void removeHandler(Handler handler)
                   throws SecurityException
```
    Удалите Обработчик журнала.
    Возвраты тихо, если данный Обработчик не находится или является нулем
    
    Параметры:
    handler - Обработчик журналирования
    
    Броски:
    
    SecurityException - если менеджер безопасности существует и если вызывающая сторона не имеет контроля LoggingPermission.
  - getHandlers
```
public Handler[] getHandlers()
```
    Свяжите Обработчики с этим регистратором.
    
    Возвраты:
    массив всех зарегистрированных Обработчиков
  - setUseParentHandlers
```
public void setUseParentHandlers(boolean useParentHandlers)
```
    Определите, должен ли этот регистратор отправить свой вывод его родительскому Регистратору. Это означает, что любой LogRecords будет также записан Обработчикам родителя, и потенциально его родителю, рекурсивно пространство имен.
    
    Параметры:
    useParentHandlers - истина, если вывод должен быть отправлен родителю регистратора.
    
    Броски:
    
    SecurityException - если менеджер безопасности существует и если вызывающая сторона не имеет контроля LoggingPermission.
  - getUseParentHandlers
```
public boolean getUseParentHandlers()
```
    Обнаружьте, отправляет ли этот регистратор свой вывод его родительскому регистратору.
    
    Возвраты:
    истина, если вывод должен быть отправлен родителю регистратора
  - getParent
```
public Logger getParent()
```
    Возвратите родителя для этого Регистратора.
    Этот метод возвращает самого близкого существующего родителя в пространстве имен. Таким образом, если Регистратор вызовут "a.b.c.d", и Регистратор, названный "a.b", был создан, но никакой регистратор "a.b.c" существует, то вызов getParent на Регистраторе "a.b.c.d" возвратит Регистратор "a.b".
    Результатом будет нуль, если это вызовут на корневом Регистраторе в пространстве имен.
    
    Возвраты:
    самый близкий существующий родительский Регистратор
  - setParent
```
public void setParent(Logger parent)
```
    Установите родителя для этого Регистратора. Этот метод используется LogManager, чтобы обновить Регистратор, когда пространство имен изменяется.
    Это нельзя вызвать от кода программы.
    
    Параметры:
    parent - новый родительский регистратор
    
    Броски:
    
    SecurityException - если менеджер безопасности существует и если вызывающая сторона не имеет контроля LoggingPermission.

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

Регистратор класса

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

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

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

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

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

GLOBAL_LOGGER_NAME

глобальная переменная

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

Регистратор

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

getGlobal

getLogger

getLogger

getAnonymousLogger

getAnonymousLogger

getResourceBundle

getResourceBundleName

setFilter

getFilter

журнал

журнал

журнал

журнал

журнал

logp

logp

logp

logp

logrb

logrb

logrb

logrb

ввод

ввод

ввод

выход

выход

бросок

серьезный

предупреждение

информация

конфигурация

прекрасный

более прекрасный

самый прекрасный

setLevel

getLevel

isLoggable

getName

addHandler

removeHandler

getHandlers

setUseParentHandlers

getUseParentHandlers

getParent

setParent