FileHandler Класс

Ссылка

Определение

Пространство имен:: Java.Util.Logging

Сборка:: Mono.Android.dll

Важно!

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

Простое ведение журнала Handlerфайлов.

[Android.Runtime.Register("java/util/logging/FileHandler", DoNotGenerateAcw=true)]
public class FileHandler : Java.Util.Logging.StreamHandler

[<Android.Runtime.Register("java/util/logging/FileHandler", DoNotGenerateAcw=true)>]
type FileHandler = class
    inherit StreamHandler

Наследование: Object

Object

Handler

StreamHandler
FileHandler

Атрибуты: RegisterAttribute

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

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

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

<Конфигурация b:</b>> По умолчанию каждая из них FileHandler инициализирована с помощью следующих LogManager свойств конфигурации, где <handler-name> ссылается на полное имя класса обработчика. Если свойства не определены (или имеют недопустимые значения), используются указанные значения по умолчанию. <ul><li> < handler-name>. Уровень определяет уровень по умолчанию для Handler (по умолчанию Level.ALL— ). </li li><> < handler-name>. Фильтр задает имя используемого Filter класса (по умолчанию — нетFilter). </li li><> < handler-name>. formatter указывает имя класса, используемого Formatter (по умолчанию — <java.util.logging.XMLFormatter) /li li<>< handler-name>. кодирование имени кодировки набора символов для использования (по умолчанию используется кодировка платформы по умолчанию). </li li><> < handler-name>. ограничение указывает приблизительную максимальную сумму записи (в байтах) в любой файл. Если это равно нулю, то ограничения нет. (Значение по умолчанию не ограничивается). </li li><> < handler-name>. count указывает, сколько выходных файлов требуется циклически (по умолчанию — 1). </li li><> < handler-name>. Шаблон задает шаблон для создания имени выходного файла. Подробные сведения см. ниже. (По умолчанию используется значение "%h/java%u.log"). </li li><> < handler-name>. значение указывает, должен ли FileHandler добавляться к существующим файлам (по умолчанию — false). </li></ul>

Например, свойстваFileHandler: <ul><li> java.util.log.FileHandler.level=INFO /li<>> java.util.log.FileHandler.formatter=java.util.log.SimpleFormatter </li<>/ul <>

Для пользовательского обработчика e.g. com.foo.MyHandler свойства будут: ul>li com.foo.MyHandler.level=INFO </li><> com.foo.MyHandler.formatter=java.util.log.SimpleFormatter </li<>/ul><<>

Шаблон состоит из строки, включающей следующие специальные компоненты, которые будут заменены во время выполнения: <ul><li> "/" локальный разделитель <имени пути /li><li> "%t" системного временного каталога </li>>< li "%h" значение системного свойства </li.home /li<>li> "%g" числа поколения для различения поворачиваемых журналов </li "%u" уникального числа для разрешения конфликтов </<>>>><li li li "%%" преобразуется в знак "%" /li></ul>, если поле "%g" <не указано, а число файлов больше одного, то номер поколения будет добавлен в конец созданного имени файла после точки.

Таким образом, например шаблон "%t/java%g.log" с числом 2 обычно вызывает запись файлов журналов в Solaris в /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.

Документация по Java для java.util.logging.FileHandler.

Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.

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

FileHandler()	Создание по умолчанию `FileHandler`.
FileHandler(IntPtr, JniHandleOwnership)	Конструктор, используемый при создании управляемых представлений объектов JNI; вызывается средой выполнения.
FileHandler(String)	Инициализировать `FileHandler` запись в заданное имя файла.
FileHandler(String, Boolean)	Инициализирует `FileHandler` запись в заданное имя файла с необязательным добавлением.
FileHandler(String, Int32, Int32)	Инициализация `FileHandler` записи в набор файлов.
FileHandler(String, Int32, Int32, Boolean)	Инициализировать запись в набор файлов с необязательным `FileHandler` добавлением.

Свойства

Class	Возвращает класс среды выполнения этого `Object`объекта. (Унаследовано от Object)
Encoding	Возвращает кодировку символов для этого `Handler`. -или- Задайте кодировку символов, используемую этим `Handler`параметром. (Унаследовано от Handler)
ErrorManager	Извлекает ErrorManager для этого обработчика. -или- Определите errorManager для этого обработчика. (Унаследовано от Handler)
Filter	Получите текущий `Filter` для этого `Handler`. -или- Задайте для управления выходными `Filter` данными для этого `Handler`. (Унаследовано от Handler)
Formatter	`Formatter` Вернитесь для этого`Handler`. -или- Задайте значение `Formatter`. (Унаследовано от Handler)
Handle	Дескриптор базового экземпляра Android. (Унаследовано от Object)
JniIdentityHashCode	Простое ведение журнала `Handler`файлов. (Унаследовано от Object)
JniPeerMembers	Простое ведение журнала `Handler`файлов.
Level	Получите уровень журнала, указывающий, какие сообщения будут регистрироваться этим `Handler`. -или- Задайте уровень журнала, указывающий, какие уровни сообщений будут регистрироваться этим `Handler`параметром. (Унаследовано от Handler)
PeerReference	Простое ведение журнала `Handler`файлов. (Унаследовано от Object)
ThresholdClass	Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода.
ThresholdType	Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода.

Методы

Clone()	Создает и возвращает копию этого объекта. (Унаследовано от Object)
Close()	Закройте текущий выходной поток. (Унаследовано от StreamHandler)
Dispose()	Простое ведение журнала `Handler`файлов. (Унаследовано от Object)
Dispose(Boolean)	Простое ведение журнала `Handler`файлов. (Унаследовано от Object)
Equals(Object)	Указывает, равен ли другой объект этому объекту. (Унаследовано от Object)
Flush()	Очистка всех буферированных сообщений. (Унаследовано от StreamHandler)
GetHashCode()	Возвращает значение хэш-кода для объекта. (Унаследовано от Object)
IsLoggable(LogRecord)	Проверьте, будет ли это `Handler` на самом деле регистрируемым.`LogRecord` (Унаследовано от Handler)
JavaFinalize()	Вызывается сборщиком мусора в объекте, когда сборка мусора определяет, что больше ссылок на объект нет. (Унаследовано от Object)
Notify()	Пробуждение одного потока, ожидающего монитора этого объекта. (Унаследовано от Object)
NotifyAll()	Просыпает все потоки, ожидающие монитора этого объекта. (Унаследовано от Object)
Publish(LogRecord)	Форматирование `LogRecord`и публикация . (Унаследовано от StreamHandler)
ReportError(String, Exception, Int32)	Защищенный удобный метод для сообщения об ошибке в этом обработчике ErrorManager. (Унаследовано от Handler)
SetHandle(IntPtr, JniHandleOwnership)	Задает свойство Handle. (Унаследовано от Object)
SetOutputStream(Stream)	Измените выходной поток. (Унаследовано от StreamHandler)
ToArray<T>()	Простое ведение журнала `Handler`файлов. (Унаследовано от Object)
ToString()	Возвращает строковое представление объекта. (Унаследовано от Object)
UnregisterFromRuntime()	Простое ведение журнала `Handler`файлов. (Унаследовано от Object)
Wait()	Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, при <>помощи уведомления</em> или <эм>прерванного</em>. (Унаследовано от Object)
Wait(Int64)	Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, при <>получении уведомления</>em или <>эм прервано< или> до тех пор, пока не истекло определенное количество реального времени. (Унаследовано от Object)
Wait(Int64, Int32)	Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, при <>получении уведомления</>em или <>эм прервано< или> до тех пор, пока не истекло определенное количество реального времени. (Унаследовано от Object)

Явные реализации интерфейса

IJavaPeerable.Disposed()	Простое ведение журнала `Handler`файлов. (Унаследовано от Object)
IJavaPeerable.DisposeUnlessReferenced()	Простое ведение журнала `Handler`файлов. (Унаследовано от Object)
IJavaPeerable.Finalized()	Простое ведение журнала `Handler`файлов. (Унаследовано от Object)
IJavaPeerable.JniManagedPeerState	Простое ведение журнала `Handler`файлов. (Унаследовано от Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Простое ведение журнала `Handler`файлов. (Унаследовано от Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Простое ведение журнала `Handler`файлов. (Унаследовано от Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Простое ведение журнала `Handler`файлов. (Унаследовано от Object)

Методы расширения

JavaCast<TResult>(IJavaObject)	Выполняет преобразование типа, проверяемого средой выполнения Android.
JavaCast<TResult>(IJavaObject)	Простое ведение журнала `Handler`файлов.
GetJniTypeName(IJavaPeerable)	Простое ведение журнала `Handler`файлов.

Применяется к

Поделиться через