compact1, compact2, compact3

java.security

クラスProtectionDomain

java.lang.Object

java.security.ProtectionDomain

public class ProtectionDomain
extends Object

ProtectionDomainクラスは、ドメインの属性をカプセル化し、与えられたPrincipalのセットの代わりに実行される場合に、そのインスタンスに対してアクセス権のセットが与えられるクラスのセットを含みます。

アクセス権の静的セットは、構築されたときにProtectionDomainにバインドされています。そのようなアクセス権は、Policyに関係なくすべてドメインに与えられています。しかし、動的なセキュリティ・ポリシーをサポートするには、アクセス権を確認するときは常に現在のPolicyによってアクセス権のセットに動的にマップされているようにProtectionDomainも構築します。

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
ProtectionDomain(CodeSource codesource, PermissionCollection permissions) 指定されたCodeSourceとPermissionsで新規ProtectionDomainを作成します。
ProtectionDomain(CodeSource codesource, PermissionCollection permissions, ClassLoader classloader, Principal[] principals) 指定されたCodeSource、Permissions、ClassLoader、およびPrincipals配列で新規ProtectionDomainを作成します。

メソッドのサマリー

修飾子と型	メソッドと説明
ClassLoader	getClassLoader() このドメインのClassLoaderを返します。
CodeSource	getCodeSource() このドメインのCodeSourceを返します。
PermissionCollection	getPermissions() このドメインに与えられた静的アクセス権を返します。
Principal[]	getPrincipals() このドメインの主体の配列を返します。
boolean	implies(Permission permission) このProtectionDomainが、Permissionオブジェクトで表現されるアクセス権を包含するかどうかを判定します。
String	toString() ProtectionDomainをStringに変換します。

クラス java.lang.Objectから継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

コンストラクタの詳細

ProtectionDomain

public ProtectionDomain(CodeSource codesource,
                        PermissionCollection permissions)

指定されたCodeSourceとPermissionsで新規ProtectionDomainを作成します。アクセス権オブジェクトがnullでない場合、setReadOnly())が渡されたPermissionsオブジェクトで呼び出されます。このドメインに許可されるのは指定されたアクセス権だけであり、現在のポリシーは調べられません。

パラメータ:

codesource - このドメインに関連したコード・ソース

permissions - このドメインに与えられたアクセス権

ProtectionDomain

public ProtectionDomain(CodeSource codesource,
                        PermissionCollection permissions,
                        ClassLoader classloader,
                        Principal[] principals)

指定されたCodeSource、Permissions、ClassLoader、およびPrincipals配列で新規ProtectionDomainを作成します。アクセス権オブジェクトがnullでない場合、setReadOnly()が渡されたPermissionsオブジェクトで呼び出されます。このドメインに許可されたアクセス権は動的です。コンストラクタに渡された静的アクセス権と、アクセス権を確認するときの現在のポリシーによって許可されるアクセス権との両方が含まれます。

通常、このコンストラクタはClassLoadersとDomainCombinersによって使用されます。ClassLoaderとDomainCombinerは、このドメインに許可されたアクセス権にアクティブに関連付けるためにPolicyに委譲されます。このコンストラクタでは、ポリシーの変更を反映する指定されたPermissionCollectionを拡張するため、Policyプロバイダに機会を提供します。

パラメータ:

codesource - このドメインに関連したCodeSource

permissions - このドメインに与えられたアクセス権

classloader - このドメインに関連したClassLoader

principals - このドメインに関連付けられたPrincipalの配列。この配列の内容は、後続の変更に影響されないようにコピーされる。

導入されたバージョン:

1.4

関連項目:

Policy.refresh(), Policy.getPermissions(ProtectionDomain)

メソッドの詳細

getCodeSource

public final CodeSource getCodeSource()

このドメインのCodeSourceを返します。

戻り値:

このドメインのCodeSource。nullになることもある。

導入されたバージョン:

1.2

getClassLoader

public final ClassLoader getClassLoader()

このドメインのClassLoaderを返します。

戻り値:

このドメインのClassLoader。nullになることもある。

導入されたバージョン:

1.4

getPrincipals

public final Principal[] getPrincipals()

このドメインの主体の配列を返します。

戻り値:

このドメインに対するnullでない原則の配列。このメソッドが呼び出されるたびに新しい配列を返す。

導入されたバージョン:

1.4

getPermissions

public final PermissionCollection getPermissions()

このドメインに与えられた静的アクセス権を返します。

戻り値:

このドメインのアクセス権の静的セット。nullになることもある。

関連項目:

Policy.refresh(), Policy.getPermissions(ProtectionDomain)

implies

public boolean implies(Permission permission)

このProtectionDomainが、Permissionオブジェクトで表現されるアクセス権を包含するかどうかを判定します。

評価されるアクセス権のセットは、ProtectionDomainがアクセス権の静的セットで構築されたか、あるいは動的にマップされたアクセス権のセットにバインドされているかによって変わります。

ProtectionDomainが静的にバインドされた(statically bound) PermissionCollectionによって構築された場合、構築時に提供されたPermissionCollectionに対してアクセス権が確認されるだけです。

しかし、動的にバインドしている(dynamically binding)アクセス権をサポートするコンストラクタ・バリアントでProtectionDomainが構築されている場合、構築時に提供されたPermissionCollectionと現在のPolicy割り当てとの組み合わせに対してもアクセス権が確認されます。

パラメータ:

permission - チェック対象のPermissionオブジェクト。

戻り値:

アクセス権がこのProtectionDomainで暗黙的に許可されている場合はtrue。

toString

public String toString()

ProtectionDomainをStringに変換します。

オーバーライド:

toString、クラス: Object

戻り値:

このオブジェクトの文字列表現。