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

インタフェースDomainCombiner

既知のすべての実装クラス:
SubjectDomainCombiner
@Deprecated(since="17", forRemoval=true) public interface DomainCombiner
非推奨、削除予定: このAPI要素は将来のバージョンで削除予定です。
このクラスは、非推奨であり、将来のリリースで削除される可能性があります。「セキュリティ・マネージャ」と組み合わせて使用すると便利です。 したがって、このクラスも非推奨となり、削除される可能性があります。 Security Managerまたはこのクラスの交換はありません。
DomainCombinerでは、動的に現行のAccessControlContextに関連したProtectionDomainsを変更する手段を提供します。

DomainCombinerは、AccessControlContextの適切なコンストラクタにパラメータとして渡されます。 その後、新しく構築されたコンテキストがAccessController.doPrivileged(..., context)メソッドに渡され、指定されたコンテキスト(関連するDomainCombiner)が現在の実行スレッドとバインドされます。 その後、AccessController.getContextまたはAccessController.checkPermissionを呼び出すと、DomainCombiner.combineが呼び出されます。

combineメソッドには引数が2つあります。 最初の引数は、AccessController.doPrivilegedへの最新のコール以降、現在の実行スレッドからのProtectionDomainsの配列を表します。 doPrivilegedの呼出しが行われなかった場合、最初の引数には、現在の実行スレッドからのすべてのProtectionDomainsが含まれます。 第2引数は継承されたProtectionDomainsの配列を表します。この引数はnullの場合もあります。 ProtectionDomainsは、親スレッドまたは特権コンテキストから継承できます。 doPrivilegedの呼出しが行われなかった場合、2番目の引数には親スレッドから継承されたProtectionDomainsが含まれます。 doPrivilegedが1回以上呼び出され、最新の呼出しがdoPrivileged(action, context)である場合は、第2引数に特権付きコンテキストからのProtectionDomainsが含まれます。 最新の呼出しがdoPrivileged(action)である場合、特権付きコンテキストは存在せず、第2引数はnullになります。

combineメソッドでは、ProtectionDomainsの2通りの入力配列を調べ、変更されたProtectionDomainsを含む配置を1つ返します。 もっとも単純な場合、combineメソッドは、2つのスタックを1つに統合します。 複雑になると、combineメソッドは、ProtectionDomainsの変更済みスタックを返します。 変更には、新規ProtectionDomainsの追加、特定のProtectionDomainsの削除、または簡単に変更された既存のProtectionDomainsがあります。 ProtectionDomainsに対する再順序付けとその他の最適化もまた許可されます。 通常、combineメソッドは、DomainCombinerでカプセル化された情報に関するメソッドの変更を基にします。

AccessController.getContextメソッドは、組み合わされたProtectionDomainsのスタックをDomainCombinerから受け取ったあと、DomainCombinerと、組み合わされたProtectionDomainsの2つを持つ新規AccessControlContextを返します。

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

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    ProtectionDomain[]
    combine(ProtectionDomain[] currentDomains, ProtectionDomain[] assignedDomains)
    非推奨、削除予定: このAPI要素は将来のバージョンで削除予定です。
    指定されたProtectionDomainsを変更または更新します。

  • メソッドの詳細

    • combine

      ProtectionDomain[] combine(ProtectionDomain[] currentDomains, ProtectionDomain[] assignedDomains)
      非推奨、削除予定: このAPI要素は将来のバージョンで削除予定です。
      指定されたProtectionDomainsを変更または更新します。 ProtectionDomainsは、指定されたProtectionDomainsに追加されたり、削除されたりすることがあります。 ProtectionDomainsはまた、再順序付けされることもあります。 個別のProtectionDomainsの場合、Permissionsの新規セットなどを使って変更されることがあります。
      パラメータ:
      currentDomains - 現在の実行スレッドに関連付けられたProtectionDomains。最新の特権ProtectionDomainまで。 ProtectionDomainsは実行順にリストされ、最後に実行されたProtectionDomainは配列の先頭にあります。 現在の実行スレッドにProtectionDomainsが関連付けられていない場合、このパラメータはnullです。
      assignedDomains - 継承されたProtectionDomainsの配列。 ProtectionDomainsは、親スレッドまたは特権AccessControlContextから継承できます。 継承されたProtectionDomainが存在しない場合、このパラメータはnullになる可能性がある。
      戻り値:
      変更されたProtectionDomainで構成される新規配列、またはnull。