Класс Logger

java.lang.Object

java.util.logging.Logger

public class Logger extends Object

Объект Logger используется для записи сообщений для определенного компонента системы или приложения. Логгеры обычно имеют имя, используя иерархическое пространство имён, разделённое точками. Имена логгеров могут быть произвольными строками, но они обычно должны основываться на имени пакета или имени класса логгируемого компонента, например, java.net или javax.swing. Кроме того, можно создавать «анонимные» логгеры, которые не хранятся в пространстве имён логгеров.

Объекты Logger могут быть получены по вызовам одного из методов-фабрик getLogger. Эти методы либо создают новый Logger, либо возвращают подходящий существующий Logger. Важно отметить, что Logger, возвращённый одним из getLogger методов-фабрик, может быть удалён сборщиком мусора в любое время, если сильная ссылка на Logger не сохраняется.

Сообщения о логгировании будут пересылаться зарегистрированным объектам Handler, которые могут пересылать сообщения в различные места назначения, включая консоли, файлы, системные журналы и т. д.

Каждый Logger отслеживает «родительский» Logger, который является ближайшим существующим предком в пространстве имён Logger.

Каждый Logger имеет связанный с ним «Уровень». Это отражает минимальный уровень, который этот логгер рассматривает. Если уровень Logger установлен на null, то его эффективный уровень унаследован от родительского, который, в свою очередь, может получить его рекурсивно от своего родителя и так далее по дереву.

Уровень журнала можно настроить на основе свойств из файла конфигурации журнала, как описано в описании класса LogManager. Однако его также можно динамически изменить с помощью вызовов метода Logger.setLevel. Если уровень логгера изменён, изменение может также повлиять на дочерние логгеры, так как любой дочерний логгер, имеющий null в качестве уровня, унаследует свой эффективный уровень от своего родителя.

При каждом вызове логгирования Logger первоначально выполняет быструю проверку уровня запроса (например, SEVERE или FINE) по отношению к эффективному уровню журнала логгера. Если уровень запроса ниже уровня журнала, вызов логгирования возвращается немедленно.

После прохождения этой начальной (быстрой) проверки Logger выделит LogRecord для описания сообщения о логгировании. Затем он вызовет Filter (если он присутствует), чтобы выполнить более подробную проверку того, следует ли публиковать запись. Если это пройдёт, он опубликует LogRecord своим выходным обработчикам Handlers. По умолчанию логгеры также публикуют свои сообщения родительским Handlers, рекурсивно по дереву.

Каждый Logger может иметь связанный с ним ResourceBundle. ResourceBundle может быть указан по имени, используя метод-фабрику getLogger(java.lang.String, java.lang.String), или по значению — используя метод setResourceBundle. Этот пакет будет использоваться для локализации сообщений о логгировании. Если у Logger нет собственного ResourceBundle или имени ресурсного пакета, то он унаследует ResourceBundle или имя ресурсного пакета от своего родителя, рекурсивно по дереву.

Большинство методов вывода логгера принимают аргумент «msg». Этот аргумент msg может быть либо сырым значением, либо ключом локализации. Во время форматирования, если у логгера есть (или унаследован) пакет локализации ResourceBundle, и если пакет ResourceBundle имеет отображение для строки msg, то строка msg заменяется локализованным значением. В противном случае используется исходная строка msg. Как правило, форматировщики используют форматирование в стиле java.text.MessageFormat для форматирования параметров, например, строка формата "{0} {1}" отформатирует два параметра как строки.

Набор методов альтернативно принимает «msgSupplier» вместо аргумента «msg». Эти методы принимают функцию Supplier<String>, которая вызывается для построения желаемого сообщения о логгировании только тогда, когда сообщение фактически должно быть залогировано на основе эффективного уровня журнала, тем самым устраняя ненужное построение сообщения. Например, если разработчик хочет залогировать статус состояния системы для диагностики, с версией, принимающей String, код будет выглядеть так:



  class DiagnosisMessages {
    static String systemHealthStatus() {
      // collect system health information
      ...
    }
  }
  ...
  logger.log(Level.FINER, DiagnosisMessages.systemHealthStatus());

С приведенным выше кодом состояние здоровья собирается необоснованно, даже если уровень журнала FINER отключен. С версией, принимающей Supplier, как показано ниже, статус будет собираться только тогда, когда уровень журнала FINER включен.



  logger.log(Level.FINER, DiagnosisMessages::systemHealthStatus);

При поиске ResourceBundle логгер сначала проверяет, был ли пакет указан с помощью setResourceBundle, а затем только, было ли указано имя ресурсного пакета через метод-фабрику getLogger. Если ResourceBundle или имя ресурсного пакета не найдены, то он будет использовать ближайшее ResourceBundle или имя ресурсного пакета, унаследованное от родительского дерева.
Когда ResourceBundle был унаследован или указан через метод setResourceBundle, то этот ResourceBundle будет использован. В противном случае, если у логгера есть или унаследован только имя ресурсного пакета, то это имя ресурсного пакета будет сопоставлено с объектом ResourceBundle, используя локаль по умолчанию на момент логгирования.
При сопоставлении имён ресурсных пакетов с объектами ResourceBundle, логгер сначала попробует использовать контекстный класс загрузчика потока контекстный класс загрузчик для сопоставления данного имени ресурсного пакета с объектом ResourceBundle. Если контекстный класс загрузчик потока null, он попробует использовать системный класс загрузчик вместо этого. Если ResourceBundle по-прежнему не найден, он будет использовать класс загрузчик первого вызывающего метода-фабрики getLogger.

Форматирование (включая локализация) является обязанностью выходного обработчика Handler, который обычно вызовет Formatter.

Обратите внимание, что форматирование не обязательно происходит синхронно. Оно может быть отложено до тех пор, пока LogRecord фактически не будет записан во внешнюю утилиту хранения.

Методы логгирования сгруппированы в пять основных категорий:

Существует набор методов «log», которые принимают уровень журнала, строку сообщения и необязательно некоторые параметры для строки сообщения.
Существует набор методов «logp» (для «log precise»), которые похожи на методы «log», но также принимают имя класса источника и имя метода.
Существует набор методов «logrb» (для «log with resource bundle»), которые похожи на метод «logp», но также принимают явный объект ресурсного пакета для использования при локализации сообщения о логгировании.
Есть удобные методы для отслеживания входов в методы (методы «entering»), возвратов методов (методы «exiting») и выброса исключений (методы «throwing»).
Наконец, есть набор удобных методов для использования в самых простых случаях, когда разработчик просто хочет залогировать простую строку на заданном уровне журнала. Эти методы названы в честь стандартных имён уровней («severe», «warning», «info» и т. д.) и принимают один аргумент — строку сообщения.

Для методов, которые не принимают явное имя источника и имя метода, среда выполнения Loggings попытается определить, какой класс и метод вызвали метод логгирования. Тем не менее, важно понимать, что эта автоматически полученная информация может быть лишь приблизительной (или даже совершенно ошибочной!). Виртуальные машины могут выполнять обширные оптимизации при JIT-компиляции и могут полностью удалять кадровые записи стека, что делает невозможным надёжное определение вызывающего класса и метода.

Все методы в Logger многопоточно безопасны.

Информация о подклассах: Обратите внимание, что класс LogManager может предоставить свою собственную реализацию именованных логгеров для любой точки пространства имён. Поэтому все подклассы Logger (если они не реализуются совместно с новым классом LogManager) должны позаботиться о получении экземпляра Logger из класса LogManager и делегировать операции, такие как «isLoggable» и «log(LogRecord)», этому экземпляру. Обратите внимание, что для перехвата всего логгирования подклассы должны переопределить только метод log(LogRecord). Все остальные методы логгирования реализуются как вызовы этого метода log(LogRecord).

Since:: 1.4

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final Logger`	`global`	Устаревшее. Инициализация этого поля может привести к тупиковым состояниям.
`static final String`	`GLOBAL_LOGGER_NAME`	GLOBAL_LOGGER_NAME — имя глобального логгера.

Краткое описание конструкторов

Logger(String name,
 String resourceBundleName)

Модификатор	Конструктор	Описание
`protected`	Защищённый метод для создания логгера для именованной подсистемы.

Краткое описание методов

Modifier and Type	Method	Description
`void`	`addHandler(Handler handler)`	Добавить обработчик логов для получения сообщений об ошибках.
`void`	`config(String msg)`	Вывести сообщение CONFIG.
`void`	`config(Supplier<String> msgSupplier)`	Вывести сообщение CONFIG, которое будет создано только в том случае, если уровень ведения журнала достаточно высок, чтобы сообщение действительно было записано.
`void`	`entering(String sourceClass, String sourceMethod)`	Вывести сообщение о начале метода.
`void`	`entering(String sourceClass, String sourceMethod, Object param1)`	Вывести сообщение о начале метода с одним параметром.
`void`	`entering(String sourceClass, String sourceMethod, Object[] params)`	Вывести сообщение о начале метода с массивом параметров.
`void`	`exiting(String sourceClass, String sourceMethod)`	Вывести сообщение о возврате из метода.
`void`	`exiting(String sourceClass, String sourceMethod, Object result)`	Вывести сообщение о возврате из метода с объектом результата.
`void`	`fine(String msg)`	Вывести сообщение FINE.
`void`	`fine(Supplier<String> msgSupplier)`	Вывести сообщение FINE, которое будет создано только в том случае, если уровень ведения журнала достаточно высок, чтобы сообщение действительно было записано.
`void`	`finer(String msg)`	Вывести сообщение FINER.
`void`	`finer(Supplier<String> msgSupplier)`	Вывести сообщение FINER, которое будет создано только в том случае, если уровень ведения журнала достаточно высок, чтобы сообщение действительно было записано.
`void`	`finest(String msg)`	Вывести сообщение FINEST.
`void`	`finest(Supplier<String> msgSupplier)`	Вывести сообщение FINEST, которое будет создано только в том случае, если уровень ведения журнала достаточно высок, чтобы сообщение действительно было записано.
`static Logger`	`getAnonymousLogger()`	Создать анонимный логгер.
`static Logger`	`getAnonymousLogger(String resourceBundleName)`	Создать анонимный логгер.
`Filter`	`getFilter()`	Получить текущий фильтр для этого логгера.
`static final Logger`	`getGlobal()`	Вернуть глобальный объект логгера с именем Logger.GLOBAL_LOGGER_NAME.
`Handler[]`	`getHandlers()`	Получить обработчики, связанные с этим логгером.
`Level`	`getLevel()`	Получить уровень логирования, указанный для этого логгера.
`static Logger`	`getLogger(String name)`	Найти или создать логгер для заданного подсистемы.
`static Logger`	`getLogger(String name, String resourceBundleName)`	Найти или создать логгер для заданного подсистемы.
`String`	`getName()`	Получить имя для этого логгера.
`Logger`	`getParent()`	Вернуть родительский логгер для этого логгера.
`ResourceBundle`	`getResourceBundle()`	Получить ресурсный пакет локализации для этого логгера.
`String`	`getResourceBundleName()`	Получить имя ресурсного пакета локализации для этого логгера.
`boolean`	`getUseParentHandlers()`	Определить, отправляет ли этот логгер свой вывод в родительский логгер.
`void`	`info(String msg)`	Вывести сообщение INFO.
`void`	`info(Supplier<String> msgSupplier)`	Вывести сообщение INFO, которое будет создано только в том случае, если уровень ведения журнала достаточно высок, чтобы сообщение действительно было записано.
`boolean`	`isLoggable(Level level)`	Проверить, будет ли сообщение данного уровня действительно записано этим логгером.
`void`	`log(Level level, String msg)`	Вывести сообщение без аргументов.
`void`	`log(Level level, String msg, Object param1)`	Вывести сообщение с одним параметром-объектом.
`void`	`log(Level level, String msg, Object[] params)`	Вывести сообщение с массивом параметров-объектов.
`void`	`log(Level level, String msg, Throwable thrown)`	Вывести сообщение с информацией о связанном исключении Throwable.
`void`	`log(Level level, Throwable thrown, Supplier<String> msgSupplier)`	Вывести отложенное сообщение с информацией о связанном исключении Throwable.
`void`	`log(Level level, Supplier<String> msgSupplier)`	Вывести сообщение, которое будет создано только в том случае, если уровень ведения журнала достаточно высок, чтобы сообщение действительно было записано.
`void`	`log(LogRecord record)`	Вывести LogRecord.
`void`	`logp(Level level, String sourceClass, String sourceMethod, String msg)`	Вывести сообщение, указав класс и метод источника, без аргументов.
`void`	`logp(Level level, String sourceClass, String sourceMethod, String msg, Object param1)`	Вывести сообщение, указав класс и метод источника, с одним параметром-объектом сообщения.
`void`	`logp(Level level, String sourceClass, String sourceMethod, String msg, Object[] params)`	Вывести сообщение, указав класс и метод источника, с массивом параметров-объектов.
`void`	`logp(Level level, String sourceClass, String sourceMethod, String msg, Throwable thrown)`	Вывести сообщение, указав класс и метод источника, с информацией о связанном исключении Throwable.
`void`	`logp(Level level, String sourceClass, String sourceMethod, Throwable thrown, Supplier<String> msgSupplier)`	Вывести отложенное сообщение, указав класс и метод источника, с информацией о связанном исключении Throwable.
`void`	`logp(Level level, String sourceClass, String sourceMethod, Supplier<String> msgSupplier)`	Вывести отложенное сообщение, указав класс и метод источника, без аргументов.
`void`	`logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg)`	Устарело. Используйте `logrb(java.util.logging.Level, java.lang.String, java.lang.String, java.util.ResourceBundle, java.lang.String, java.lang.Object...)` вместо этого.
`void`	`logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg, Object param1)`	Устарело. Используйте `logrb(java.util.logging.Level, java.lang.String, java.lang.String, java.util.ResourceBundle, java.lang.String, java.lang.Object...)` вместо этого
`void`	`logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg, Object[] params)`	Устарело. Используйте `logrb(java.util.logging.Level, java.lang.String, java.lang.String, java.util.ResourceBundle, java.lang.String, java.lang.Object...)` вместо этого.
`void`	`logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg, Throwable thrown)`	Устарело. Используйте `logrb(java.util.logging.Level, java.lang.String, java.lang.String, java.util.ResourceBundle, java.lang.String, java.lang.Throwable)` вместо этого.
`void`	`logrb(Level level, String sourceClass, String sourceMethod, ResourceBundle bundle, String msg, Object... params)`	Вывести сообщение, указав класс, метод и ресурсный пакет, с необязательным списком параметров сообщения.
`void`	`logrb(Level level, String sourceClass, String sourceMethod, ResourceBundle bundle, String msg, Throwable thrown)`	Вывести сообщение, указав класс, метод и ресурсный пакет, с информацией о связанном исключении Throwable.
`void`	`logrb(Level level, ResourceBundle bundle, String msg, Object... params)`	Вывести сообщение, указав класс, метод и ресурсный пакет, с необязательным списком параметров сообщения.
`void`	`logrb(Level level, ResourceBundle bundle, String msg, Throwable thrown)`	Вывести сообщение, указав класс, метод и ресурсный пакет, с информацией о связанном исключении Throwable.
`void`	`removeHandler(Handler handler)`	Удалить обработчик логов.
`void`	`setFilter(Filter newFilter)`	Установить фильтр для управления выводом в этом логгер.
`void`	`setLevel(Level newLevel)`	Установить уровень логирования, определяющий уровни сообщений, которые будут записаны этим логгером.
`void`	`setParent(Logger parent)`	Установить родительский логгер для этого логгера.
`void`	`setResourceBundle(ResourceBundle bundle)`	Устанавливает ресурсный пакет для этого логгера.
`void`	`setUseParentHandlers(boolean useParentHandlers)`	Указать, должен ли этот логгер отправлять свой вывод в родительский логгер.
`void`	`severe(String msg)`	Вывести сообщение SEVERE.
`void`	`severe(Supplier<String> msgSupplier)`	Вывести сообщение SEVERE, которое будет создано только в том случае, если уровень ведения журнала достаточно высок, чтобы сообщение действительно было записано.

`void`	`throwing(String sourceClass, String sourceMethod, Throwable thrown)`	Выброс исключения с логгированием.
`void`	`warning(String msg)`	Запись сообщения WARNING.
`void`	`warning(Supplier<String> msgSupplier)`	Запись сообщения WARNING, которое будет создано только в том случае, если уровень логирования достаточен для записи сообщения.

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание полей

GLOBAL_LOGGER_NAME

public static final String GLOBAL_LOGGER_NAME

GLOBAL_LOGGER_NAME — имя глобального логгера.

Since:

1.6

См. также:

global

@Deprecated public static final Logger global

Устаревшее.

Инициализация этого поля может привести к тупиковым ситуациям. Поле должно быть инициализировано при инициализации класса Logger, что может вызвать тупиковую ситуацию с инициализацией класса LogManager. В таких случаях два класса ожидают завершения друг друга. Предпочтительный способ получения объекта глобального логгера — вызов Logger.getGlobal(). Для совместимости со старыми версиями JDK, где Logger.getGlobal() недоступен, используйте вызов Logger.getLogger(Logger.GLOBAL_LOGGER_NAME) или Logger.getLogger("global").

Объект логгера "global" предоставляется для удобства разработчиков, которые нечасто используют пакет Logging. Разработчики, активно использующие пакет ведения журнала (например, в продуктах), должны создавать и использовать свои собственные объекты Logger с соответствующими именами, чтобы логирование можно было контролировать на подходящем уровне каждого Logger. Разработчики также должны сохранять сильную ссылку на свои объекты Logger, чтобы предотвратить их сборку мусора.

Подробное описание конструкторов

Logger

protected Logger(String name, String resourceBundleName)

Защищенный метод для построения логгера для именованного подсистемы.

Логгер будет первоначально сконфигурирован с уровнем null и с useParentHandlers, установленным в true.

Параметры:: name - Имя логгера. Это имя с разделителями точек и, как правило, должно основываться на имени пакета или имени класса подсистемы, например, java.net или javax.swing. Для анонимных логгеров оно может быть null.; resourceBundleName - Имя ResourceBundle, используемого для локализации сообщений для этого логгера. Может быть null, если ни одно из сообщений не требует локализации.
Исключения:: MissingResourceException - если resourceBundleName не null и соответствующий ресурс не найден.

Подробное описание методов

getGlobal

public static final Logger getGlobal()

Возвращает объект глобального логгера с именем Logger.GLOBAL_LOGGER_NAME.

Возвращает:: объект глобального логгера
Since:: 1.7

getLogger

public static Logger getLogger(String name)

Поиск или создание логгера для именованной подсистемы. Если логгер с заданным именем уже существует, он возвращается. В противном случае создается новый логгер.

Если создается новый логгер, его уровень ведения журнала настраивается на основе конфигурации LogManager, и он также будет настраиваться на отправку выходных данных ведения журнала обработчикам своего родительского элемента. Он будет зарегистрирован в глобальном пространстве имен LogManager.

Примечание: LogManager может сохранить только слабую ссылку на вновь созданный Logger. Важно понимать, что ранее созданный Logger с заданным именем может быть собран сборщиком мусора в любое время, если нет сильной ссылки на Logger. В частности, это означает, что два последовательных вызова, например, getLogger("MyLogger").log(...), могут использовать разные объекты Logger с именем «MyLogger», если нигде в программе нет сильной ссылки на Logger с именем «MyLogger».

Параметры:: name - Имя логгера. Это имя с разделителями точек и, как правило, должно основываться на имени пакета или имени класса подсистемы, например, java.net или javax.swing
Возвращает:: подходящий Logger
Исключения:: NullPointerException - если имя равно null.

getLogger

public static Logger getLogger(String name, String resourceBundleName)

Примечание: LogManager может сохранить только слабую ссылку на вновь созданный Logger. Важно понимать, что ранее созданный Logger с заданным именем может быть собран сборщиком мусора в любое время, если нет сильной ссылки на Logger. В частности, это означает, что два последовательных вызова, например, getLogger("MyLogger", ...).log(...), могут использовать разные объекты Logger с именем «MyLogger», если нигде в программе нет сильной ссылки на Logger с именем «MyLogger».

Если именованный Logger уже существует и еще не имеет ресурсного набора локализации, то используется заданное имя ресурсного набора. Если именованный Logger уже существует и имеет другое имя ресурсного набора, выбрасывается исключение IllegalArgumentException.

Параметры:: name - Имя логгера. Это имя с разделителями точек и, как правило, должно основываться на имени пакета или имени класса подсистемы, например, java.net или javax.swing; resourceBundleName - Имя ResourceBundle, используемого для локализации сообщений для этого логгера. Может быть null, если ни одно из сообщений не требует локализации.
Возвращает:: подходящий Logger
Исключения:: MissingResourceException - если resourceBundleName не null и соответствующий ресурс не найден.; IllegalArgumentException - если Logger уже существует и использует другое имя ресурсного набора; или если resourceBundleName равен null, но именованный логгер имеет установленный ресурсный набор.; NullPointerException - если имя равно null.

getAnonymousLogger

public static Logger getAnonymousLogger()

Создает анонимный логгер. Созданный логгер не регистрируется в пространстве имен LogManager.

Этот фабричный метод изначально был предназначен для использования из апплетов. Поскольку полученный логгер анонимный, его можно сохранить в частном порядке создающим классом. Это устранило необходимость в стандартных проверках безопасности, что, в свою очередь, позволило небезопасным апплетам обновлять состояние логгера. Например, апплет мог выполнить setLevel или addHandler на анонимном логгере.

Несмотря на то, что новый логгер анонимный, он настроен таким образом, что корневой логгер («») является его родителем. Это означает, что по умолчанию он наследует свой эффективный уровень и обработчики от корневого логгера.

Возвращает:: новый созданный частный логгер

getAnonymousLogger

public static Logger getAnonymousLogger(String resourceBundleName)

Создает анонимный логгер. Созданный логгер не регистрируется в пространстве имен LogManager.

Параметры:: resourceBundleName - имя ResourceBundle, используемого для локализации сообщений для этого логгера. Может быть null, если ни одно из сообщений не требует локализации.
Возвращает:: новый созданный частный логгер
Исключения:: MissingResourceException - если resourceBundleName не null и соответствующий ресурс не найден.

getResourceBundle

public ResourceBundle getResourceBundle()

Получение ресурсного набора локализации для этого логгера. Этот метод вернет ResourceBundle, который был установлен методом setResourceBundle или сопоставлен из имени ресурсного набора, установленного через фабричный метод getLogger для текущего языка по умолчанию.
Обратите внимание, что если результат равен null, то логгер будет использовать ресурсный набор или имя ресурсного набора, унаследованное от родительского элемента.

Возвращает:: набор локализации (может быть null)

getResourceBundleName

public String getResourceBundleName()

Получение имени ресурсного набора локализации для этого логгера. Это либо имя, указанное через фабричный метод getLogger, либо базовое имя ResourceBundle, установленное методом setResourceBundle.
Обратите внимание, что если результат равен null, то логгер будет использовать ресурсный набор или имя ресурсного набора, унаследованное от родительского элемента.

Возвращает:: имя набора локализации (может быть null)

setFilter

public void setFilter(Filter newFilter)

Установка фильтра для управления выводом в этом логгере.

После прохождения начальной проверки "уровня" логгер вызовет этот фильтр, чтобы проверить, должен ли журнал действительно публиковаться.

Параметры:: newFilter - объект фильтра (может быть null)

getFilter

public Filter getFilter()

Получение текущего фильтра для этого логгера.

Возвращает:: объект фильтра (может быть null)

Запись

public void log(LogRecord record)

Записать LogRecord.

Все остальные методы логирования в этом классе вызывают этот метод для фактического выполнения логирования. Подклассы могут переопределять этот единственный метод, чтобы захватить всю активность логирования.

Параметры:: record - LogRecord, который будет опубликован

Запись

public void log(Level level, String msg)

Записать сообщение без аргументов.

Если журналирование в данный момент включено для данного уровня сообщения, то заданное сообщение передается всем зарегистрированным обработчикам вывода.

Параметры:: level - Один из идентификаторов уровня сообщения, например, SEVERE; msg - Строковое сообщение (или ключ в каталоге сообщений)

Запись

public void log(Level level, Supplier<String> msgSupplier)

Записать сообщение, которое будет построено только в том случае, если уровень логирования такой, что сообщение фактически будет записано.

Если журналирование в данный момент включено для данного уровня сообщения, то сообщение строится путём вызова предоставленной функции-поставщика и передаётся всем зарегистрированным обработчикам вывода.

Параметры:: level - Один из идентификаторов уровня сообщения, например, SEVERE; msgSupplier - Функция, которая при вызове генерирует желаемое сообщение журнала
С:: 1.8

Запись

public void log(Level level, String msg, Object param1)

Записать сообщение с одним объектным параметром.

Если журналирование в данный момент включено для данного уровня сообщения, то создаётся соответствующий LogRecord и передаётся всем зарегистрированным обработчикам вывода.

Параметры:: level - Один из идентификаторов уровня сообщения, например, SEVERE; msg - Строковое сообщение (или ключ в каталоге сообщений); param1 - параметр сообщения

Запись

public void log(Level level, String msg, Object[] params)

Записать сообщение с массивом объектных аргументов.

Параметры:: level - Один из идентификаторов уровня сообщения, например, SEVERE; msg - Строковое сообщение (или ключ в каталоге сообщений); params - массив параметров сообщения

Запись

public void log(Level level, String msg, Throwable thrown)

Записать сообщение с информацией об исключении.

Если журналирование в данный момент включено для данного уровня сообщения, то заданные аргументы сохраняются в LogRecord, который передаётся всем зарегистрированным обработчикам вывода.

Обратите внимание, что аргумент исключения сохраняется в свойстве thrown LogRecord, а не в свойстве параметров LogRecord. Таким образом, он обрабатывается специально обработчиками формата и не рассматривается как параметр форматирования для свойства сообщения LogRecord.

Параметры:: level - Один из идентификаторов уровня сообщения, например, SEVERE; msg - Строковое сообщение (или ключ в каталоге сообщений); thrown - Исключение, связанное с сообщением журнала.

Запись

public void log(Level level, Throwable thrown, Supplier<String> msgSupplier)

Записать лениво построенное сообщение с информацией об исключении.

Если журналирование в данный момент включено для данного уровня сообщения, то сообщение строится путём вызова предоставленной функции-поставщика. Затем сообщение и данное Throwable сохраняются в LogRecord, который передаётся всем зарегистрированным обработчикам вывода.

Параметры:: level - Один из идентификаторов уровня сообщения, например, SEVERE; thrown - Исключение, связанное с сообщением журнала.; msgSupplier - Функция, которая при вызове генерирует желаемое сообщение журнала
С:: 1.8

Запись

public void logp(Level level, String sourceClass, String sourceMethod, String msg)

Записать сообщение, указав источник класса и метода, без аргументов.

Если журналирование в данный момент включено для данного уровня сообщения, то заданное сообщение передаётся всем зарегистрированным обработчикам вывода.

Параметры:: level - Один из идентификаторов уровня сообщения, например, SEVERE; sourceClass - имя класса, который инициировал запрос логирования; sourceMethod - имя метода, который инициировал запрос логирования; msg - Строковое сообщение (или ключ в каталоге сообщений)

Запись

public void logp(Level level, String sourceClass, String sourceMethod, Supplier<String> msgSupplier)

Записать лениво построенное сообщение, указав источник класса и метода, без аргументов.

Параметры:: level - Один из идентификаторов уровня сообщения, например, SEVERE; sourceClass - имя класса, который инициировал запрос логирования; sourceMethod - имя метода, который инициировал запрос логирования; msgSupplier - Функция, которая при вызове генерирует желаемое сообщение журнала
С:: 1.8

Запись

public void logp(Level level, String sourceClass, String sourceMethod, String msg, Object param1)

Записать сообщение, указав источник класса и метода, с одним объектным параметром для сообщения журнала.

Параметры:: level - Один из идентификаторов уровня сообщения, например, SEVERE; sourceClass - имя класса, который инициировал запрос логирования; sourceMethod - имя метода, который инициировал запрос логирования; msg - Строковое сообщение (или ключ в каталоге сообщений); param1 - Параметр сообщения журнала.

Запись

public void logp(Level level, String sourceClass, String sourceMethod, String msg, Object[] params)

Записать сообщение, указав источник класса и метода, с массивом объектных аргументов.

Параметры:: level - Один из идентификаторов уровня сообщения, например, SEVERE; sourceClass - имя класса, который инициировал запрос логирования; sourceMethod - имя метода, который инициировал запрос логирования; msg - Строковое сообщение (или ключ в каталоге сообщений); params - Массив параметров сообщения

Запись

public void logp(Level level, String sourceClass, String sourceMethod, String msg, Throwable thrown)

Записать сообщение, указав источник класса и метода, с информацией об исключении.

Параметры:: level - Один из идентификаторов уровня сообщения, например, SEVERE; sourceClass - имя класса, который инициировал запрос логирования; sourceMethod - имя метода, который инициировал запрос логирования; msg - Строковое сообщение (или ключ в каталоге сообщений); thrown - Исключение, связанное с сообщением журнала.

logp

public void logp(Level level, String sourceClass, String sourceMethod, Throwable thrown, Supplier<String> msgSupplier)

Записать лениво сконструированное сообщение, указав класс и метод источника, с ассоциированной информацией о Throwable.

Если логировщик в настоящее время включён для заданного уровня сообщения, то сообщение конструируется, вызвав предоставленную функцию поставщика. Сообщение и заданный Throwable затем сохраняются в LogRecord, который передаётся всем зарегистрированным обработчикам вывода.

Обратите внимание, что переданный аргумент хранится в свойстве thrown записи лога, а не в свойстве параметров записи лога. Таким образом, он обрабатывается особенно обработчиками формата и не обрабатывается как параметр форматирования для свойства сообщения записи лога.

Параметры:: level - Один из идентификаторов уровня сообщения, например, SEVERE; sourceClass - имя класса, который запросил ведение журнала; sourceMethod - имя метода, который запросил ведение журнала; thrown - Throwable, связанный с сообщением журнала.; msgSupplier - Функция, которая при вызове производит желаемое сообщение журнала
С:: 1.8

logrb

@Deprecated public void logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg)

Устарело.

Используйте

logrb(java.util.logging.Level, java.lang.String, java.lang.String, java.util.ResourceBundle, java.lang.String, java.lang.Object...)

вместо этого.

Записать сообщение, указав имя класса источника, метода и ресурсного набора с аргументами.

Если логировщик в настоящее время включён для заданного уровня сообщения, то данное сообщение передается всем зарегистрированным обработчикам вывода.

Строка msg локализуется с использованием указанного ресурсного набора. Если имя ресурсного набора null или пустая строка или некорректное, то строка msg не локализуется.

Параметры:: level - Один из идентификаторов уровня сообщения, например, SEVERE; sourceClass - имя класса, который запросил ведение журнала; sourceMethod - имя метода, который запросил ведение журнала; bundleName - имя ресурсного набора для локализации msg, может быть null; msg - Строковое сообщение (или ключ в каталоге сообщений)

logrb

@Deprecated public void logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg, Object param1)

Устарело.

Используйте

logrb(java.util.logging.Level, java.lang.String, java.lang.String, java.util.ResourceBundle, java.lang.String, java.lang.Object...)

вместо этого

Записать сообщение, указав имя класса источника, метода и ресурсного набора, с одним параметром объекта для сообщения журнала.

Если логировщик в настоящее время включён для заданного уровня сообщения, то создается соответствующая запись журнала, которая передается всем зарегистрированным обработчикам вывода.

Параметры:: level - Один из идентификаторов уровня сообщения, например, SEVERE; sourceClass - имя класса, который запросил ведение журнала; sourceMethod - имя метода, который запросил ведение журнала; bundleName - имя ресурсного набора для локализации msg, может быть null; msg - Строковое сообщение (или ключ в каталоге сообщений); param1 - Параметр для сообщения журнала.

logrb

@Deprecated public void logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg, Object[] params)

Устарело.

Используйте

logrb(java.util.logging.Level, java.lang.String, java.lang.String, java.util.ResourceBundle, java.lang.String, java.lang.Object...)

вместо этого.

Записать сообщение, указав имя класса источника, метода и ресурсного набора, с массивом аргументов объекта.

Параметры:: level - Один из идентификаторов уровня сообщения, например, SEVERE; sourceClass - имя класса, который запросил ведение журнала; sourceMethod - имя метода, который запросил ведение журнала; bundleName - имя ресурсного набора для локализации msg, может быть null.; msg - Строковое сообщение (или ключ в каталоге сообщений); params - Массив параметров сообщения

logrb

public void logrb(Level level, String sourceClass, String sourceMethod, ResourceBundle bundle, String msg, Object... params)

Записать сообщение, указав класс источника, метод и ресурсный набор, с необязательным списком параметров сообщения.

Если логировщик в настоящее время включён для заданного уровня сообщения level, то создается соответствующая LogRecord и передается всем зарегистрированным объектам вывода Handler.

Строка msg локализуется с использованием данного ресурсного набора. Если ресурсный набор null, то строка msg не локализуется.

Параметры:: level - Один из идентификаторов уровня сообщения, например, SEVERE; sourceClass - Имя класса, который запросил ведение журнала; sourceMethod - Имя метода, который запросил ведение журнала; bundle - Ресурсный набор для локализации msg, может быть null.; msg - Строковое сообщение (или ключ в каталоге сообщений); params - Параметры сообщения (необязательные, может быть пусто).
С:: 1.8

logrb

public void logrb(Level level, ResourceBundle bundle, String msg, Object... params)

Параметры:: level - Один из идентификаторов уровня сообщения, например, SEVERE; bundle - Ресурсный набор для локализации msg; может быть null.; msg - Строковое сообщение (или ключ в каталоге сообщений); params - Параметры сообщения (необязательные, может быть пусто).
С:: 9

logrb

@Deprecated public void logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg, Throwable thrown)

Устарело.

Используйте

logrb(java.util.logging.Level, java.lang.String, java.lang.String, java.util.ResourceBundle, java.lang.String, java.lang.Throwable)

вместо этого.

Записать сообщение, указав класс источника, метод и ресурсный набор, с ассоциированной информацией о Throwable.

Если логировщик в настоящее время включён для заданного уровня сообщения, то заданные аргументы сохраняются в записи журнала, которая передаётся всем зарегистрированным обработчикам вывода.

Параметры:: level - Один из идентификаторов уровня сообщения, например, SEVERE; sourceClass - имя класса, который запросил ведение журнала; sourceMethod - имя метода, который запросил ведение журнала; bundleName - имя ресурсного набора для локализации msg, может быть null; msg - Строковое сообщение (или ключ в каталоге сообщений); thrown - Throwable, связанный с сообщением журнала.

logrb

public void logrb(Level level, String sourceClass, String sourceMethod, ResourceBundle bundle, String msg, Throwable thrown)

Записывает сообщение, указав класс источника, метод и ресурсный пул, а также связанную информацию о Throwable.

Если для данного сообщения level в данный момент включён логгер, то указанные аргументы сохраняются в LogRecord, который передаётся всем зарегистрированным обработчикам вывода.

Строка msg локализуется с помощью данного ресурсного пула. Если ресурсный пул null, то строка msg не локализуется.

Обратите внимание, что аргумент thrown сохраняется в свойстве LogRecord thrown, а не в свойстве LogRecord parameters. Таким образом, он обрабатывается специально объектами вывода Formatter и не рассматривается как параметр форматирования для свойства LogRecord message.

Parameters:: level - Один из идентификаторов уровня сообщений, например, SEVERE; sourceClass - Имя класса, который выдал запрос логирования; sourceMethod - Имя метода, который выдал запрос логирования; bundle - Ресурсный пул для локализации msg, может быть null; msg - Строковое сообщение (или ключ в каталоге сообщений); thrown - Объект Throwable, связанный с сообщением журнала.
Since:: 1.8

logrb

public void logrb(Level level, ResourceBundle bundle, String msg, Throwable thrown)

Записывает сообщение, указав класс источника, метод и ресурсный пул, а также связанную информацию о Throwable.

Parameters:: level - Один из идентификаторов уровня сообщений, например, SEVERE; bundle - Ресурсный пул для локализации msg; может быть null.; msg - Строковое сообщение (или ключ в каталоге сообщений); thrown - Объект Throwable, связанный с сообщением журнала.
Since:: 9

entering

public void entering(String sourceClass, String sourceMethod)

Записывает вход в метод.

Это удобный метод, который можно использовать для записи входа в метод. В журнал записывается LogRecord с сообщением "ENTRY", уровнем лога FINER и заданным sourceMethod и sourceClass.

Parameters:: sourceClass - имя класса, который выдал запрос логирования; sourceMethod - имя метода, в который происходит вход

entering

public void entering(String sourceClass, String sourceMethod, Object param1)

Записывает вход в метод с одним параметром.

Это удобный метод, который можно использовать для записи входа в метод. В журнал записывается LogRecord с сообщением "ENTRY {0}", уровнем лога FINER, заданным sourceMethod, sourceClass и параметром.

Parameters:: sourceClass - имя класса, который выдал запрос логирования; sourceMethod - имя метода, в который происходит вход; param1 - параметр метода, в который происходит вход

entering

public void entering(String sourceClass, String sourceMethod, Object[] params)

Записывает вход в метод с массивом параметров.

Это удобный метод, который можно использовать для записи входа в метод. В журнал записывается LogRecord с сообщением "ENTRY" (за которым следует индикатор форматирования {N} для каждой записи в массиве параметров), уровнем лога FINER и заданным sourceMethod, sourceClass и параметрами.

Parameters:: sourceClass - имя класса, который выдал запрос логирования; sourceMethod - имя метода, в который происходит вход; params - массив параметров метода, в который происходит вход

exiting

public void exiting(String sourceClass, String sourceMethod)

Записывает выход из метода.

Это удобный метод, который можно использовать для записи выхода из метода. В журнал записывается LogRecord с сообщением "RETURN", уровнем лога FINER и заданным sourceMethod и sourceClass.

Parameters:: sourceClass - имя класса, который выдал запрос логирования; sourceMethod - имя метода

exiting

public void exiting(String sourceClass, String sourceMethod, Object result)

Записывает выход из метода с объектом результата.

Это удобный метод, который можно использовать для записи выхода из метода. В журнал записывается LogRecord с сообщением "RETURN {0}", уровнем лога FINER, заданным sourceMethod, sourceClass и объектом результата.

Parameters:: sourceClass - имя класса, который выдал запрос логирования; sourceMethod - имя метода; result - Возвращаемый объект

throwing

public void throwing(String sourceClass, String sourceMethod, Throwable thrown)

Запись выбрасывания исключения.

Это удобный метод для записи того, что метод завершается с выбрасыванием исключения. Логирование выполняется с уровнем FINER.

Если логгер в данный момент включён для заданного уровня сообщения, то указанные аргументы сохраняются в LogRecord, который передаётся всем зарегистрированным обработчикам вывода. Сообщение LogRecord устанавливается в "THROW".

Обратите внимание, что брошенный аргумент сохраняется в свойстве LogRecord thrown, а не в свойстве LogRecord parameters. Таким образом, он обрабатывается специально форматерами вывода и не рассматривается как параметр форматирования для свойства LogRecord message.

Parameters:: sourceClass - имя класса, который выдал запрос логирования; sourceMethod - имя метода.; thrown - Брошенное исключение Throwable.

severe

public void severe(String msg)

Запись сообщения SEVERE.

Если логгер в данный момент включён для уровня сообщения SEVERE, то указанное сообщение передаётся всем зарегистрированным объектам обработчика вывода.

Parameters:: msg - Строковое сообщение (или ключ в каталоге сообщений)

warning

public void warning(String msg)

Запись предупреждения WARNING.

Если логгер в данный момент включён для уровня сообщения WARNING, то указанное сообщение передаётся всем зарегистрированным объектам обработчика вывода.

Parameters:: msg - Строковое сообщение (или ключ в каталоге сообщений)

info

public void info(String msg)

Запись сообщения INFO.

Если логгер в данный момент включён для уровня сообщения INFO, то указанное сообщение передаётся всем зарегистрированным объектам обработчика вывода.

Parameters:: msg - Строковое сообщение (или ключ в каталоге сообщений)

config

public void config(String msg)

Запись сообщения CONFIG.

Если логгер в данный момент включён для уровня сообщения CONFIG, то указанное сообщение передаётся всем зарегистрированным объектам обработчика вывода.

Parameters:: msg - Строковое сообщение (или ключ в каталоге сообщений)

fine

public void fine(String msg)

Запись сообщения FINE.

Если логгер в данный момент включён для уровня сообщения FINE, то указанное сообщение передаётся всем зарегистрированным объектам обработчика вывода.

Parameters:: msg - Строковое сообщение (или ключ в каталоге сообщений)

finer

public void finer(String msg)

Запись сообщения FINER.

Если логгер в данный момент включён для уровня сообщения FINER, то указанное сообщение передаётся всем зарегистрированным объектам обработчика вывода.

Parameters:: msg - Строковое сообщение (или ключ в каталоге сообщений)

finest

public void finest(String msg)

Запись сообщения FINEST.

Если логгер в данный момент включён для уровня сообщения FINEST, то указанное сообщение передаётся всем зарегистрированным объектам обработчика вывода.

Parameters:: msg - Строковое сообщение (или ключ в каталоге сообщений)

severe

public void severe(Supplier<String> msgSupplier)

Записывает сообщение SEVERE, которое строится только в том случае, если уровень регистрации достаточен для того, чтобы сообщение действительно было записано.

Если для текущего регистратора включен уровень сообщения SEVERE, то сообщение строится путём вызова переданного поставщика функций и передаётся всем зарегистрированным обработчикам вывода.

Parameters:: msgSupplier - Функция, которая, при вызове, создаёт желаемое сообщение журнала
Since:: 1.8

warning

public void warning(Supplier<String> msgSupplier)

Записывает сообщение WARNING, которое строится только в том случае, если уровень регистрации достаточен для того, чтобы сообщение действительно было записано.

Если для текущего регистратора включен уровень сообщения WARNING, то сообщение строится путём вызова переданного поставщика функций и передаётся всем зарегистрированным обработчикам вывода.

Parameters:: msgSupplier - Функция, которая, при вызове, создаёт желаемое сообщение журнала
Since:: 1.8

info

public void info(Supplier<String> msgSupplier)

Записывает сообщение INFO, которое строится только в том случае, если уровень регистрации достаточен для того, чтобы сообщение действительно было записано.

Если для текущего регистратора включен уровень сообщения INFO, то сообщение строится путём вызова переданного поставщика функций и передаётся всем зарегистрированным обработчикам вывода.

Parameters:: msgSupplier - Функция, которая, при вызове, создаёт желаемое сообщение журнала
Since:: 1.8

config

public void config(Supplier<String> msgSupplier)

Записывает сообщение CONFIG, которое строится только в том случае, если уровень регистрации достаточен для того, чтобы сообщение действительно было записано.

Если для текущего регистратора включен уровень сообщения CONFIG, то сообщение строится путём вызова переданного поставщика функций и передаётся всем зарегистрированным обработчикам вывода.

Parameters:: msgSupplier - Функция, которая, при вызове, создаёт желаемое сообщение журнала
Since:: 1.8

fine

public void fine(Supplier<String> msgSupplier)

Записывает сообщение FINE, которое строится только в том случае, если уровень регистрации достаточен для того, чтобы сообщение действительно было записано.

Если для текущего регистратора включен уровень сообщения FINE, то сообщение строится путём вызова переданного поставщика функций и передаётся всем зарегистрированным обработчикам вывода.

Parameters:: msgSupplier - Функция, которая, при вызове, создаёт желаемое сообщение журнала
Since:: 1.8

finer

public void finer(Supplier<String> msgSupplier)

Записывает сообщение FINER, которое строится только в том случае, если уровень регистрации достаточен для того, чтобы сообщение действительно было записано.

Если для текущего регистратора включен уровень сообщения FINER, то сообщение строится путём вызова переданного поставщика функций и передаётся всем зарегистрированным обработчикам вывода.

Parameters:: msgSupplier - Функция, которая, при вызове, создаёт желаемое сообщение журнала
Since:: 1.8

finest

public void finest(Supplier<String> msgSupplier)

Записывает сообщение FINEST, которое строится только в том случае, если уровень регистрации достаточен для того, чтобы сообщение действительно было записано.

Если для текущего регистратора включен уровень сообщения FINEST, то сообщение строится путём вызова переданного поставщика функций и передаётся всем зарегистрированным обработчикам вывода.

Parameters:: msgSupplier - Функция, которая, при вызове, создаёт желаемое сообщение журнала
Since:: 1.8

setLevel

public void setLevel(Level newLevel)

Устанавливает уровень регистрации, определяя, какие уровни сообщений будут записываться этим регистратором. Уровни сообщений, которые ниже этого значения, будут отброшены. Значение уровня Level.OFF может быть использовано для отключения регистрации.

Если новое значение уровня равно null, это означает, что этот узел должен унаследовать свой уровень от ближайшего предка с заданным (не равным null) значением уровня.

Parameters:: newLevel - новое значение для уровня регистрации (может быть null)

getLevel

public Level getLevel()

Получает уровень регистрации, который был задан для этого регистратора. Результат может быть null, что означает, что эффективный уровень этого регистратора будет унаследован от родительского.

Returns:: уровень этого регистратора

isLoggable

public boolean isLoggable(Level level)

Проверяет, будет ли сообщение данного уровня действительно записано этим регистратором. Эта проверка основана на эффективном уровне регистратора, который может быть унаследован от родителя.

Parameters:: level - уровень регистрации сообщения
Returns:: true, если данный уровень сообщения в настоящее время регистрируется.

getName

public String getName()

Получает имя для этого регистратора.

Returns:: имя регистратора. Будет null для анонимных регистраторов.

addHandler

public void addHandler(Handler handler)

Добавляет обработчик регистрации для получения сообщений регистрации.

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

Parameters:: handler - обработчик регистрации

removeHandler

public void removeHandler(Handler handler)

Удаляет обработчик регистрации.

Возвращает без каких-либо действий, если заданный обработчик не найден или равен null

Parameters:: handler - обработчик регистрации

getHandlers

public Handler[] getHandlers()

Получает обработчики, связанные с этим регистратором.

Returns:: массив всех зарегистрированных обработчиков

setUseParentHandlers

public void setUseParentHandlers(boolean useParentHandlers)

Указывает, должен ли этот регистратор отправлять свой вывод в родительский регистратор. Это означает, что все записи журнала также будут записаны в обработчики родительского элемента и потенциально в его родительский элемент рекурсивно по всему пространству имён.

Parameters:: useParentHandlers - true, если вывод должен быть отправлен в родительский элемент регистратора.

getUseParentHandlers

public boolean getUseParentHandlers()

Определяет, отправляет ли этот регистратор свой вывод в родительский регистратор.

Returns:: true, если вывод должен быть отправлен в родительский элемент регистратора

setResourceBundle

public void setResourceBundle(ResourceBundle bundle)

Устанавливает пакет ресурсов для этого регистратора. Все сообщения будут регистрироваться с использованием заданного пакета ресурсов для его определенного locale.

Parameters:: bundle - Пакет ресурсов, который должен использоваться этим регистратором.
Throws:: NullPointerException - если заданный пакет ресурсов является null.; IllegalArgumentException - если у заданного пакета ресурсов нет имени базового пакета, или если для этого регистратора уже установлен пакет ресурсов, но заданный пакет имеет другое имя базового пакета.
Since:: 1.8

getParent

public Logger getParent()

Возвращает родительский элемент для этого регистратора.

Этот метод возвращает ближайшего существующего родителя в пространстве имён. Таким образом, если регистратор называется "a.b.c.d", а регистратор, названный "a.b", был создан, но регистратор "a.b.c" не существует, то вызов getParent для регистратора "a.b.c.d" вернёт регистратор "a.b".

Результатом будет null, если он вызван для корневого регистратора в пространстве имён.

Returns:: ближайший существующий родительский регистратор

setParent

public void setParent(Logger parent)

Устанавливает родительский элемент для этого регистратора. Этот метод используется LogManager для обновления регистратора при изменении пространства имён.

Его не следует вызывать из кода приложения.

Parameters:: parent - новый родительский регистратор

END_OF_DOCUMENT_MARKER

© 1993, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.logging/java/util/logging/Logger.html