Класс LogManager

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

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

Обратите внимание: поскольку недоверенный код может создавать регистраторы с произвольными именами, не следует полагаться на этот метод при поиске регистраторов для ведения журнала событий, связанных с безопасностью. Важно также учитывать, что объект Logger, связанный со строкой name, может быть собран сборщиком мусора в любой момент, если на Logger нет сильной ссылки. Вызывающий этот метод код должен проверять возвращаемое значение на 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. В противном случае оно будет пропущено.
Функции f может быть передано значение null, указывающее, что соответствующая конфигурация не содержит ключа конфигурации k. Функция f может вернуть null, чтобы указать, что в результирующей конфигурации со свойством k не будет связано никакое значение.

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

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

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

Примеры функций-сопоставителей:

• Заменить все свойства ведения журнала новой конфигурацией:
  
  (k) -> ((o, n) -> n):
  
  это эквивалентно передаче параметра mapper со значением null.
• Объединить новую и старую конфигурации и использовать новое значение, если 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)) после вызова всех слушателей.