compact1, compact2, compact3

java.util.logging

Класс FileHandler

java.lang. Объект

java.util.logging. Обработчик

java.util.logging. StreamHandler

java.util.logging. FileHandler

public class FileHandler
extends StreamHandler

Простой файл, регистрирующий Handler.

FileHandler может или записать в указанный файл, или он может записать во вращающийся набор файлов.

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

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

По умолчанию XMLFormatter class используется для того, чтобы отформатировать.

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

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

Например, свойства для 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" уникальное число, чтобы разрешить конфликты
• "%%" преобразовывает в единственный знак процента "%"

Если никакое "%g" поле не было определено, и количество файла больше чем один, то число генерации будет добавлено до конца сгенерированного имени файла после точки.

Таким образом например образец "%t/java%g.log" с количеством 2 обычно заставлял бы файлы журнала быть записанными на Солярисе /var/tmp/java0.log и /var/tmp/java1.log тогда как на Windows 95 они будут обычно писаться C:\TEMP\java0.log и C:\TEMP\java1.log

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

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

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

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

С тех пор:

1.4

Сводка конструктора

Конструкторы

Конструктор и Описание
FileHandler() Создайте значение по умолчанию FileHandler.
FileHandler(String pattern) Инициализируйте FileHandler, чтобы записать в данное имя файла.
FileHandler(String pattern, boolean append) Инициализируйте FileHandler, чтобы записать в данное имя файла, с дополнительным добавляют.
FileHandler(String pattern, int limit, int count) Инициализируйте FileHandler, чтобы записать в ряд файлов.
FileHandler(String pattern, int limit, int count, boolean append) Инициализируйте FileHandler, чтобы записать в ряд файлов с дополнительным, добавляют.

Сводка метода

Модификатор и Тип	Метод и Описание
void	close() Закройте все файлы.
void	publish(LogRecord record) Отформатируйте и опубликуйте LogRecord.

Методы, наследованные от class java.util.logging. StreamHandler

flush, isLoggable, setEncoding, setOutputStream

Методы, наследованные от class java.util.logging. Обработчик

getEncoding, getErrorManager, getFilter, getFormatter, getLevel, reportError, setErrorManager, setFilter, setFormatter, setLevel

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

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

Деталь конструктора

FileHandler

public FileHandler()
            throws IOException,
                   SecurityException

Создайте значение по умолчанию FileHandler. Это будет сконфигурировано полностью от свойств LogManager (или их значения по умолчанию).

Броски:

IOException - если есть проблемы IO, открывающие файлы.

SecurityException - если менеджер безопасности существует и если у вызывающей стороны нет LoggingPermission("control")).

NullPointerException - если свойство образца является пустой Строкой.

FileHandler

public FileHandler(String pattern)
            throws IOException,
                   SecurityException

Инициализируйте FileHandler, чтобы записать в данное имя файла.

FileHandler конфигурируется основанный на свойствах LogManager (или их значения по умолчанию) за исключением того, что данный параметр образца используется в качестве образца имени файла, предел файла не устанавливается ни к какому пределу, и количество файла устанавливается в одного.

Нет никакого предела на объеме данных, который может быть записан, так используйте это с заботой.

Параметры:

pattern - имя выходного файла

Броски:

IOException - если есть проблемы IO, открывающие файлы.

SecurityException - если менеджер безопасности существует и если у вызывающей стороны нет LoggingPermission("control").

IllegalArgumentException - если образец является пустой строкой

FileHandler

public FileHandler(String pattern,
                   boolean append)
            throws IOException,
                   SecurityException

Инициализируйте FileHandler, чтобы записать в данное имя файла, с дополнительным добавляют.

FileHandler конфигурируется основанный на свойствах LogManager (или их значения по умолчанию) за исключением того, что данный параметр образца используется в качестве образца имени файла, предел файла не устанавливается ни к какому пределу, количество файла устанавливается в одного, и добавлять режим устанавливается в данный параметр append.

Нет никакого предела на объеме данных, который может быть записан, так используйте это с заботой.

Параметры:

pattern - имя выходного файла

append - определяет добавляют режим

Броски:

IOException - если есть проблемы IO, открывающие файлы.

SecurityException - если менеджер безопасности существует и если у вызывающей стороны нет LoggingPermission("control").

IllegalArgumentException - если образец является пустой строкой

FileHandler

public FileHandler(String pattern,
                   int limit,
                   int count)
            throws IOException,
                   SecurityException

Инициализируйте FileHandler, чтобы записать в ряд файлов. Когда (приблизительно) данный предел был записан одному файлу, другой файл будет открыт. Вывод циклически повторится через ряд файлов количества.

FileHandler конфигурируется основанный на свойствах LogManager (или их значения по умолчанию) за исключением того, что данный параметр образца используется в качестве образца имени файла, предел файла устанавливается к предельному параметру, и количество файла устанавливается в данный параметр количества.

Количество должно быть по крайней мере 1.

Параметры:

pattern - образец для того, чтобы назвать выходной файл

limit - максимальное количество байтов, чтобы записать в любой файл

count - число файлов, чтобы использовать

Броски:

IOException - если есть проблемы IO, открывающие файлы.

SecurityException - если менеджер безопасности существует и если у вызывающей стороны нет LoggingPermission("control").

IllegalArgumentException - если предел < 0, or count < 1.

IllegalArgumentException - если образец является пустой строкой

FileHandler

public FileHandler(String pattern,
                   int limit,
                   int count,
                   boolean append)
            throws IOException,
                   SecurityException

Инициализируйте FileHandler, чтобы записать в ряд файлов с дополнительным, добавляют. Когда (приблизительно) данный предел был записан одному файлу, другой файл будет открыт. Вывод циклически повторится через ряд файлов количества.

FileHandler конфигурируется основанный на свойствах LogManager (или их значения по умолчанию) за исключением того, что данный параметр образца используется в качестве образца имени файла, предел файла устанавливается к предельному параметру, и количество файла устанавливается в данный параметр количества, и добавлять режим устанавливается в данный параметр append.

Количество должно быть по крайней мере 1.

Параметры:

pattern - образец для того, чтобы назвать выходной файл

limit - максимальное количество байтов, чтобы записать в любой файл

count - число файлов, чтобы использовать

append - определяет добавляют режим

Броски:

IOException - если есть проблемы IO, открывающие файлы.

SecurityException - если менеджер безопасности существует и если у вызывающей стороны нет LoggingPermission("control").

IllegalArgumentException - если предел < 0, or count < 1.

IllegalArgumentException - если образец является пустой строкой

Деталь метода

опубликовать

public void publish(LogRecord record)

Отформатируйте и опубликуйте LogRecord.

Переопределения:

publish в class StreamHandler

Параметры:

record - описание события журнала. Нулевая запись тихо игнорируется и не публикуется

близко

public void close()
           throws SecurityException

Закройте все файлы.

Переопределения:

close в class StreamHandler

Броски:

SecurityException - если менеджер безопасности существует и если у вызывающей стороны нет LoggingPermission("control").