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
削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。2つのAccessControlContext
オブジェクトの等価性をチェックします。削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。このAccessControlContext
に関連付けられたDomainCombiner
を取得します。int
hashCode()
削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。このコンテキストのハッシュ・コード値を返します。
-
コンストラクタの詳細
-
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
オブジェクトがあることを確認します。 -
hashCode
public int hashCode()削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。このコンテキストのハッシュ・コード値を返します。 ハッシュ・コードを計算するには、コンテキストにあるすべての保護領域のハッシュ・コードの排他的論理和を求めます。
-