Класс FileHandler

Этот класс может записывать данные в указанный файл или в циклическую группу файлов.

При достижении заданного размера файла, он закрывается, и открывается новый файл. Более старые файлы получают имена, образуемые добавлением "0", "1", "2" и т.д. к имени базового файла.

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

По умолчанию используется класс XMLFormatter для форматирования.

Конфигурация: Каждый экземпляр класса FileHandler инициализируется по умолчанию с помощью следующих свойств конфигурации LogManager, где <handler-name> относится к полному имени класса обработчика. Если свойства не определены (или имеют недопустимые значения), используются значения по умолчанию.

• <имя-обработчика>.level задает уровень по умолчанию для Handler (по умолчанию Level.ALL).
• <имя-обработчика>.filter задает имя класса Filter для использования (по умолчанию нет Filter).
• <имя-обработчика>.formatter задает имя класса Formatter для использования (по умолчанию java.util.logging.XMLFormatter)
• <имя-обработчика>.encoding задает кодировку символов (по умолчанию — кодировка по умолчанию платформы).
• <имя-обработчика>.limit задает приблизительный максимальный размер файла в байтах. Если значение равно нулю, ограничений нет. (По умолчанию — без ограничений).
• <имя-обработчика>.count задает количество файлов для циклической обработки (по умолчанию 1).
• <имя-обработчика>.pattern задает шаблон для формирования имени файла. Подробнее см. ниже. (По умолчанию "%h/java%u.log").
• <имя-обработчика>.append указывает, нужно ли добавлять данные в существующие файлы (по умолчанию false).
• <имя-обработчика>.maxLocks задает максимальное количество одновременных блокировок, удерживаемых FileHandler (по умолчанию 100).

Например, свойства для FileHandler будут такими:

• java.util.logging.FileHandler.level=INFO
• java.util.logging.FileHandler.formatter=java.util.logging.SimpleFormatter

Для пользовательского обработчика, например com.foo.MyHandler, свойства будут:

• com.foo.MyHandler.level=INFO
• com.foo.MyHandler.formatter=java.util.logging.SimpleFormatter

Шаблон — это строка, содержащая следующие специальные компоненты, которые будут заменены во время выполнения:

• "/" — разделитель локального пути
• "%t" — временная директория системы
• "%h" — значение системной переменной "user.home"
• "%g" — номер генерации для различения ротируемых логов
• "%u" — уникальное число для разрешения конфликтов
• "%%" — заменяется на один символ процента "%"

Например, шаблон "%t/java%g.log" с количеством 2 обычно приведет к записи логов в /var/tmp/java0.log и /var/tmp/java1.log на Solaris и в C:\TEMP\java0.log и C:\TEMP\java1.log на Windows 95.

Номера генераций следуют последовательности 0, 1, 2 и т.д.

Обычно поле "%u" уникального идентификатора устанавливается в 0. Однако, если FileHandler пытается открыть файл и обнаруживает, что файл используется другим процессом, он увеличит поле уникального номера и повторит попытку. Это будет повторяться до тех пор, пока FileHandler не найдёт имя файла, не используемое в данный момент. Если есть конфликт и поле "%u" не задано, оно будет добавлено в конец имени файла после точки. (Это будет после любого автоматически добавленного номера генерации).

Например, если три процесса пытаются записать логи в fred%u.%g.txt, они могут получить fred0.0.txt, fred1.0.txt, fred2.0.txt как первые файлы в своих циклических последовательностях.

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