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を作成します。 -
メソッドのサマリー
修飾子と型メソッド説明voidcheckPermission(Permission perm) 削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。現在有効なセキュリティ・ポリシーとこのオブジェクトのコンテキストに基づいて、指定されたアクセス権によって示されるアクセス要求が許可されるか、拒否されるかを決定します。boolean削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。2つのAccessControlContextオブジェクトの等価性をチェックします。削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。このAccessControlContextに関連付けられたDomainCombinerを取得します。inthashCode()削除予定のため非推奨: この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
-