public abstract class PolicyConfigurationFactory extends ObjectSE
実装クラスには、ファクトリ実装クラスの操作インスタンスを作成するために使用できるパブリック引数なしコンストラクターが必要です。
Permission
SE, PolicyConfiguration
, PolicyContextException
コンストラクターと説明 |
---|
PolicyConfigurationFactory() |
修飾子と型 | メソッドと説明 |
---|---|
abstract PolicyConfiguration | getPolicyConfiguration(StringSE contextID, boolean remove) このメソッドは、プロバイダー内で識別されたポリシーコンテキストに対応する PolicyConfiguration インターフェースを実装するプロバイダー固有のクラスのインスタンスを取得するために使用されます。 |
static PolicyConfigurationFactory | getPolicyConfigurationFactory() この静的メソッドは、システムプロパティを使用して、プロバイダー固有のファクトリ実装クラスを(public コンストラクターを介して)検索してインスタンス化します。 |
abstract boolean | inService(StringSE contextID) このメソッドは、識別されたポリシーコンテキストが、ファクトリに関連付けられたポリシープロバイダーの状態 "inService" で存在するかどうかを判別します。 |
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE
public static PolicyConfigurationFactory getPolicyConfigurationFactory() throws ClassNotFoundExceptionSE, PolicyContextException
プロバイダー固有のファクトリ実装クラスの名前は、システムプロパティの値から取得されます。
jakarta.security.jacc.PolicyConfigurationFactory.provider.
SecurityExceptionSE
- "setPolicy" SecurityPermission が付与されていない AccessControlContext によって呼び出された場合。ClassNotFoundExceptionSE
- システムプロパティの値が設定されていないなどの理由で、システムプロパティで指定されたクラスが見つからなかった場合。PolicyContextException
- 実装が、getPolicyConfigurationFactory メソッドシグネチャーによって説明されていないチェック済み例外をスローした場合。実装クラスによってスローされた例外は、スローされた PolicyContextException に(構築中に)カプセル化されます。public abstract PolicyConfiguration getPolicyConfiguration(StringSE contextID, boolean remove) throws PolicyContextException
呼び出し時に、識別されたポリシーコンテキストがプロバイダーに存在しない場合、ポリシーコンテキストがプロバイダーに作成され、コンテキストの PolicyConfiguration インターフェースを実装するオブジェクトが返されます。識別されたコンテキストの状態が「削除済み」または "inService" の場合、呼び出しの結果として「オープン」状態に移行します。ポリシーコンテキストのライフサイクルの状態は、PolicyConfiguration インターフェースによって定義されます。
ポリシーコンテキスト識別子の特定の値について、このメソッドは常に PolicyConfiguration の同じインスタンスを返す必要があり、特定のポリシーコンテキスト識別子を持つ PolicyConfiguration の実際のインスタンスが最大で 1 つ存在する必要があります(プロセスコンテキスト中)。
特定のポリシーコンテキストに対して最大で 1 つの PolicyConfiguration オブジェクトが存在するという不変条件を保持するには、このメソッドがスレッドセーフである必要がある場合があります。
contextID
- PolicyConfiguration インターフェースが返されるポリシーコンテキストを識別する文字列。このパラメーターに渡される値は null であってはなりません。remove
- PolicyConfiguration オブジェクトが返される前に、既存のポリシーコンテキストのポリシーステートメントとリンケージを削除するかどうかを確立するブール値。このパラメーターに渡された値が true の場合、既存のポリシーコンテキストのポリシーステートメントとリンケージは削除されます。値が false の場合、削除されません。SecurityExceptionSE
- "setPolicy" SecurityPermission が付与されていない AccessControlContext によって呼び出された場合。PolicyContextException
- 実装が、getPolicyConfiguration メソッドのシグネチャーによって説明されていないチェック済みの例外をスローした場合。実装クラスによってスローされた例外は、スローされた PolicyContextException に(構築中に)カプセル化されます。public abstract boolean inService(StringSE contextID) throws PolicyContextException
contextID
- ポリシーコンテキストを識別する文字列 SecurityExceptionSE
- "setPolicy" SecurityPermission が付与されていない AccessControlContext によって呼び出された場合。PolicyContextException
- 実装が、inService メソッドのシグネチャーによって説明されていないチェック済みの例外をスローした場合。実装クラスによってスローされた例外は、スローされた PolicyContextException に(構築中に)カプセル化されます。Copyright © 2018,2020 Eclipse Foundation.
Use is subject to license terms.