Пакет java.util.logging

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

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

1. Диагностика проблем конечными пользователями и системными администраторами. Это включает в себя простое ведение журнала распространенных проблем, которые можно исправить или отследить локально, таких как исчерпание ресурсов, сбои безопасности и простые ошибки конфигурации.
2. Диагностика проблем инженерами по обслуживанию на местах. Информация в журнале, используемая инженерами по обслуживанию на местах, может быть значительно более сложной и подробной, чем та, которая требуется системным администраторам. Как правило, такая информация потребует дополнительного ведения журнала в определенных подсистемах.
3. Диагностика проблем организацией разработчиков. Когда возникает проблема на поле, может потребоваться вернуть собранную информацию о журнале исходной команде разработчиков для диагностики. Эта информация о журнале может быть чрезвычайно подробной и довольно непонятной. Такая информация может включать подробное отслеживание внутренней работы определенных подсистем.
4. Диагностика проблем разработчиками. 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) принимают нулевые значения для всех аргументов, кроме начального аргумента уровня (если таковой имеется).

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

Для обзора потока управления см. Обзор ведения журнала Java.