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

JavaObject

Object

Handler

StreamHandler
FileHandler

Атрибуты: RegisterAttribute

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

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

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

<Конфигурация b:>/b<> По умолчанию каждая из них FileHandler инициализирована с помощью следующих LogManager свойств конфигурации, где <handler-name> ссылается на полное имя класса обработчика. Если свойства не определены (или имеют недопустимые значения), используются указанные значения по умолчанию. ulli < handler-name>. Уровень определяет уровень по умолчанию для (по умолчанию — ). /li li < handler-name>. Фильтр задает имя используемого класса (по умолчанию — нет). /li li < handler-name>. formatter указывает имя класса, используемого (по умолчанию — ) /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>. append указывает, должен ли FileHandler добавляться к существующим файлам (по умолчанию — false). </li></ul>

Например, свойстваFileHandler: <ul><li> java.util.logging.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 "%h" значение системного свойства >/user.home" /li<>li< "%g" номер поколения, чтобы различать поворачиваемые журналы >/li<>< "%u" уникальный номер для разрешения конфликтов >/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" не указано, оно будет добавлено в конце имени файла после точки. (Это будет после любого автоматически добавленного номера поколения.)

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

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

Добавлено в версии 1.4.

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

Части этой страницы — это изменения на основе работы, созданной и общей Project и используемых в соответствии с условиями, описанными в разделе "".

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

Имя.	Описание
FileHandler()	Создание по умолчанию `FileHandler`.
FileHandler(IntPtr, JniHandleOwnership)	Конструктор, используемый при создании управляемых представлений объектов JNI; вызывается средой выполнения.
FileHandler(String, Boolean)	Инициализирует `FileHandler` запись в заданное имя файла с необязательным добавлением.
FileHandler(String, Int32, Int32, Boolean)	Инициализировать запись в набор файлов с необязательным `FileHandler` добавлением.
FileHandler(String, Int32, Int32)	Инициализация `FileHandler` записи в набор файлов.
FileHandler(String)	Инициализировать `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	Возвращает хэш-код удостоверения, назначенный этому Java одноранговой среде выполнения взаимодействия. (Унаследовано от Object)
JniManagedPeerState	Простое ведение журнала `Handler`файлов. (Унаследовано от JavaObject)
JniPeerMembers	Возвращает метаданные JNI, используемые для вызова элементов этого Java однорангового узла.
Level	Получите уровень журнала, указывающий, какие сообщения будут регистрироваться этим `Handler`. -или- Задайте уровень журнала, указывающий, какие уровни сообщений будут регистрироваться этим `Handler`параметром. (Унаследовано от Handler)
PeerReference	Возвращает ссылку на объект JNI для этого Java однорангового узла. (Унаследовано от Object)
ThresholdClass	Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода.
ThresholdType	Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода.

Методы

Имя.	Описание
Clone()	Создает и возвращает копию этого объекта. (Унаследовано от Object)
Close()	Закройте текущий выходной поток. (Унаследовано от StreamHandler)
Construct(JniObjectReference, JniObjectReferenceOptions)	Простое ведение журнала `Handler`файлов. (Унаследовано от JavaObject)
Dispose()	Освобождает ресурсы, удерживаемые этим Java одноранговым узлом. (Унаследовано от Object)
Dispose(Boolean)	Освобождает ресурсы, удерживаемые этим Java одноранговым узлом. (Унаследовано от Object)
DisposeUnlessReferenced()	Простое ведение журнала `Handler`файлов. (Унаследовано от JavaObject)
Equals(Object)	Простое ведение журнала `Handler`файлов. (Унаследовано от JavaObject)
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)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	Простое ведение журнала `Handler`файлов. (Унаследовано от JavaObject)
ToArray<T>()	Создает управляемый массив из этого Java оболочки массива. (Унаследовано от Object)
ToString()	Возвращает строковое представление объекта. (Унаследовано от Object)
UnregisterFromRuntime()	Отменяет регистрацию этого Java однорангового узла из среды выполнения взаимодействия. (Унаследовано от Object)
Wait()	Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, путем <><уведомления/>em или <эм>прерванного</em.> (Унаследовано от Object)
Wait(Int64, Int32)	Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, при <>получении уведомления</>em или <>эм прерваны< или> до тех пор, пока не истекло определенное количество реального времени. (Унаследовано от Object)
Wait(Int64)	Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, при <>получении уведомления</>em или <>эм прерваны< или> до тех пор, пока не истекло определенное количество реального времени. (Унаследовано от Object)

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

Имя.	Описание
IJavaPeerable.Disposed()	Простое ведение журнала `Handler`файлов. (Унаследовано от JavaObject)
IJavaPeerable.Finalized()	Простое ведение журнала `Handler`файлов. (Унаследовано от JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	Простое ведение журнала `Handler`файлов. (Унаследовано от JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Простое ведение журнала `Handler`файлов. (Унаследовано от JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Простое ведение журнала `Handler`файлов. (Унаследовано от JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	Простое ведение журнала `Handler`файлов. (Унаследовано от JavaObject)

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

Имя.	Описание
GetJniTypeName(IJavaPeerable)	Возвращает имя JNI типа экземпляра `self`.
JavaAs<TResult>(IJavaPeerable)	Попробуйте принуждать к типу`self`, проверяя`TResult`, является ли приведение допустимым на стороне Java.
JavaCast<TResult>(IJavaObject)	Выполняет преобразование типа, проверяемого средой выполнения Android.
JavaCast<TResult>(IJavaObject)	Простое ведение журнала `Handler`файлов.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Попробуйте принуждать к типу`self`, проверяя`TResult`, является ли приведение допустимым на стороне Java.

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