compact1, compact2, compact3

java.util.logging

Класс LogManager

java.lang. Объект

java.util.logging. LogManager

public class LogManager
extends Object

Есть единственный глобальный объект LogManager, который используется, чтобы поддержать ряд общего состояния о службах журнала и Регистраторах.

Этот объект LogManager:

• Управляет иерархическим пространством имен объектов Регистратора. Все именованные Регистраторы сохранены в этом пространстве имен.
• Управляет рядом свойств элементов управления журналирования. Они - простые пары ключ/значение, которые могут использоваться Обработчиками, и другое журналирование возражает, чтобы сконфигурировать себя.

Глобальный объект LogManager может быть получен, используя LogManager.getLogManager (). Объект LogManager создается во время инициализации class и не может впоследствии быть изменен.

При запуске LogManager class располагается, используя java.util.logging.manager системное свойство.

LogManager определяет два дополнительных системных свойства, которые позволяют управление начальной конфигурацией:

• "java.util.logging.config. class"
• "java.util.logging.config.file"

Эти два свойства могут быть определены на командной строке к команде "java", или как системные определения свойства, которые передают к JNI_CreateJavaVM.

Если "java.util.logging.config. class" свойство устанавливается, тогда значение свойства обрабатывается как имя class. Данный class будет загружен, объект инстанцируют, и что конструктор объекта ответственен за чтение в начальной конфигурации. (Что объект может использовать другие системные свойства, чтобы управлять ее конфигурацией.) Альтернативная конфигурация class может использовать readConfiguration(InputStream), чтобы определить свойства в LogManager.

Если "java.util.logging.config. class" свойство не устанавливается, тогда "java.util.logging.config.file" системное свойство может использоваться, чтобы определить файл свойств (в java.util. Формат свойств). Начальная конфигурация журналирования будет считана из этого файла.

Если ни одно из этих свойств не определяется тогда, LogManager использует свою конфигурацию значения по умолчанию. Конфигурация значения по умолчанию обычно загружается из файла свойств"lib/logging.properties"в каталоге установки Java.

У свойств для регистраторов и Обработчиков будут имена, запускающиеся с разделенного от точки имени для обработчика или регистратора.

Глобальные свойства журналирования могут включать:

• Свойство "обработчики". Это определяет пробел или список разделенных запятой значений имен class для классов обработчика загрузки и регистра как обработчики на корневом Регистраторе (Регистратор, названный""). Каждым именем class должен быть для Обработчика class, у которого есть конструктор по умолчанию. Отметьте, что эти Обработчики могут быть созданы лениво, когда они сначала используются.
• Свойство" <регистратор>.handlers". Это определяет пробел или список разделенных запятой значений имен class для классов обработчиков загрузки и регистра как обработчики к указанному регистратору. Каждым именем class должен быть для Обработчика class, у которого есть конструктор по умолчанию. Отметьте, что эти Обработчики могут быть созданы лениво, когда они сначала используются.
• Свойство" <регистратор>.useParentHandlers". Это определяет булево значение. По умолчанию каждый регистратор вызывает своего родителя в дополнение к обработке сообщения журналирования непосредственно, это часто приводит к сообщениям, обрабатываемым полностью регистратор также. Устанавливая это свойство в ложь Обработчик должен быть сконфигурирован для этого регистратора иначе, никакие сообщения журналирования не передаются.
• Свойство "конфигурация". Это свойство предназначается, чтобы позволить произвольному коду конфигурации быть выполненным. Свойство определяет пробел или список разделенных запятой значений имен class. Новый экземпляр будет создаваться для каждого названного class. Конструктор по умолчанию каждого class может выполнить произвольный код, чтобы обновить конфигурацию журналирования, такую как установка уровней регистратора, добавление обработчиков, добавление фильтров, и т.д.

Отметьте, что все классы, загруженные во время конфигурации LogManager, сначала ищутся на системе путь class перед любым пользователем путь class. Это включает LogManager class, любые классы конфигурации, и любые классы обработчика.

Регистраторы организуются в иерархию именования, основанную на их точке разделенные имена. Таким образом "a.b.c" является дочерним элементом "a.b", но "b1" и b2" коллеги.

Все свойства, конец имен которых с ".level", как предполагается, определяет уровни журнала для Регистраторов. Таким образом "foo.level" определяет уровень журнала для регистратора, названного "foo" и (рекурсивно) для любого из его дочерних элементов в иерархии именования. Уровни журнала применяются в порядке, они определяются в файле свойств. Таким образом настройки уровня для дочерних узлов в дереве должны прибыть после настроек для их родителей. Имя свойства ".level" может использоваться, чтобы установить уровень для корня дерева.

Все методы на объекте LogManager мультиориентированы на многопотоковое исполнение.

С тех пор:

1.4

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

Поля

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

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

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

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

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

Модификатор и Тип	Метод и Описание
boolean	addLogger(Logger logger) Добавьте именованный регистратор.
void	addPropertyChangeListener(PropertyChangeListener l) Осуждаемый. Зависимость от PropertyChangeListener создает существенное препятствие для будущей модуляризации платформы Java. Этот метод будет удален в будущем выпуске. Глобальная переменная LogManager может обнаружить изменения к конфигурации журналирования, сверхизбавляя readConfiguration метод.
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) Осуждаемый. Зависимость от PropertyChangeListener создает существенное препятствие для будущей модуляризации платформы Java. Этот метод будет удален в будущем выпуске. Глобальная переменная LogManager может обнаружить изменения к конфигурации журналирования, сверхизбавляя readConfiguration метод.
void	reset() Сбросьте конфигурацию журналирования.

Методы, наследованные от class 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

@Deprecated
public void addPropertyChangeListener(PropertyChangeListener l)
                                           throws SecurityException

Осуждаемый. Зависимость от PropertyChangeListener создает существенное препятствие для будущей модуляризации платформы Java. Этот метод будет удален в будущем выпуске. Глобальная переменная LogManager может обнаружить изменения к конфигурации журналирования, сверхизбавляя readConfiguration метод.

Добавляет слушатель события, чтобы быть вызванным, когда свойства журналирования перечитываются. Добавление многократных экземпляров того же самого события Listener приводит к многократным записям в таблице слушателя события свойства.

ПРЕДУПРЕЖДЕНИЕ: Этот метод опускается от этого class во всех Профилях подмножества Java SE, которые не включают java.beans пакет.

Параметры:

l - слушатель события

Броски:

SecurityException - если менеджер безопасности существует и если вызывающая сторона не имеет контроля LoggingPermission.

NullPointerException - если PropertyChangeListener является нулем.

removePropertyChangeListener

@Deprecated
public void removePropertyChangeListener(PropertyChangeListener l)
                                              throws SecurityException

Осуждаемый. Зависимость от PropertyChangeListener создает существенное препятствие для будущей модуляризации платформы Java. Этот метод будет удален в будущем выпуске. Глобальная переменная LogManager может обнаружить изменения к конфигурации журналирования, сверхизбавляя readConfiguration метод.

Удаляет слушателя события для событий изменения свойства. Если тот же самый экземпляр слушателя был добавлен к таблице слушателя через многократные вызовы addPropertyChangeListener, тогда эквивалентное число removePropertyChangeListener вызовы обязаны удалять все экземпляры того слушателя от таблицы слушателя.

Возвраты тихо, если данный слушатель не находится.

ПРЕДУПРЕЖДЕНИЕ: Этот метод опускается от этого class во всех Профилях подмножества Java SE, которые не включают java.beans пакет.

Параметры:

l - слушатель события (может быть нуль),

Броски:

SecurityException - если менеджер безопасности существует и если вызывающая сторона не имеет контроля LoggingPermission.

addLogger

public boolean addLogger(Logger logger)

Добавьте именованный регистратор. Это ничего не делает и возвращает false, если регистратор с тем же самым именем уже регистрируется.

Методы фабрики Регистратора вызывают этот метод, чтобы зарегистрировать каждый недавно создаваемый Регистратор.

Приложение должно сохранить свою собственную ссылку на объект Регистратора избежать этого собрал "мусор". LogManager может только сохранить слабую ссылку.

Параметры:

logger - новый регистратор.

Возвраты:

истина, если регистратор параметра был зарегистрирован успешно, ложь, если регистратор того имени уже существует.

Броски:

NullPointerException - если имя регистратора является нулем.

getLogger

public Logger getLogger(String name)

Метод, чтобы найти именованный регистратор.

Отметьте, что, так как недоверяемый код может создать регистраторы с произвольными именами, на этот метод нельзя положиться, чтобы счесть Регистраторы для безопасности чувствительным журналированием. Также важно отметить что Регистратор, связанный со Строкой name может быть собран "мусор" в любое время, если нет никакой ссылки strong на Регистратор. Вызывающая сторона этого метода должна проверить возвращаемое значение на нуль, чтобы должным образом обработать случай, где Регистратор был собран "мусор".

Параметры:

name - имя регистратора

Возвраты:

соответствие регистратора или нуля, если ни один не находится

getLoggerNames

public Enumeration<String> getLoggerNames()

Получите перечисление известных имен регистратора.

Отметьте: Регистраторы могут быть добавлены динамически, поскольку новые классы загружаются. Этот метод только сообщает относительно регистраторов, которые в настоящий момент регистрируются. Также важно отметить, что этот метод только возвращает имя Регистратора, не ссылку strong на Регистратор непосредственно. Возвращенная Строка не делает ничего, чтобы препятствовать тому, чтобы Регистратор был собран "мусор". В частности если к возвращенному имени передают 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