Класс LogManager

Методы фабрики Logger вызывают этот метод для регистрации каждого вновь созданного Logger.

Приложение должно сохранять собственную ссылку на объект Logger, чтобы избежать его сборки мусора. LogManager может хранить только слабую ссылку.

Обратите внимание, что так как небезопасный код может создавать логирующие объекты с произвольными именами, данный метод не должен использоваться для поиска логирующих объектов в целях безопасности. Также важно отметить, что объект Logger, связанный со строкой name, может быть собран мусором в любое время, если на него нет сильной ссылки. Вызывающий метод должен проверять возвращаемое значение на null, чтобы правильно обрабатывать случай, когда Logger был собран мусором.

Примечание: Логирующие объекты могут быть добавлены динамически по мере загрузки новых классов. Этот метод сообщает только о зарегистрированных в данный момент логирующих объектах. Также важно отметить, что этот метод возвращает только имя Logger, а не сильную ссылку на сам Logger. Возвращаемая строка ничего не делает для предотвращения сборки мусора Logger. В частности, если возвращённое имя передано в LogManager.getLogger(), то вызывающий метод должен проверить возвращаемое значение из LogManager.getLogger() на null, чтобы правильно обработать случай, когда Logger был собран мусором за время с момента возврата его имени этим методом.

Если системная переменная "java.util.logging.config.class" установлена, то её значение рассматривается как имя класса. Заданный класс будет загружен, объект будет создан, и конструктор этого объекта отвечает за чтение начальной конфигурации. (Этот объект может использовать другие системные переменные для управления своей конфигурацией.) Альтернативный класс конфигурации может использовать readConfiguration(InputStream) для определения свойств в LogManager.

Если системная переменная "java.util.logging.config.class" не установлена, то этот метод прочитает начальную конфигурацию из файла свойств и вызовет метод readConfiguration(InputStream) для инициализации конфигурации. Системная переменная "java.util.logging.config.file" может быть использована для указания файла свойств, который будет прочитан как начальная конфигурация; если она не установлена, используется конфигурация по умолчанию LogManager. Конфигурация по умолчанию обычно загружается из файла свойств "conf/logging.properties" в каталоге установки Java.

Любой зарегистрированный слушатель конфигурации будет вызван после прочтения свойств.

Для всех именованных логгеров операция сброса удаляет и закрывает все обработчики и (кроме корневого логгера) устанавливает уровень на null. Уровень корневого логгера устанавливается на Level.INFO.

Любой зарегистрированный слушатель конфигурации будет вызван после прочтения свойств.

Если системная переменная "java.util.logging.config.file" установлена, то её значение указывает на файл свойств, который будет считаться новой конфигурацией. В противном случае используется конфигурация по умолчанию LogManager.
Конфигурация по умолчанию обычно загружается из файла свойств "conf/logging.properties" в каталоге установки Java.

Этот метод считывает новую конфигурацию и вызывает метод updateConfiguration(ins, mapper) для обновления конфигурации.

Для каждого ключа конфигурации в существующей конфигурации и заданном потоке конфигурации, заданная mapper функция вызывается для отображения ключа конфигурации на функцию, f(o,n), которая принимает старое и новое значения и возвращает результирующее значение для применения в результирующей конфигурации, как указано в таблице ниже.

Пусть k — ключ конфигурации в старой или новой конфигурации, o — старое значение (т. е. значение, связанное с k в старой конфигурации), n — новое значение (т. е. значение, связанное с k в новой конфигурации), и f — функция, возвращаемая mapper.apply(k): тогда v = f(o,n) — результирующее значение. Если v не null, то свойство k со значением v будет добавлено в результирующую конфигурацию. В противном случае оно будет опущено.
Значение null может быть передано функции f для указания того, что соответствующая конфигурация не имеет ключа конфигурации k. Функция f может вернуть null, чтобы указать, что в результирующей конфигурации не будет значения, связанного с k.

Если mapper равно null, то v будет установлено в n.

Свойства LogManager свойства обновляются с результирующим значением в результирующей конфигурации.

Зарегистрированные слушатели конфигурации будут вызваны после успешного обновления конфигурации.

Примеры функций-отображений:

• Заменить все свойства регистрации новой конфигурацией:
  
  (k) -> ((o, n) -> n):
  
  Это эквивалентно передаче нулевого mapper параметра.
• Объединить новую конфигурацию и старую конфигурацию и использовать новое значение, если k существует в новой конфигурации:
  
  (k) -> ((o, n) -> n == null ? o : n):
  
  как если бы объединялись две коллекции следующим образом: result.putAll(oldc); result.putAll(newc).
  
• Объединить новую конфигурацию и старую конфигурацию и использовать старое значение, если k существует в старой конфигурации:
  
  (k) -> ((o, n) -> o == null ? n : o):
  
  как если бы объединялись две коллекции следующим образом: result.putAll(newc); result.putAll(oldc).
  
• Заменить все свойства новой конфигурацией, за исключением свойства обработчика для настройки обработчика Логгера, который не является корневым логгером:
  

  (k) -> k.endsWith(".handlers")
            ? ((o, n) -> (o == null ? n : o))
            : ((o, n) -> n)

Для полной повторной инициализации конфигурации приложение может сначала вызвать reset, чтобы полностью удалить старую конфигурацию, а затем updateConfiguration для инициализации новой конфигурации.

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

Рекомендуется, чтобы слушатели не генерировали ошибки или исключения. Если слушатель завершается с непредвиденной ошибкой или исключением, первое исключение будет передано вызывающему методу readConfiguration() (или readConfiguration(java.io.InputStream)) после того, как все слушатели будут вызваны.