Класс LogManager

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

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

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

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

Если задано системное свойство "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).
  
• Заменить все свойства новой конфигурацией, кроме свойства обработчика, которое задаёт обработчики Logger, не являющегося корневым регистратором:
  

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

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

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

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