FileHandler クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
単純なファイル ログ記録 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- 継承
- 属性
注釈
単純なファイル ログ記録 Handler。
指定 FileHandler したファイルに書き込むか、回転する一連のファイルに書き込むことができます。
一連のファイルを回転する場合、各ファイルが特定のサイズ制限に達すると、ファイルは閉じられ、回転され、新しいファイルが開かれます。 後続の古いファイルは、ベース ファイル名に "0"、"1"、"2" などを追加することで名前が付けられます。
既定では、IO ライブラリではバッファリングが有効になっていますが、完了すると各ログ レコードがフラッシュされます。
既定では、 XMLFormatter クラスは書式設定に使用されます。
<b>構成:</b> 既定では、ハンドラーの完全修飾クラス名を参照する次LogManagerの構成プロパティ<handler-name>を使用して、それぞれFileHandlerが初期化されます。 プロパティが定義されていない (または無効な値がある) 場合は、指定された既定値が使用されます。 <ul><li> Handler 指定します (既定値は Level.ALLです)。 </li><li> Filter 指定します (既定値は no Filter)。 </li><li> Formatter名前を指定します (既定値は <java.util.logging.XMLFormatter)/li><li>
たとえば、プロパティFileHandlerは ul <<>li> java.util.logging.FileHandler.level=INFO </li li>>< java.util.logging.FileHandler.formatter=java.util.logging.SimpleFormatter </li></ul になります。>
カスタム ハンドラー e.g. com.foo.MyHandler の場合、プロパティは ul <><li> com.foo.MyHandler.level=INFO </li li><> com.foo.MyHandler.formatter=java.util.logging.SimpleFormatter </li></ul になります。>
パターンは、実行時<に置き換えられる次の特殊なコンポーネントを含む文字列で構成されます。ul<>li> "/" ローカル パス名区切り記号 </li li<>> "%t" システム一時ディレクトリ </li li<>> "%h" の値は、"user.home" システム プロパティ </li li><> "%g" の生成番号で、回転ログ </li><li> "%u" を区別して競合<を解決する一意の数値 /li li><>"%%" は単一パーセント記号 "%" </li></ul> に変換されます。"%g" フィールドが指定されておらず、ファイル数が 1 より大きい場合、生成されたファイル名の末尾に生成番号がドットの後に追加されます。
たとえば、カウントが 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" フィールドが指定されていない場合は、ファイル名の末尾にドットの後に追加されます。 (これは、自動的に追加された世代番号の後になります)。
したがって、3つのプロセスがすべてfred%u.%g.txtログに記録しようとした場合、fred0.0.txt、fred1.0.txt、fred2.0.txtをローテーションシーケンスの最初のファイルとして使用する可能性があります。
競合を回避するために一意の ID を使用することは、ローカル ディスク ファイル システムを使用する場合にのみ確実に動作することが保証されることに注意してください。
1.4 で追加されました。
の Java ドキュメントjava.util.logging.FileHandler
このページの一部は、Android オープンソース プロジェクトによって作成および共有され、クリエイティブ コモンズ 2.5 属性ライセンスに記載されている条件に従って使用される作業に基づく変更です。
コンストラクター
| FileHandler() |
既定値を作成します |
| FileHandler(IntPtr, JniHandleOwnership) |
JNI オブジェクトのマネージド表現を作成するときに使用されるコンストラクター。ランタイムによって呼び出されます。 |
| FileHandler(String) |
指定されたファイル名に書き込むには、a |
| FileHandler(String, Boolean) |
指定したファイル名に書き込むには、省略可能な追加を使用して a |
| FileHandler(String, Int32, Int32) |
一連のファイルに書き込むには、a |
| FileHandler(String, Int32, Int32, Boolean) |
省略可能な追加を使用して、一連のファイルに書き込む a |
プロパティ
| Class |
この |
| Encoding |
この |
| ErrorManager |
このハンドラーの ErrorManager を取得します。 または、このハンドラーの ErrorManager を定義します。 (継承元 Handler) |
| Filter |
これに |
| Formatter |
これを |
| Handle |
基になる Android インスタンスへのハンドル。 (継承元 Object) |
| JniIdentityHashCode |
単純なファイル ログ記録 |
| JniPeerMembers |
単純なファイル ログ記録 |
| Level |
これにより |
| PeerReference |
単純なファイル ログ記録 |
| ThresholdClass |
この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。 |
| ThresholdType |
この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。 |
メソッド
| Clone() |
このオブジェクトのコピーを作成して返します。 (継承元 Object) |
| Close() |
現在の出力ストリームを閉じます。 (継承元 StreamHandler) |
| Dispose() |
単純なファイル ログ記録 |
| Dispose(Boolean) |
単純なファイル ログ記録 |
| Equals(Object) |
他のオブジェクトがこのオブジェクトと "等しい" かどうかを示します。 (継承元 Object) |
| Flush() |
バッファー内のすべてのメッセージをフラッシュします。 (継承元 StreamHandler) |
| GetHashCode() |
オブジェクトのハッシュ コード値を返します。 (継承元 Object) |
| IsLoggable(LogRecord) |
これが |
| JavaFinalize() |
オブジェクトへの参照がなくなったとガベージ コレクションによって判断されたときに、オブジェクトのガベージ コレクターによって呼び出されます。 (継承元 Object) |
| Notify() |
このオブジェクトのモニターで待機している 1 つのスレッドを起動します。 (継承元 Object) |
| NotifyAll() |
このオブジェクトのモニターで待機しているすべてのスレッドを起動します。 (継承元 Object) |
| Publish(LogRecord) |
書式を設定して発行します |
| ReportError(String, Exception, Int32) |
このハンドラーの ErrorManager にエラーを報告する便利なメソッドを保護しました。 (継承元 Handler) |
| SetHandle(IntPtr, JniHandleOwnership) |
Handle プロパティを設定します。 (継承元 Object) |
| SetOutputStream(Stream) |
出力ストリームを変更します。 (継承元 StreamHandler) |
| ToArray<T>() |
単純なファイル ログ記録 |
| ToString() |
オブジェクトの文字列表現を返します。 (継承元 Object) |
| UnregisterFromRuntime() |
単純なファイル ログ記録 |
| Wait() |
現在のスレッドが目覚めるまで待機させます。通常<は、通知<>/em> または <em>割り込み/em> を受け<取ります。 (継承元 Object) |
| Wait(Int64) |
現在のスレッドが目覚めるまで待機します。通常<><は、通知/em> または <em>中断</em> によって、または一定のリアルタイムが経過するまで待機します。 (継承元 Object) |
| Wait(Int64, Int32) |
現在のスレッドが目覚めるまで待機します。通常<><は、通知/em> または <em>中断</em> によって、または一定のリアルタイムが経過するまで待機します。 (継承元 Object) |
明示的なインターフェイスの実装
| IJavaPeerable.Disposed() |
単純なファイル ログ記録 |
| IJavaPeerable.DisposeUnlessReferenced() |
単純なファイル ログ記録 |
| IJavaPeerable.Finalized() |
単純なファイル ログ記録 |
| IJavaPeerable.JniManagedPeerState |
単純なファイル ログ記録 |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
単純なファイル ログ記録 |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
単純なファイル ログ記録 |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
単純なファイル ログ記録 |
拡張メソッド
| JavaCast<TResult>(IJavaObject) |
Android ランタイムチェック型変換を実行します。 |
| JavaCast<TResult>(IJavaObject) |
単純なファイル ログ記録 |
| GetJniTypeName(IJavaPeerable) |
単純なファイル ログ記録 |