Пакет java.util.logging

Предоставляет классы и интерфейсы основных средств ведения журнала платформы Java™ 2. Основной целью API ведения журнала является поддержка обслуживания и сопровождения программного обеспечения на сайтах клиентов.

Существует четыре основных целевых использования журналов:

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

Ключевые элементы этого пакета включают:

Logger: Основной объект, на котором приложения выполняют вызовы ведения журнала. Объект Logger используется для записи сообщений для определенной системы или компонента приложения.
LogRecord: Используется для передачи запросов ведения журнала между механизмом ведения журнала и отдельными обработчиками журнала.
Handler: Экспортирует объекты LogRecord в различные места назначения, включая память, потоки вывода, консоли, файлы и сокеты. Для этой цели существует множество подклассов Handler. Дополнительные обработчики могут быть разработаны сторонними разработчиками и интегрированы в основную платформу.
Level: Определяет набор стандартных уровней ведения журнала, которые могут использоваться для управления выводом журнала. Программы могут быть сконфигурированы для вывода журнала на некоторых уровнях, игнорируя вывод на других.
Filter: Предоставляет тонкий контроль над тем, что записывается в журнал, выходящий за рамки управления уровнями журналов. API ведения журнала поддерживают механизм фильтра общего назначения, который позволяет коду приложения присоединять произвольные фильтры для управления выводом журнала.
Formatter: Предоставляет поддержку форматирования объектов LogRecord. Этот пакет включает два форматировщика: SimpleFormatter и XMLFormatter, для форматирования записей журнала в формате простого текста или XML соответственно. Как и в случае с обработчиками, дополнительные форматировщики могут быть разработаны сторонними разработчиками.

API ведения журнала предлагают как статический, так и динамический контроль конфигурации. Статический контроль позволяет персоналу технической поддержки настроить определенную конфигурацию и затем перезапустить приложение с новыми параметрами ведения журнала. Динамический контроль позволяет обновлять конфигурацию ведения журнала внутри работающей программы. API также позволяют включать или отключать ведение журнала для различных функциональных областей системы. Например, инженер по технической поддержке может быть заинтересован в отслеживании всех событий AWT, но может не проявлять интереса к событиям сокета или управлению памятью.

Null-указатели

В общем случае, если не указано иное в javadoc, методы и конструкторы будут выбрасывать NullPointerException, если им передается null-аргумент. Единственное широкое исключение из этого правила заключается в том, что удобные методы ведения журнала в классе Logger (методы config, entering, exiting, fine, finer, finest, log, logp, logrb, severe, throwing и warning) будут принимать значения null для всех аргументов, кроме начального аргумента уровня (если таковой имеется).

Связанная документация

Для ознакомления с общим описанием потока управления обратитесь к Обзору Java Logging

С момента:: 1.4

Интерфейс	Описание
Filter	Фильтр может использоваться для предоставления тонкого управления над тем, что записывается в журнал, выходящее за рамки управления уровнями журналов.
LoggingMXBean	Устарело. `LoggingMXBean` больше не является `platform MXBean` и заменен на `PlatformLoggingMXBean`.

Класс	Описание
ConsoleHandler	Этот `Handler` публикует записи журнала в `System.err`.
ErrorManager	Объекты ErrorManager могут быть подключены к обработчикам для обработки любых ошибок, возникающих в обработчике во время ведения журнала.
FileHandler	Простой файл ведения журнала `Handler`.
Formatter	Форматировщик предоставляет поддержку форматирования записей LogRecords.
Handler	Объект `Handler` принимает сообщения журнала из `Logger` и экспортирует их.
Level	Класс Level определяет набор стандартных уровней ведения журнала, которые могут использоваться для управления выводом журнала.
Logger	Объект Logger используется для записи сообщений для определенной системы или компонента приложения.
LoggingPermission	Разрешение, которое SecurityManager будет проверять, когда код, выполняющийся с SecurityManager, вызывает один из методов управления ведением журнала (например, Logger.setLevel).
LogManager	Существует один глобальный объект LogManager, который используется для поддержания набора состояния общего пользования относительно Logger и служб ведения журнала.
LogRecord	Объекты LogRecord используются для передачи запросов ведения журнала между механизмом ведения журнала и отдельными обработчиками журнала.
MemoryHandler	`Handler`, который буферирует запросы в кольцевом буфере в памяти.
SimpleFormatter	Выводит краткое изложение `LogRecord` в удобочитаемом формате.
SocketHandler	Простая сетевая система ведения журнала `Handler`.
StreamHandler	Потоковая система ведения журнала `Handler`.
XMLFormatter	Форматирует LogRecord в стандартный формат XML.