Пакет java.util.logging

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

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) принимают значения null для всех аргументов, кроме начального аргумента Level (если таковой имеется).

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

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