クラス PolicyFactory

メソッドの詳細

• getPolicyFactory

  public static PolicyFactory getPolicyFactory()

  システム全体の PolicyFactory 実装を取得します。

  ファクトリ実装クラスの名前は、システムプロパティの値から取得されます。

  
       jakarta.security.jacc.PolicyFactory.provider
   
   

  この値はフィールド PolicyFactory.FACTORY_NAME から取得することもできます。

  戻り値:

  プロバイダー固有の PolicyFactory 実装クラスのシステム全体のシングルトンインスタンス。

  例外:

  SecurityExceptionSE - クラスのロード中、またはデフォルトの PolicyFactory 実装クラスの構築中に例外がスローされた場合。この場合、SecurityException には原因としてルート例外が含まれます。

• setPolicyFactory

  public static void setPolicyFactory(PolicyFactory policyFactory)

  システム全体の PolicyFactory 実装を設定します。

  以前に実装が設定されていた場合は、置き換えられます。

  パラメーター:

  policyFactory - null の可能性がある PolicyFactory インスタンス。

• getWrapped

  public PolicyFactory getWrapped()

  このファクトリが装飾されている場合、装飾を行う実装はこのメソッドをオーバーライドして、ラップされている実装へのアクセスを提供できます。

• getPolicy

  public Policy getPolicy()

  このメソッドは、プロバイダー内のポリシーコンテキストに対応する Policy インターフェースを実装するプロバイダー固有のクラスのインスタンスを取得するために使用されます。ポリシーコンテキストは、アクセサーが呼び出されるスレッドに関連付けられたポリシーコンテキスト識別子の値によって識別されます。

  ポリシーコンテキスト識別子の特定の決定された値について、このメソッドは常に Policy の同じインスタンスを返す必要があり、特定のポリシーコンテキスト識別子を持つ Policy の実際のインスタンスは (プロセスコンテキスト中に) 最大 1 つ存在する必要があります。

  このメソッドは論理的には、PolicyContext.getContextID() から返された値を入力として getPolicy(String) を呼び出すことと同じである必要があります。

  戻り値:

  識別されたポリシーコンテキストに対応する Policy インターフェースを実装するオブジェクト、またはそのようなオブジェクトが存在しない場合は null。

• setPolicy

  public void setPolicy(Policy policy)

  コンテキストポリシーの実装を設定します。

  以前に実装が設定されていた場合は、置き換えられます。

  このメソッドは、最初のパラメーターの入力として PolicyContext.getContextID() から返された値を使用して setPolicy(String, Policy) を呼び出すことと論理的に同じである必要があります。

  パラメーター:

  policy - ポリシーインスタンス。null の場合もあります。

• getPolicy

  public abstract Policy getPolicy(StringSE contextId)

  このメソッドは、プロバイダー内のポリシーコンテキストに対応する Policy インターフェースを実装するプロバイダー固有のクラスのインスタンスを取得するために使用されます。ポリシーコンテキストは、アクセサーが呼び出されるスレッドに関連付けられたポリシーコンテキスト識別子の値によって識別されます。

  ポリシーコンテキスト識別子の特定の決定された値について、このメソッドは常に Policy の同じインスタンスを返す必要があり、特定のポリシーコンテキスト識別子を持つ Policy の実際のインスタンスは (プロセスコンテキスト中に) 最大 1 つ存在する必要があります。

  パラメーター:

  contextId - Policy インターフェースが返されるポリシーコンテキストを識別する文字列。このパラメーターに渡される値は null にすることもできます。これは、システム全体のデフォルトの Policy インスタンスに対応します。

  戻り値:

  識別されたポリシーコンテキストに対応する Policy インターフェースを実装するオブジェクト、またはそのようなオブジェクトが存在しない場合は null。

• setPolicy

  public abstract void setPolicy(StringSE contextId, Policy policy)

  コンテキストポリシーの実装を設定します。

  以前に実装が設定されていた場合は、置き換えられます。

  パラメーター:

  contextId - Policy インターフェースが返されるポリシーコンテキストを識別する文字列。このパラメーターに渡される値は null にすることもできます。これは、システム全体のデフォルトの Policy インスタンスに対応します。

  policy - ポリシーインスタンス。null の場合もあります。