CloseGuard クラス

定義

[Android.Runtime.Register("android/util/CloseGuard", ApiSince=30, DoNotGenerateAcw=true)]
public sealed class CloseGuard : Java.Lang.Object

[<Android.Runtime.Register("android/util/CloseGuard", ApiSince=30, DoNotGenerateAcw=true)>]
type CloseGuard = class
    inherit Object

継承

Object

Object

CloseGuard

属性

RegisterAttribute

注釈

CloseGuard は、明示的な close メソッド (Effective Java の "明示的な終了メソッド" とも呼ばれる) によってクリーンアップする必要があるリソースの暗黙的なファイナライザー クリーンアップにフラグを設定するためのメカニズムです。

簡単な例:

{@code
              class Foo {

                  private final CloseGuard guard = new CloseGuard();

                  ...

                  public Foo() {
                      ...;
                      guard.open("cleanup");
                  }

                  public void cleanup() {
                     guard.close();
                     ...;
                     if (Build.VERSION.SDK_INT >= 28) {
                         Reference.reachabilityFence(this);
                     }
                     // For full correctness in the absence of a close() call, other methods may also need
                     // reachabilityFence() calls.
                  }

                  protected void finalize() throws Throwable {
                      try {
                          // Note that guard could be null if the constructor threw.
                          if (guard != null) {
                              guard.warnIfOpen();
                          }
                          cleanup();
                      } finally {
                          super.finalize();
                      }
                  }
              }
            }

明示的にクリーンアップするリソースがオブジェクトの構築後に割り当てられる使用では、CloseGuard 保護を遅延させることができます。 例えば次が挙げられます。

{@code
              class Bar {

                  private final CloseGuard guard = new CloseGuard();

                  ...

                  public Bar() {
                      ...;
                  }

                  public void connect() {
                     ...;
                     guard.open("cleanup");
                  }

                  public void cleanup() {
                     guard.close();
                     ...;
                     if (Build.VERSION.SDK_INT >= 28) {
                         Reference.reachabilityFence(this);
                     }
                     // For full correctness in the absence of a close() call, other methods may also need
                     // reachabilityFence() calls.
                  }

                  protected void finalize() throws Throwable {
                      try {
                          // Note that guard could be null if the constructor threw.
                          if (guard != null) {
                              guard.warnIfOpen();
                          }
                          cleanup();
                      } finally {
                          super.finalize();
                      }
                  }
              }
            }

コンストラクターで使用する場合、コンストラクターの突然の終了を引き起こす例外は、ユーザーが明示的にクリーンアップするオブジェクトへの参照を持たないことを意味するため、 open の呼び出しはコンストラクターの末尾で発生する必要があります。 メソッドで使用する場合、 open の呼び出しは、リソースの取得直後に行われる必要があります。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。