Пакет java.util.logging

Обеспечивает классы и интерфейсы ^JavaTM базовое журналирование 2 платформ средств.

См.: Описание

Сводка интерфейса

Интерфейс	Описание
Фильтр	Фильтр может использоваться, чтобы обеспечить мелкомодульное управление тем, что регистрируется вне управления, обеспеченного уровнями журнала.
LoggingMXBean	Интерфейс управления для средства журналирования.

Сводка класса

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

Пакет java.util.logging Описание

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

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

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

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

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

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

Нулевые указатели

Вообще, если не указано иное в javadoc, методы и конструкторы бросят NullPointerException если передано нулевой параметр. Одно широкое исключение к этому правилу - то, что методы удобства журналирования в Регистраторе class (конфигурация, ввод, выход, прекрасный, более прекрасный, самый прекрасный, журнал, logp, logrb, серьезный, бросок, и методы предупреждения), примут нулевые значения для всех параметров за исключением начального параметра Уровня (если любой).

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

Для краткого обзора потока управления, пожалуйста, сошлитесь на Краткий обзор Журналирования Java.

С тех пор:

1.4