JavaTM 2 Platform
Standard Ed. 5.0

javax.security.auth
クラス SubjectDomainCombiner

java.lang.Object
  上位を拡張 javax.security.auth.SubjectDomainCombiner
すべての実装されたインタフェース:
DomainCombiner

public class SubjectDomainCombiner
extends Object
implements DomainCombiner

SubjectDomainCombiner は、この SubjectDomainCombiner に関連付けられた Subject の Principal を使用して、ProtectionDomain を更新します。


コンストラクタの概要
SubjectDomainCombiner(Subject subject)
          この SubjectDomainCombiner を、指定した Subject と関連付けます。
 
メソッドの概要
 ProtectionDomain[] combine(ProtectionDomain[] currentDomains, ProtectionDomain[] assignedDomains)
          この SubjectDomainCombiner に関連付けられた Subject の Principal を使用して、関連する ProtectionDomains を更新します。
 Subject getSubject()
          この SubjectDomainCombiner に関連付けられた Subject を取得します。
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

SubjectDomainCombiner

public SubjectDomainCombiner(Subject subject)
この SubjectDomainCombiner を、指定した Subject と関連付けます。

パラメータ:
subject - この SubjectDomainCombiner に関連付ける Subject
メソッドの詳細

getSubject

public Subject getSubject()
この SubjectDomainCombiner に関連付けられた Subject を取得します。

戻り値:
この SubjectDomainCombiner に関連付けられた Subject。この SubjectDomainCombiner に関連付けられた Subject が存在しない場合は null
例外:
SecurityException - 呼び出し側に、この SubjectDomainCombiner に関連付けられた Subject を取得するためのアクセス権がない場合

combine

public ProtectionDomain[] combine(ProtectionDomain[] currentDomains,
                                  ProtectionDomain[] assignedDomains)
この SubjectDomainCombiner に関連付けられた Subject の Principal を使用して、関連する ProtectionDomains を更新します。

新しい ProtectionDomain インスタンスが、currentDomains 配列の各 ProtectionDomain に対して作成されます。新しい ProtectionDomain インスタンスは、currentDomains 内の対応する ProtectionDomain から CodeSourcePermissionClassLoader、そして、この SubjectDomainCombiner に関連付けられた Subject から Principal を、それぞれ使用して作成されます。

新しくインスタンス化された ProtectionDomain は、すべて新しい配列に結合されます。assignedDomains 配列の ProtectionDomain がこの新しい配列に追加されて、結果が返されます。

重複する ProtectionDomain の削除などの最適化が行われる場合があります。また、ProtectionDomain のキャッシュを許可できます。

定義:
インタフェース DomainCombiner 内の combine
パラメータ:
currentDomains - 実行中の Thread に関連付けられた ProtectionDomain。最新の特権付き ProtectionDomain と一致する。ProtectionDomain は、最後に実行した ProtectionDomain を配列の先頭にして、実行順に列挙される。実行中の Thread が関連した ProtectionDomain を持たない場合、このパラメータは null の可能性がある

assignedDomains - 親 Thread から継承した ProtectionDomain。AccessController.doPrivileged(..., context) が呼び出された場合は、特権付きコンテキストの ProtectionDomain。親 Thread または優先されたコンテキストから継承した ProtectionDomain がない場合、このパラメータは null の可能性がある
戻り値:
変更された ProtectionDomain で構成される新規配列、または null

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。