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>Configuration:</b> 既定では、各FileHandlerは、ハンドラーの完全修飾クラス名LogManager参照する次の<handler-name>構成プロパティを使用して初期化されます。 プロパティが定義されていない (または無効な値がある) 場合は、指定された既定値が使用されます。
たとえば、 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 で追加されました。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
コンストラクター
| 名前 | 説明 |
|---|---|
| FileHandler() |
既定の |
| FileHandler(IntPtr, JniHandleOwnership) |
JNI オブジェクトのマネージド表現を作成するときに使用されるコンストラクター。ランタイムによって呼び出されます。 |
| FileHandler(String, Boolean) |
指定したファイル名に書き込む |
| FileHandler(String, Int32, Int32, Boolean) |
オプションの追加を使用して一連のファイルに書き込む |
| FileHandler(String, Int32, Int32) |
一連のファイルに書き込む |
| FileHandler(String) |
指定したファイル名に書き込む |
プロパティ
| 名前 | 説明 |
|---|---|
| Class |
この |
| Encoding |
この |
| ErrorManager |
このハンドラーの ErrorManager を取得します。 または、このハンドラーの ErrorManager を定義します。 (継承元 Handler) |
| Filter |
この |
| Formatter |
この |
| Handle |
基になる Android インスタンスへのハンドル。 (継承元 Object) |
| JniIdentityHashCode |
相互運用ランタイムによってこのJava ピアに割り当てられた ID ハッシュ コードを取得します。 (継承元 Object) |
| JniManagedPeerState |
単純なファイル ログ記録 |
| JniPeerMembers |
このJava ピアのメンバーを呼び出すために使用される JNI メタデータを取得します。 |
| Level |
この |
| PeerReference |
このJava ピアの JNI オブジェクト参照を取得します。 (継承元 Object) |
| ThresholdClass |
この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。 |
| ThresholdType |
この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。 |
メソッド
| 名前 | 説明 |
|---|---|
| Clone() |
このオブジェクトのコピーを作成して返します。 (継承元 Object) |
| Close() |
現在の出力ストリームを閉じます。 (継承元 StreamHandler) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
単純なファイル ログ記録 |
| Dispose() |
このJava ピアによって保持されているリソースを解放します。 (継承元 Object) |
| Dispose(Boolean) |
このJava ピアによって保持されているリソースを解放します。 (継承元 Object) |
| DisposeUnlessReferenced() |
単純なファイル ログ記録 |
| Equals(Object) |
単純なファイル ログ記録 |
| 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) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
単純なファイル ログ記録 |
| ToArray<T>() |
このJava配列ラッパーからマネージド配列を作成します。 (継承元 Object) |
| ToString() |
オブジェクトの文字列形式を返します。 (継承元 Object) |
| UnregisterFromRuntime() |
相互運用ランタイムからこのJava ピアの登録を解除します。 (継承元 Object) |
| Wait() |
現在のスレッドが起動するまで待機します。通常は、 <em>notified</em> または <em>interrupted</em>。 (継承元 Object) |
| Wait(Int64, Int32) |
現在のスレッドは、通常、 <em>notified</em> または <em>interrupted</em>、または一定のリアルタイムが経過するまで、起動されるまで待機します。 (継承元 Object) |
| Wait(Int64) |
現在のスレッドは、通常、 <em>notified</em> または <em>interrupted</em>、または一定のリアルタイムが経過するまで、起動されるまで待機します。 (継承元 Object) |
明示的なインターフェイスの実装
| 名前 | 説明 |
|---|---|
| IJavaPeerable.Disposed() |
単純なファイル ログ記録 |
| IJavaPeerable.Finalized() |
単純なファイル ログ記録 |
| IJavaPeerable.JniObjectReferenceControlBlock |
単純なファイル ログ記録 |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
単純なファイル ログ記録 |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
単純なファイル ログ記録 |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
単純なファイル ログ記録 |
拡張メソッド
| 名前 | 説明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
インスタンス |
| JavaAs<TResult>(IJavaPeerable) |
|
| JavaCast<TResult>(IJavaObject) |
Android ランタイムチェック型変換を実行します。 |
| JavaCast<TResult>(IJavaObject) |
単純なファイル ログ記録 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
|