Пакет java.util.logging

package 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

Since:: 1.4

java.base

Модуль	Пакет	Описание
java.util	Содержит фреймворк коллекций, некоторые классы поддержки интернационализации, загрузчик сервисов, свойства, генерацию случайных чисел, классы для разбора и сканирования строк, кодирование и декодирование base64, битовый массив и несколько вспомогательных классов.

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

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.logging/java/util/logging/package-summary.html

Пакет java.util.logging

Null-указатели

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