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

注解

简单文件日志记录 Handler。

可以 FileHandler 写入指定文件，也可以写入旋转的文件集。

对于一组旋转的文件，由于每个文件达到给定的大小限制，它将关闭、旋转和打开一个新文件。 依次将“0”、“1”、“2”等添加到基文件名中来命名旧文件。

默认情况下，在 IO 库中启用缓冲，但完成时会刷新每个日志记录。

默认情况下，该 XMLFormatter 类用于格式设置。

<b>Configuration：</b> 默认情况下，每个 FileHandler 配置属性都使用以下 LogManager 配置属性进行初始化，其中 <handler-name> 引用处理程序的完全限定类名。 如果未定义属性（或具有无效值），则使用指定的默认值。 <ul><li> Level.ALL） 的默认级别Handler。 </li li><> Filter（默认值为 noFilter）。 </li li><> Formatter （默认值为 java.util.logging.XMLFormatter） </li li<>>

例如，其属性为：<ul<>li> java.util.logging.FileHandler.level=INFO </li li<>> java.util.logging.FileHandler.formatter=java.util.logging.SimpleFormatter </li></ul FileHandler>

对于自定义处理程序，e.g. com.foo.MyHandler，属性为：ul>li com.foo.MyHandler.level=INFO </li><> com.foo.MyHandler.formatter=java.util.logging.SimpleFormatter </li<>/ul><<>

模式包含一个字符串，其中包含将在运行时替换的以下特殊组件：ul>li “/” local pathname separator </li “%t” the system temporary directory </li>><<>> “%h” the value of the “user.home” system property </li<>> li “%g” the generation number to distinguished logs </li “%u” a unique number to resolves /li li li “%u” a unique number to resolves </li>>< li li>><><<“%%”转换为单一百分比符号“%”</li></ul> 如果尚未指定“%g”字段，并且文件计数大于一个，则生成号将添加到生成的文件名的末尾（在点之后）。

因此，例如，计数为 2 的“%t/java%g.log”模式通常会导致日志文件在 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作为其旋转序列中的第一个文件。

请注意，仅当使用本地磁盘文件系统时，才保证使用唯一 ID 来避免冲突。

在 1.4 中添加。

适用于 . 的 java.util.logging.FileHandlerJava 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改，并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

构造函数

FileHandler()	构造默认值 FileHandler。
FileHandler(IntPtr, JniHandleOwnership)	创建 JNI 对象的托管表示形式时使用的构造函数;由运行时调用。
FileHandler(String)	初始化要写入给定文件名的 A FileHandler 。
FileHandler(String, Boolean)	使用可选追加初始化要写入给定文件名的 A FileHandler 。
FileHandler(String, Int32, Int32)	初始化要写入到一组文件的 A FileHandler 。
FileHandler(String, Int32, Int32, Boolean)	FileHandler使用可选追加初始化要写入到一组文件。

属性

Class	返回此 Object的运行时类。 (继承自 Object)
Encoding	返回此 Handler字符的字符编码。 - 或 - 设置由此 Handler使用的字符编码。 (继承自 Handler)
ErrorManager	检索此处理程序的 ErrorManager。 - 或 - 为此处理程序定义 ErrorManager。 (继承自 Handler)
Filter	获取此Handler对象的当前Filter值。 - 或 - 设置控件 Filter 的 Handler输出。 (继承自 Handler)
Formatter	返回此Handler值Formatter。 - 或 - 设置一个 Formatter。 (继承自 Handler)
Handle	基础 Android 实例的句柄。 (继承自 Object)
JniIdentityHashCode	简单文件日志记录 Handler。 (继承自 Object)
JniPeerMembers	简单文件日志记录 Handler。
Level	获取日志级别，指定将记录哪些消息。Handler - 或 - 设置日志级别，指定此记录 Handler的消息级别。 (继承自 Handler)
PeerReference	简单文件日志记录 Handler。 (继承自 Object)
ThresholdClass	此 API 支持 Mono for Android 基础结构，不打算直接从代码使用。
ThresholdType	此 API 支持 Mono for 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> 或 <em>interrupted</em>。<>< (继承自 Object)
Wait(Int64)	使当前线程等待直到唤醒，通常是通过 <em>通知</em> 或 <em interrupted</em>>，或直到经过一定数量的实时。 (继承自 Object)
Wait(Int64, Int32)	使当前线程等待直到唤醒，通常是通过 <em>通知</em> 或 <em interrupted</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。