クラス AuthConfigFactory

メソッドの詳細

• getFactory

  public static AuthConfigFactory getFactory()

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

  呼び出し時に null 以外のシステム全体のファクトリインスタンスが定義されている場合、たとえば setFactory の場合、それが返されます。それ以外の場合は、デフォルトの AuthConfigFactory 実装クラスのインスタンスを作成しようとします。デフォルトのファクトリ実装クラスの完全修飾クラス名は、DEFAULT_FACTORY_SECURITY_PROPERTY セキュリティプロパティの値から取得されます。デフォルトのファクトリ実装クラスのインスタンスがこのメソッドによって正常に構築されると、このメソッドはそれをシステム全体のファクトリインスタンスとして設定します。

  戻り値:

  呼び出し時に設定された null 以外のシステム全体の AuthConfigFactory インスタンス、またはその値が null の場合は、このメソッドによって確立されたシステム全体のファクトリインスタンスの値。このメソッドが呼び出されたときにシステム全体のファクトリが定義されておらず、セキュリティプロパティを介してデフォルトのファクトリ名が定義されていない場合、このメソッドは null を返します。

  例外:

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

• setFactory

  public static void setFactory(AuthConfigFactory factory)

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

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

  登録されたファクトリへの変更はリスナーに通知されません。

  パラメーター:

  factory - null の可能性がある AuthConfigFactory インスタンス。

• getConfigProvider

  public abstract AuthConfigProvider getConfigProvider(StringSE layer, StringSE appContext, RegistrationListener listener)

  ファクトリから登録済みの AuthConfigProvider を取得します。識別されたメッセージレイヤーとアプリケーションコンテキストに登録されている ServerAuthConfig および ClientAuthConfig オブジェクトのプロバイダーを取得します。

  すべてのファクトリは、レイヤーと appContext 引数に一致する登録済み AuthConfigProvider を選択するために、次の優先順位規則を使用する必要があります。

  • レイヤーおよび appContext 引数として渡される値に対して特別に登録されたプロバイダーが選択されます。
  • 前述のルールに従ってプロバイダーが選択されない場合は、appContext 引数として渡された値とすべての (つまり null) レイヤーに対して明示的に登録されたプロバイダーが選択されます。
  • 前述の規則に従ってプロバイダーが選択されない場合は、レイヤー引数として渡された値とすべての (つまり null) appContexts に対して明示的に登録されたプロバイダーが選択されます。
  • 前述の規則に従ってプロバイダーが選択されない場合は、すべての (つまり null) レイヤーおよびすべての (つまり null) appContexts に登録されているプロバイダーが選択されます。
  • 上記の規則に従ってプロバイダーが選択されていない場合、ファクトリは登録されたプロバイダーの検索を終了するものとします。

  上記の優先規則は、null または null 以外の className 引数で作成された登録に同等に適用されます。

  パラメーター:

  layer - 登録された AuthConfigProvider が返されるメッセージ層を識別する文字列。この引数の値は null の場合があります。

  appContext - 登録された AuthConfigProvider が返されるアプリケーションメッセージングコンテキストを識別する文字列。この引数の値は null の場合があります。

  listener - 対応する登録が登録解除または置換された場合に notify メソッドが呼び出される RegistrationListener。この引数の値は null の場合があります。

  戻り値:

  レイヤーと appContext のファクトリに登録された AuthConfigProvider インターフェースの実装、または AuthConfigProvider が選択されていない場合は null。戻り値が null の場合でも、引数リスナーがアタッチされます。

• registerConfigProvider

  public abstract StringSE registerConfigProvider(StringSE className, MapSE<StringSE,StringSE> properties, StringSE layer, StringSE appContext, StringSE description)

  ファクトリ内に登録し、プロバイダー登録のファクトリの永続的な宣言表現内に、メッセージ層およびアプリケーションコンテキスト識別子の ServerAuthConfig および / または ClientAuthConfig オブジェクトのプロバイダーを記録します。このメソッドは通常、プロバイダーをファクトリに登録する前にプロバイダーのインスタンスを構築します。これらのインスタンスが ClassName および現在の呼び出しで渡されたものと同等のプロパティ引数で登録されている場合、ファクトリは既存のプロバイダーインスタンスの永続的な登録を継承または変更できます。

  このメソッドは、AuthConfigProvider インターフェースのすべての実装でサポートされる必要がある 2 つの引数コンストラクターを使用し、このメソッドはコンストラクターのファクトリ引数に null 値を渡す必要があります。AuthConfigProviderImpl AuthConfigProviderImpl(Map properties, AuthConfigFactory factory)。

  メッセージレイヤーと appContext の特定の組み合わせに対して、ファクトリ内に存在できる登録は最大で 1 つです。レイヤーと appContext の値が同一である既存の登録は、後続の登録に置き換えられます。置き換えが発生すると、登録識別子、レイヤー、appContext 識別子は変更されず、AuthConfigProvider (初期化プロパティを含む) と説明が置き換えられます。

  Java プロセスの有効期間中、ファクトリは登録に一意の登録識別子を割り当てる必要があり、メッセージレイヤーや appContext 識別子が前回の使用と異なる登録に、以前に使用された登録識別子を割り当ててはなりません。

  このメソッドを使用して実行されるプログラム登録は、ファクトリコンストラクターによって使用されるプロバイダー登録の永続的な宣言型表現を（上記の置換ルールに従って）更新する必要があります。

  パラメーター:

  className - AuthConfigProvider 実装クラスの完全修飾名 (または null)。このパラメーターに null 値を指定してこのメソッドを呼び出すと、結果の登録が最も一致するレイヤーと appContext 値を指定して呼び出されたときに、getConfigProvider は null を返します。

  properties - プロバイダーコンストラクターのプロパティ引数に渡される初期化プロパティを含む Map オブジェクト。この引数は null の場合があります。

  layer - プロバイダーがファクトリで登録されるメッセージレイヤーを識別する文字列。このパラメーターの引数として null 値を渡すことができます。その場合、プロバイダーはすべてのレイヤーに登録されます。

  appContext - このプロバイダーに構成オブジェクトをリクエストするためにランタイムが使用できる文字列値。このパラメーターの引数として null 値を渡すことができます。その場合、プロバイダーはすべての構成 ID（指定されたレイヤー）に登録されます。

  description - プロバイダーを説明するテキスト文字列。この値は null の可能性があります。

  戻り値:

  ファクトリによってプロバイダー登録に割り当てられた文字列識別子。ファクトリから登録を削除するために使用できます。

  例外:

  SecurityExceptionSE - プロバイダーの構築 (null 以外の className が指定された場合) または登録が失敗した場合。

• registerConfigProvider

  public abstract StringSE registerConfigProvider(AuthConfigProvider provider, StringSE layer, StringSE appContext, StringSE description)

  （メモリ内の）ファクトリ内で、メッセージ層およびアプリケーションコンテキスト識別子の ServerAuthConfig および / または ClientAuthConfig オブジェクトのプロバイダーを登録します。このメソッドは、プロバイダー登録のファクトリの永続的な宣言型表現には影響せず、プロバイダーが自己登録を実行するために使用することを目的としています。

  メッセージレイヤーと appContext の特定の組み合わせに対して、ファクトリ内に存在できる登録は最大で 1 つです。レイヤーと appContext の値が同一である既存の登録は、後続の登録に置き換えられます。置き換えが発生すると、登録識別子、レイヤー、appContext 識別子は変更されず、AuthConfigProvider (初期化プロパティを含む) と説明が置き換えられます。

  Java プロセスの有効期間中、ファクトリは登録に一意の登録識別子を割り当てる必要があり、メッセージレイヤーや appContext 識別子が前回の使用と異なる登録に、以前に使用された登録識別子を割り当ててはなりません。

  パラメーター:

  provider - ファクトリで登録される AuthConfigProvider (または null)。このパラメーターに null 値を指定してこのメソッドを呼び出すと、結果の登録が最も一致するレイヤーと appContext 値を指定して呼び出されたときに、getConfigProvider は null を返します。

  layer - プロバイダーがファクトリで登録されるメッセージレイヤーを識別する文字列。このパラメーターの引数として null 値を渡すことができます。その場合、プロバイダーはすべてのレイヤーに登録されます。

  appContext - このプロバイダーに構成オブジェクトをリクエストするためにランタイムが使用できる文字列値。このパラメーターの引数として null 値を渡すことができます。その場合、プロバイダーはすべての構成 ID（指定されたレイヤー）に登録されます。

  description - プロバイダーを説明するテキスト文字列。この値は null の可能性があります。

  戻り値:

  ファクトリによってプロバイダー登録に割り当てられた文字列識別子。ファクトリから登録を削除するために使用できます。

  例外:

  SecurityExceptionSE - プロバイダーの登録に失敗した場合。

• registerServerAuthModule

  public abstract StringSE registerServerAuthModule(ServerAuthModule serverAuthModule, ObjectSE context)

  (メモリ内) ファクトリ内に、メッセージ層の ServerAuthModule のインスタンスと、プロファイル固有のコンテキストオブジェクトによって識別されるアプリケーションコンテキスト識別子を登録します。

  これは、独自の手段または標準 API を使用して、すでに登録されている他のモジュールをオーバーライドします。ServerAuthModule は、プロファイル固有のコンテキストオブジェクトに関連付けられたコンテキストが終了したときに、removeServerAuthModule への呼び出しを介して削除されます。

  このメソッドは registerConfigProvider の代わりに使用できる便利なメソッドですが、最終的には同じ効果があることに注意してください。つまり、layer および appContext パラメーターはコンテキストオブジェクトから生成され、ServerAuthModule は実装固有の AuthConfigProvider によってラップされます。これらは、registerConfigProvider または同じ効果を持つ内部メソッドを呼び出すために使用されます。返された登録 ID は、プロファイル固有のコンテキストオブジェクトに関連付けられ、このメソッドからも返されます。

  「プロファイル固有のコンテキストオブジェクト」は、たとえば、サーブレットコンテナープロファイルの ServletContext です。この ServletContext に関連付けられたコンテキストは、たとえばそれに対応するアプリケーションがアンデプロイされると終了します。登録 ID と ServletContext の関連付けは、単に登録 ID を値として ServletContext で setAttribute メソッドを呼び出すことを意味します。(name 属性は、このバージョンの仕様では標準化されていません)

  パラメーター:

  serverAuthModule - 登録する ServerAuthModule インスタンス

  context - モジュールが登録されているアプリケーションのプロファイル固有のコンテキスト

  戻り値:

  ファクトリによってプロバイダー登録に割り当てられた文字列識別子。ファクトリから登録を削除するために使用できます。

• removeServerAuthModule

  public abstract void removeServerAuthModule(ObjectSE context)

  registerServerAuthModule への呼び出しを介して以前に登録された ServerAuthModule (および潜在的に包含されるラッパー / ファクトリ) を削除します。

  このメソッドは removeRegistration の代わりに使用できる便利なメソッドですが、最終的には同じ効果があることに注意してください。つまり、registerServerAuthModule からの戻り値で removeRegistration を呼び出すと、ServerAuthModule が削除されるという点で同じ効果がなければなりません。

  パラメーター:

  context - モジュールが削除されるアプリケーションのプロファイル固有のコンテキスト。

• removeRegistration

  public abstract boolean removeRegistration(StringSE registrationID)

  識別されたプロバイダー登録をファクトリから（および必要に応じてプロバイダー登録の永続的な宣言型表現から）削除し、削除された登録に関連付けられているリスナーを呼び出します。

  パラメーター:

  registrationID - ファクトリでのプロバイダー登録を識別する文字列

  戻り値:

  指定された識別子の登録があり、それが削除された場合は True。登録 ID が無効な場合は false を返します。

• detachListener

  public abstract StringSE[] detachListener(RegistrationListener listener, StringSE layer, StringSE appContext)

  このメソッドの対応する引数によってレイヤーと appContext 値が一致するすべてのプロバイダー登録からリスナーの関連付けを解除します。

  ファクトリは定期的にリスナーに通知して、使用されなくなったリスナーを効果的に切り離す必要があります。

  パラメーター:

  listener - 切り離される RegistrationListener。

  layer - メッセージレイヤーまたは null を識別する文字列。

  appContext - アプリケーションコンテキストまたは null を識別する文字列値。

  戻り値:

  文字列値の配列。各値は、リスナーが削除されたプロバイダー登録を識別します。このメソッドが null を返すことはありません。リスナーが登録から削除されていない場合は、空の配列を返します。

• getRegistrationIDs

  public abstract StringSE[] getRegistrationIDs(AuthConfigProvider provider)

  ファクトリでのプロバイダーインスタンスのすべての登録の登録識別子を取得します。

  パラメーター:

  provider - 登録 ID が返される AuthConfigurationProvider。この引数は null の場合があります。その場合、ファクトリ内のすべてのアクティブな登録の ID が返されることを示します。

  戻り値:

  文字列値の配列。各値は、ファクトリでのプロバイダー登録を識別します。このメソッドが null を返すことはありません。識別されたプロバイダーの登録がファクトリにない場合は、空の配列を返します。

• getRegistrationContext

  public abstract AuthConfigFactory.RegistrationContext getRegistrationContext(StringSE registrationID)

  特定された登録の登録コンテキストを取得します。

  パラメーター:

  registrationID - ファクトリでのプロバイダー登録を識別する文字列

  戻り値:

  RegistrationContext または null。null 以外の値が返される場合、登録に対応する登録コンテキストのコピーです。登録識別子がアクティブな登録に対応していない場合は、Null が返されます

• refresh

  public abstract void refresh()

  プロバイダー登録の永続的な宣言表現をファクトリに再処理させます。

  ファクトリは、プロバイダー実装クラスまたは初期化プロパティの変更が発生した場合にのみ、既存の登録を置き換える必要があります。

  例外:

  SecurityExceptionSE - 再初期化中にエラーが発生した場合。