FileHandler (Платформа Java SE 7)

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

Методы java.util.logging унаследованный от класса. StreamHandler
flush, isLoggable, setEncoding, setOutputStream

Методы java.util.logging унаследованный от класса. Обработчик
getEncoding, getErrorManager, getFilter, getFormatter, getLevel, reportError, setErrorManager, setFilter, setFormatter, setLevel

Методы 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 в классе StreamHandler
    
    Параметры:
    record - описание события журнала. Нулевая запись тихо игнорируется и не публикуется
  - близко
```
public void close()
           throws SecurityException
```
    Закройте все файлы.
    
    Переопределения:
    
    close в классе StreamHandler
    
    Броски:
    
    SecurityException - если менеджер безопасности существует и если у вызывающей стороны нет LoggingPermission("control").

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс FileHandler

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

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

Методы java.util.logging унаследованный от класса. StreamHandler

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

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

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

FileHandler

FileHandler

FileHandler

FileHandler

FileHandler

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

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

близко