com.sun.security.auth.login
クラス ConfigFile

java.lang.Object
  javax.security.auth.login.Configuration
      com.sun.security.auth.login.ConfigFile

public class ConfigFile
extends Configuration

このクラスは javax.security.auth.login.Configuration のデフォルトの実装を表します。

実行時のログイン構成表現を格納し、複数のファイル内にある複数の静的なログイン構成を合わせます。ログイン構成ファイルを検出し、その情報を Configuration に読み込むアルゴリズムは次のとおりです。

1. java.security.Security のプロパティー login.config.url.1、login.config.url.2、...、login.config.url.X に対してループ処理を行います。これらのプロパティーは <JAVA_HOME>/lib/security/java.security という名前の Java セキュリティープロパティーファイルに設定されます。<JAVA_HOME> は java.home システムプロパティーの値を参照しており、JRE のインストールディレクトリを示します。それぞれのプロパティー値では、ロードされるログイン構成ファイルを参照する URL を指定します。各構成が読み込まれ、ロードされます。
2. java.lang.System のプロパティーである java.security.auth.login.config にも、別のログイン構成ファイルを参照する URL を設定できます (実行時に -D スイッチを使用する場合)。このプロパティーが定義されており、このプロパティーを使用するようにセキュリティープロパティーファイルに設定されている (セキュリティープロパティー policy.allowSystemProperty が true) 場合は、参照されているログイン構成がロードされます。
3. java.security.auth.login.config プロパティーが == (= ではない) を使用して定義されている場合、ほかに指定したログイン構成はすべて無視され、この構成だけがロードされます。
4. システムプロパティーやセキュリティープロパティーが設定されていない場合は、${user.home}/.java.login.config ファイルからの読み込みが試みられます (${user.home} はuser.home システムプロパティーで表される値)。

この実装でサポートされる構成構文は、javax.security.auth.login.Configuration クラスで指定した構成構文です。

関連項目:

LoginContext

入れ子のクラスの概要

クラス javax.security.auth.login.Configuration から継承された入れ子のクラス/インタフェース

Configuration.Parameters

コンストラクタの概要

ConfigFile()
新しい Configuration オブジェクトを生成します。

ConfigFile(URI uri)
指定された URI から新しい Configuration オブジェクトを生成します。

メソッドの概要

AppConfigurationEntry[]	getAppConfigurationEntry(String applicationName) アプリケーション名をインデックスとして使用している Configuration から のエントリを取得します。
void	refresh() すべてのログイン構成を読み込みし直すことで、Configuration を更新し、再ロードします。

クラス javax.security.auth.login.Configuration から継承されたメソッド

getConfiguration, getInstance, getInstance, getInstance, getParameters, getProvider, getType, setConfiguration

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

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

コンストラクタの詳細

ConfigFile

public ConfigFile()

新しい Configuration オブジェクトを生成します。

ConfigFile

public ConfigFile(URI uri)

指定された URI から新しい Configuration オブジェクトを生成します。

パラメータ:

uri - この URI から新しい Configuration オブジェクトを生成する

メソッドの詳細

getAppConfigurationEntry

public AppConfigurationEntry[] getAppConfigurationEntry(String applicationName)

アプリケーション名をインデックスとして使用している Configuration から のエントリを取得します。

定義:

クラス Configuration 内の getAppConfigurationEntry

パラメータ:

applicationName - Configuration のインデックスとして使用される名前

戻り値:

このアプリケーション用にスタックされた LoginModule の構成に対応する、AppConfigurationEntries の配列。LoginModule が構成されていない場合は null

refresh

public void refresh()

すべてのログイン構成を読み込みし直すことで、Configuration を更新し、再ロードします。

オーバーライド:

クラス Configuration 内の refresh

例外:

SecurityException - 呼び出し側に Configuration の更新権がない場合