モジュール java.base
パッケージ java.security

クラスAccessControlContext

java.lang.Object
java.security.AccessControlContext
@Deprecated(since="17", forRemoval=true) public final class AccessControlContext extends Object
非推奨、削除予定: このAPI要素は将来のバージョンで削除予定です。
このクラスは、非推奨であり、将来のリリースで削除される可能性があります。「セキュリティ・マネージャ」と組み合わせて使用すると便利です。 したがって、このクラスも非推奨となり、削除される可能性があります。 Security Managerまたはこのクラスの交換はありません。
AccessControlContextは、カプセル化されたコンテキストに基づいてシステム・リソースへのアクセスをディシジョンするために使用されます。

さらに具体的には、コンテキストをカプセル化し、AccessControllerクラスのcheckPermissionメソッドと同等の単一のメソッドcheckPermissionを持ちますが、1つの違いがあります: checkPermissionメソッドは、現在の実行スレッドではなく、カプセル化されたコンテキストに基づいてアクセスをディシジョンします。

したがって、AccessControlContextの目的は、特定のコンテキスト内で行うセキュリティ・チェックを、実際に「異なる」コンテキスト(たとえば、ワーカー・スレッド内から)内から実行する必要がある場合です。

AccessControlContextは、AccessController.getContextメソッドをコールして作成されます。 getContextメソッドは、現在の呼出し元のコンテキストの"スナップショット"を取得し、それを戻すAccessControlContextオブジェクトに配置します。 呼出しの例を次に示します。 

   AccessControlContext acc = AccessController.getContext()

別のコンテキスト内のコードは、その後、以前に保存されたAccessControlContextオブジェクトでcheckPermissionメソッドをコールできます。 呼出しの例を次に示します。 

   acc.checkPermission(permission)

導入されたバージョン:
1.2
関連項目:

  • コンストラクタのサマリー

    コンストラクタ
    コンストラクタ
    説明
    AccessControlContext(AccessControlContext acc, DomainCombiner combiner)
    非推奨、削除予定: このAPI要素は将来のバージョンで削除予定です。
    指定されたAccessControlContextおよびDomainCombinerを使って、新しいAccessControlContextを作成します。
    AccessControlContext(ProtectionDomain[] context)
    非推奨、削除予定: このAPI要素は将来のバージョンで削除予定です。
    指定されたProtectionDomainオブジェクトの配列を持つAccessControlContextを作成します。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    void
    checkPermission(Permission perm)
    非推奨、削除予定: このAPI要素は将来のバージョンで削除予定です。
    現在有効なセキュリティ・ポリシーとこのオブジェクトのコンテキストに基づいて、指定されたアクセス権によって示されるアクセス要求が許可されるか、拒否されるかを決定します。
    boolean
    equals(Object obj)
    非推奨、削除予定: このAPI要素は将来のバージョンで削除予定です。
    2つのAccessControlContextオブジェクトの等価性をチェックします。
    DomainCombiner
    getDomainCombiner()
    非推奨、削除予定: このAPI要素は将来のバージョンで削除予定です。
    このAccessControlContextに関連付けられたDomainCombinerを取得します。
    int
    hashCode()
    非推奨、削除予定: このAPI要素は将来のバージョンで削除予定です。
    このコンテキストのハッシュ・コード値を返します。

    クラスjava.lang.Objectで宣言されたメソッド

    clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

  • コンストラクタの詳細

    • AccessControlContext

      public AccessControlContext(ProtectionDomain[] context)
      非推奨、削除予定: このAPI要素は将来のバージョンで削除予定です。
      指定されたProtectionDomainオブジェクトの配列を持つAccessControlContextを作成します。 コンテキストはnullにできません。 重複した領域は、コンテキストから削除されます。
      パラメータ:
      context - このコンテキストに関連付けられているProtectionDomainオブジェクト。 重複しない領域が配列からコピーされる。 その後に配列を変更しても、このAccessControlContextには影響しません。
      例外:
      NullPointerException - contextがnullである場合

    • AccessControlContext

      public AccessControlContext(AccessControlContext acc, DomainCombiner combiner)
      非推奨、削除予定: このAPI要素は将来のバージョンで削除予定です。
      指定されたAccessControlContextおよびDomainCombinerを使って、新しいAccessControlContextを作成します。 このコンストラクタにより、DomainCombinerが、提供済みのAccessControlContextに関連付けられます。
      パラメータ:
      acc - 提供されたDomainCombinerに関連付けられたAccessControlContext。
      combiner - 提供されたAccessControlContextに関連付けられているDomainCombiner。
      例外:
      NullPointerException - 指定されたcontextがnullである場合。
      SecurityException - セキュリティ・マネージャがインストールされ、呼出し元が「createAccessControlContext」を持たない場合SecurityPermission
      導入されたバージョン:
      1.3

  • メソッドの詳細

    • getDomainCombiner

      public DomainCombiner getDomainCombiner()
      非推奨、削除予定: このAPI要素は将来のバージョンで削除予定です。
      このAccessControlContextに関連付けられたDomainCombinerを取得します。
      戻り値:
      このAccessControlContextに関連付けられているDomainCombiner。存在しない場合はnull。
      例外:
      SecurityException - セキュリティ・マネージャがインストールされ、呼出し元が「getDomainCombiner」を持たない場合SecurityPermission
      導入されたバージョン:
      1.3

    • checkPermission

      public void checkPermission(Permission perm) throws AccessControlException
      非推奨、削除予定: このAPI要素は将来のバージョンで削除予定です。
      現在有効なセキュリティ・ポリシーとこのオブジェクトのコンテキストに基づいて、指定されたアクセス権によって示されるアクセス要求が許可されるか、拒否されるかを決定します。 リクエストは、コンテキスト内のすべてのProtectionDomainが権限を示している場合にのみ許可されます。 そうでない場合、要求は拒否されます。

      このメソッドは、アクセス・リクエストが許可されている場合は静かに戻り、それ以外の場合は適切なAccessControlExceptionをスローします。

      パラメータ:
      perm - 要求されたアクセス権。
      例外:
      AccessControlException - 現在のセキュリティ・ポリシーと、このオブジェクトがカプセル化したコンテキストに基づいて、指定されたアクセス権が許可されない場合。
      NullPointerException - チェックする権限がnullの場合。

    • equals

      public boolean equals(Object obj)
      非推奨、削除予定: このAPI要素は将来のバージョンで削除予定です。
      2つのAccessControlContextオブジェクトの等価性をチェックします。 objがAccessControlContextであり、このコンテキストと同じセットのProtectionDomainオブジェクトがあることを確認します。
      オーバーライド:
      equals、クラスObject
      パラメータ:
      obj - このオブジェクトと等しいかどうかが判定されるオブジェクト。
      戻り値:
      objがAccessControlContextで、このコンテキストと同じProtectionDomainオブジェクトのセットを持つ場合はtrue、そうでない場合はfalse。
      関連項目:

    • hashCode

      public int hashCode()
      非推奨、削除予定: このAPI要素は将来のバージョンで削除予定です。
      このコンテキストのハッシュ・コード値を返します。 ハッシュ・コードを計算するには、コンテキストにあるすべての保護領域のハッシュ・コードの排他的論理和を求めます。
      オーバーライド:
      hashCode、クラスObject
      戻り値:
      このコンテキストのハッシュ・コード値。
      関連項目: