LogManager (Платформа Java SE 7)

java.lang. Объект
- java.util.logging. LogManager

```
public class LogManager
extends Object
```
Есть единственный глобальный объект LogManager, который используется, чтобы поддержать ряд общего состояния о службах журнала и Регистраторах.
Этот объект LogManager:
- Управляет иерархическим пространством имен объектов Регистратора. Все именованные Регистраторы сохранены в этом пространстве имен.
- Управляет рядом свойств элементов управления журналирования. Они - простые пары ключ/значение, которые могут использоваться Обработчиками, и другое журналирование возражает, чтобы сконфигурировать себя.
Глобальный объект LogManager может быть получен, используя LogManager.getLogManager (). Объект LogManager создается во время инициализации класса и не может впоследствии быть изменен.
При запуске класс LogManager располагается, используя java.util.logging.manager системное свойство.
По умолчанию LogManager читает свою начальную конфигурацию из файла свойств "lib/logging.properties" в каталоге JRE. Если Вы редактируете тот файл свойств, можно изменить конфигурацию журналирования значения по умолчанию для всего использования этого JRE.
Кроме того, LogManager использует два дополнительных системных свойства, которые позволяют больше управления чтением начальной конфигурации:
- "java.util.logging.config.class"
- "java.util.logging.config.file"
Эти два свойства могут быть установлены через Привилегированный API, или как определения свойства командной строки команде "java", или как системные определения свойства, которые передают к JNI_CreateJavaVM.
Если "java.util.logging.config.class" свойство устанавливается, то значение свойства обрабатывается как имя класса. Данный класс будет загружен, объект инстанцируют, и что конструктор объекта ответственен за чтение в начальной конфигурации. (Что объект может использовать другие системные свойства, чтобы управлять ее конфигурацией.) Альтернативный класс конфигурации может использовать readConfiguration(InputStream), чтобы определить свойства в LogManager.
Если "java.util.logging.config.class" свойство не устанавливается, то "java.util.logging.config.file" системное свойство может использоваться, чтобы определить файл свойств (в java.util. Формат свойств). Начальная конфигурация журналирования будет считана из этого файла.
Если ни одно из этих свойств не будет определено тогда, как описано выше, то LogManager считает свою начальную конфигурацию из файла свойств "lib/logging.properties" в каталоге JRE.
У свойств для регистраторов и Обработчиков будут имена, запускающиеся с разделенного от точки имени для обработчика или регистратора.
Глобальные свойства журналирования могут включать:
- Свойство "обработчики". Это определяет пробел или список разделенных запятой значений имен классов для классов обработчика загрузки и регистра как обработчики на корневом Регистраторе (Регистратор, названный""). Каждое имя класса должно быть для класса Обработчика, у которого есть конструктор по умолчанию. Отметьте, что эти Обработчики могут быть созданы лениво, когда они сначала используются.
- Свойство" <регистратор>.handlers". Это определяет пробел или список разделенных запятой значений имен классов для классов обработчиков загрузки и регистра как обработчики к указанному регистратору. Каждое имя класса должно быть для класса Обработчика, у которого есть конструктор по умолчанию. Отметьте, что эти Обработчики могут быть созданы лениво, когда они сначала используются.
- Свойство" <регистратор>.useParentHandlers". Это определяет булево значение. По умолчанию каждый регистратор вызывает своего родителя в дополнение к обработке сообщения журналирования непосредственно, это часто приводит к сообщениям, обрабатываемым полностью регистратор также. Устанавливая это свойство в ложь Обработчик должен быть сконфигурирован для этого регистратора иначе, никакие сообщения журналирования не передаются.
- Свойство "конфигурация". Это свойство предназначается, чтобы позволить произвольному коду конфигурации быть выполненным. Свойство определяет пробел или список разделенных запятой значений имен классов. Новый экземпляр будет создаваться для каждого именованного класса. Конструктор по умолчанию каждого класса может выполнить произвольный код, чтобы обновить конфигурацию журналирования, такую как установка уровней регистратора, добавление обработчиков, добавление фильтров, и т.д.
Отметьте, что все классы, загруженные во время конфигурации LogManager, сначала ищутся на системном пути к классу перед любым пользовательским путем к классу. Это включает класс LogManager, любые классы конфигурации, и любые классы обработчика.
Регистраторы организуются в иерархию именования, основанную на их точке разделенные имена. Таким образом "a.b.c" является дочерним элементом "a.b", но "b1" и b2" коллеги.
Все свойства, конец имен которых с ".level", как предполагается, определяет уровни журнала для Регистраторов. Таким образом "foo.level" определяет уровень журнала для регистратора, названного "foo" и (рекурсивно) для любого из его дочерних элементов в иерархии именования. Уровни журнала применяются в порядке, они определяются в файле свойств. Таким образом настройки уровня для дочерних узлов в дереве должны прибыть после настроек для их родителей. Имя свойства ".level" может использоваться, чтобы установить уровень для корня дерева.
Все методы на объекте LogManager мультиориентированы на многопотоковое исполнение.
С тех пор:

1.4

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

Поля
Модификатор и Тип	Поле и Описание
`static String`	`LOGGING_MXBEAN_NAME` Строковое представление `ObjectName` для интерфейса управления для средства журналирования.

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

Конструкторы
Модификатор Конструктор и Описание

protected LogManager()
Защищенный конструктор.

Конструкторы
Модификатор	Конструктор и Описание
`protected`	`LogManager()` Защищенный конструктор.

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

Методы
Модификатор и Тип	Метод и Описание
`boolean`	`addLogger(Logger logger)` Добавьте именованный регистратор.
`void`	`addPropertyChangeListener(PropertyChangeListener l)` Добавляет слушатель события, чтобы быть вызванным, когда свойства журналирования перечитываются.
`void`	`checkAccess()` Проверьте, что текущему контексту доверяют, чтобы изменить конфигурацию журналирования.
`Регистратор`	`getLogger(String name)` Метод, чтобы найти именованный регистратор.
`Enumeration<String>`	`getLoggerNames()` Получите перечисление известных имен регистратора.
`static LoggingMXBean`	`getLoggingMXBean()` Возвраты `LoggingMXBean` для того, чтобы управлять регистраторами.
`static LogManager`	`getLogManager()` Возвратите глобальный объект LogManager.
`Строка`	`getProperty(String name)` Получите значение свойства журналирования.
`void`	`readConfiguration()` Повторно инициализируйте свойства журналирования и перечитайте конфигурацию журналирования.
`void`	`readConfiguration(InputStream ins)` Повторно инициализируйте свойства журналирования и перечитайте конфигурацию журналирования от данного потока, который должен быть в java.util. Формат свойств.
`void`	`removePropertyChangeListener(PropertyChangeListener l)` Удаляет слушателя события для событий изменения свойства.
`void`	`reset()` Сбросьте конфигурацию журналирования.

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

- Полевая Деталь
  - LOGGING_MXBEAN_NAME
```
public static final String LOGGING_MXBEAN_NAME
```
    Строковое представление ObjectName для интерфейса управления для средства журналирования.
    
    С тех пор:
    
    1.5
    
    См. Также:
    PlatformLoggingMXBean, LoggingMXBean, Постоянные Значения полей
- Деталь конструктора
  - LogManager
```
protected LogManager()
```
    Защищенный конструктор. Это защищается так, чтобы приложения-контейнеры (такие как контейнеры J2EE) могли разделить объект на подклассы. Это непублично, как это предназначается, что там только быть одним объектом LogManager, значение которого получается, вызывая Logmanager.getLogManager.
- Деталь метода
  - getLogManager
```
public static LogManager getLogManager()
```
    Возвратите глобальный объект LogManager.
  - addPropertyChangeListener
```
public void addPropertyChangeListener(PropertyChangeListener l)
                               throws SecurityException
```
    Добавляет слушатель события, чтобы быть вызванным, когда свойства журналирования перечитываются. Добавление многократных экземпляров того же самого события Listener приводит к многократным записям в таблице слушателя события свойства.
    
    Параметры:
    l - слушатель события
    
    Броски:
    
    SecurityException - если менеджер безопасности существует и если вызывающая сторона не имеет контроля LoggingPermission.
    
    NullPointerException - если PropertyChangeListener является нулем.
  - removePropertyChangeListener
```
public void removePropertyChangeListener(PropertyChangeListener l)
                                  throws SecurityException
```
    Удаляет слушателя события для событий изменения свойства. Если тот же самый экземпляр слушателя был добавлен к таблице слушателя через многократные вызовы addPropertyChangeListener, тогда эквивалентное число removePropertyChangeListener вызовы обязаны удалять все экземпляры того слушателя от таблицы слушателя.
    Возвраты тихо, если данный слушатель не находится.
    
    Параметры:
    l - слушатель события (может быть нуль),
    
    Броски:
    
    SecurityException - если менеджер безопасности существует и если вызывающая сторона не имеет контроля LoggingPermission.
  - addLogger
```
public boolean addLogger(Logger logger)
```
    Добавьте именованный регистратор. Это ничего не делает и возвращает false, если регистратор с тем же самым именем уже регистрируется.
    Методы фабрики Регистратора вызывают этот метод, чтобы зарегистрировать каждый недавно создаваемый Регистратор.
    Приложение должно сохранить свою собственную ссылку на объект Регистратора избежать этого собрал "мусор". LogManager может только сохранить слабую ссылку.
    
    Параметры:
    logger - новый регистратор.
    
    Возвраты:
    истина, если регистратор параметра был зарегистрирован успешно, ложь, если регистратор того имени уже существует.
    
    Броски:
    
    NullPointerException - если имя регистратора является нулем.
  - getLogger
```
public Logger getLogger(String name)
```
    Метод, чтобы найти именованный регистратор.
    Отметьте, что, так как недоверяемый код может создать регистраторы с произвольными именами, на этот метод нельзя положиться, чтобы счесть Регистраторы для безопасности чувствительным журналированием. Также важно отметить что Регистратор, связанный со Строкой name может быть собран "мусор" в любое время, если нет никакой сильной ссылки на Регистратор. Вызывающая сторона этого метода должна проверить возвращаемое значение на нуль, чтобы должным образом обработать случай, где Регистратор был собран "мусор".
    
    Параметры:
    name - имя регистратора
    
    Возвраты:
    соответствие регистратора или нуля, если ни один не находится
  - getLoggerNames
```
public Enumeration<String> getLoggerNames()
```
    Получите перечисление известных имен регистратора.
    Отметьте: Регистраторы могут быть добавлены динамически, поскольку новые классы загружаются. Этот метод только сообщает относительно регистраторов, которые в настоящий момент регистрируются. Также важно отметить, что этот метод только возвращает имя Регистратора, не сильную ссылку на Регистратор непосредственно. Возвращенная Строка не делает ничего, чтобы препятствовать тому, чтобы Регистратор был собран "мусор". В частности если к возвращенному имени передают LogManager.getLogger(), тогда вызывающая сторона должна проверить возвращаемое значение от LogManager.getLogger() для нуля, чтобы должным образом обработать случай, где Регистратор был собран "мусор" во время, так как его имя было возвращено этим методом.
    
    Возвраты:
    перечисление регистратора называет строки
  - readConfiguration
```
public void readConfiguration()
                       throws IOException,
                              SecurityException
```
    Повторно инициализируйте свойства журналирования и перечитайте конфигурацию журналирования.
    Те же самые правила используются для того, чтобы определить местоположение свойств конфигурации, как используются при запуске. Таким образом, обычно свойства журналирования будут перечитаны от того же самого файла, который использовался при запуске.
    Любые определения уровня журнала в новом конфигурационном файле будут применены, используя Logger.setLevel (), если целевой Регистратор будет существовать.
    PropertyChangeEvent будет уволен после того, как свойства читаются.
    
    Броски:
    
    SecurityException - если менеджер безопасности существует и если вызывающая сторона не имеет контроля LoggingPermission.
    
    IOException - если есть проблемы IO, читая конфигурацию.
  - сброс
```
public void reset()
           throws SecurityException
```
    Сбросьте конфигурацию журналирования.
    Для всех именованных регистраторов работа сброса удаляет и закрывает все Обработчики, и (за исключением корневого регистратора) устанавливает уровень в NULL. Уровень корневого регистратора устанавливается в Уровень. ИНФОРМАЦИЯ.
    
    Броски:
    
    SecurityException - если менеджер безопасности существует и если вызывающая сторона не имеет контроля LoggingPermission.
  - readConfiguration
```
public void readConfiguration(InputStream ins)
                       throws IOException,
                              SecurityException
```
    Повторно инициализируйте свойства журналирования и перечитайте конфигурацию журналирования от данного потока, который должен быть в java.util. Формат свойств. PropertyChangeEvent будет уволен после того, как свойства читаются.
    Любые определения уровня журнала в новом конфигурационном файле будут применены, используя Logger.setLevel (), если целевой Регистратор будет существовать.
    
    Параметры:
    ins - поток, чтобы считать свойства из
    
    Броски:
    
    SecurityException - если менеджер безопасности существует и если вызывающая сторона не имеет контроля LoggingPermission.
    
    IOException - если есть проблемы, читающие из потока.
  - getProperty
```
public String getProperty(String name)
```
    Получите значение свойства журналирования. Метод возвращает нуль, если свойство не находится.
    
    Параметры:
    name - имя свойства
    
    Возвраты:
    значение свойства
  - checkAccess
```
public void checkAccess()
                 throws SecurityException
```
    Проверьте, что текущему контексту доверяют, чтобы изменить конфигурацию журналирования. Это требует LoggingPermission ("управление").
    Если проверка перестала работать, мы бросаем SecurityException, иначе мы обычно возвращаемся.
    
    Броски:
    
    SecurityException - если менеджер безопасности существует и если вызывающая сторона не имеет контроля LoggingPermission.
  - getLoggingMXBean
```
public static LoggingMXBean getLoggingMXBean()
```
    Возвраты LoggingMXBean для того, чтобы управлять регистраторами. Альтернативный способ управлять регистраторами через PlatformLoggingMXBean интерфейс, который может быть получен, вызывая:
```
     PlatformLoggingMXBean logging = ManagementFactory.getPlatformMXBean(PlatformLoggingMXBean.class);
 
```
    Возвраты:
    a LoggingMXBean объект.
    С тех пор:
    
    1.5
    
    См. Также:
    PlatformLoggingMXBean

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

Класс LogManager

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

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

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

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

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

LOGGING_MXBEAN_NAME

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

LogManager

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

getLogManager

addPropertyChangeListener

removePropertyChangeListener

addLogger

getLogger

getLoggerNames

readConfiguration

сброс

readConfiguration

getProperty

checkAccess

getLoggingMXBean