compact1, compact2, compact3

java.security

インタフェースDomainCombiner

既知のすべての実装クラス:

SubjectDomainCombiner

public interface DomainCombiner

DomainCombinerでは、動的に現行のAccessControlContextに関連したProtectionDomainsを変更する手段を提供します。

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

combineメソッドには引数が2つあります。第1引数は、現在実行中のThreadの、AccessController.doPrivilegedを最後に呼び出してからの、ProtectionDomainsの配列を表します。doPrivilegedの呼出しがない場合、第1引数には実行中のThreadからのすべてのProtectionDomainsが含まれます。第2引数は継承されたProtectionDomainsの配列を表します。この引数はnullの場合もあります。ProtectionDomainsは親Threadか、特権付きコンテキストから継承されます。doPrivilegedの呼出しがない場合、第2引数に親Threadから継承されたProtectionDomainsが含まれます。doPrivilegedが1回以上呼び出され、最新の呼出しがdoPrivileged(action, context)である場合は、第2引数に特権付きコンテキストからのProtectDomainsが含まれます。最新の呼出しが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

関連項目:

AccessController, AccessControlContext

メソッドのサマリー

修飾子と型	メソッドと説明
ProtectionDomain[]	combine(ProtectionDomain[] currentDomains, ProtectionDomain[] assignedDomains) 指定されたProtectionDomainsを変更または更新します。

メソッドの詳細

combine

ProtectionDomain[] combine(ProtectionDomain[] currentDomains,
                           ProtectionDomain[] assignedDomains)

指定されたProtectionDomainsを変更または更新します。ProtectionDomainsは、指定されたProtectionDomainsに追加されたり、削除されたりすることがあります。ProtectionDomainsはまた、再順序付けされることもあります。個別のProtectionDomainsの場合、Permissionsの新規セットなどを使って変更されることがあります。

パラメータ:

currentDomains - 現在の実行Threadに関連付けられたProtectionDomain (最新の特権付きProtectionDomainまで)。ProtectionDomainsは、最後に実行したProtectionDomainを配列の先頭にして、実行された順で列挙される。実行中のThreadにProtectionDomainが関連付けられていない場合、このパラメータはnullになる可能性がある。

assignedDomains - 継承されたProtectionDomainsの配列。ProtectionDomainsは親Threadか、特権付きAccessControlContextから継承されます。継承されたProtectionDomainが存在しない場合、このパラメータはnullになる可能性がある。

戻り値:

変更されたProtectionDomainで構成される新規配列、またはnull。