クラス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. セキュリティ・プロパティlogin.config.url.1、login.config.url.2、...、login.config.url.Xに対してループ処理を行います。 それぞれのプロパティ値では、ロードされるログイン構成ファイルを参照するURLを指定します。 各構成が読み込まれ、ロードされます。
  2. システム・プロパティjava.security.auth.login.configは、別のログイン構成ファイル(ユーザーが実行時に -Dスイッチを使用した場合)を指すURLに設定することもできます。 このプロパティが定義されており、このプロパティの使用がセキュリティ・プロパティ・ファイルで許可されている(セキュリティ・プロパティpolicy.allowSystemPropertyがtrue)場合は、そのログイン構成もロードされます。
  3. java.security.auth.login.configプロパティが「==」(「=」ではない)を使用して定義されている場合、ほかに指定したログイン構成はすべて無視され、この構成だけがロードされます。
  4. システム・プロパティやセキュリティ・プロパティが設定されていない場合は、${user.home}/.java.login.configファイルからの読込みが試みられます(${user.home}はuser.homeシステム・プロパティで表される値)。

この実装でサポートされる構成構文は、javax.security.auth.login.Configurationクラスで指定した構文です。 また、セキュリティ・プロパティpolicy.expandPropertiesを使用して、構成ファイルのシステム・プロパティを展開するかどうかを制御できます。 設定しない場合、デフォルト値はtrueで、プロパティが展開されることを意味します。

導入されたバージョン:
1.4
関連項目:

  • ネストされたクラスのサマリー

    Configurationクラスで宣言されたネストされたクラス/インタフェース

    Configuration.Parameters
    修飾子と型
    クラス
    説明
    static interface 
    Configuration.Parameters
    このインタフェースは、Configurationパラメータのマーカー・インタフェースです。

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

    コンストラクタ
    コンストラクタ
    説明
    ConfigFile()
    新しいConfigurationオブジェクトを作成します。
    ConfigFile(URI uri)
    指定されたURIから新しいConfigurationオブジェクトを作成します。

  • メソッドのサマリー

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

    Configurationクラスで宣言されたメソッド

    getConfiguration, getInstance, getInstance, getInstance, getParameters, getProvider, getType, setConfiguration
    修飾子と型
    メソッド
    説明
    static Configuration
    getConfiguration()
    インストール済みのログインConfigurationを取得します。
    static Configuration
    getInstance(String type, Configuration.Parameters params)
    指定された型のConfigurationオブジェクトを返します。
    static Configuration
    getInstance(String type, Configuration.Parameters params, String provider)
    指定された型のConfigurationオブジェクトを返します。
    static Configuration
    getInstance(String type, Configuration.Parameters params, Provider provider)
    指定された型のConfigurationオブジェクトを返します。
    Configuration.Parameters
    getParameters()
    Configurationパラメータを返します。
    Provider
    getProvider()
    このConfigurationのプロバイダを返します。
    String
    getType()
    このConfigurationの型を返します。
    static void
    setConfiguration(Configuration configuration)
    ログインConfigurationを設定します。

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    boolean
    equals(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    int
    hashCode()
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    String
    toString()
    オブジェクトの文字列表現を返します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • コンストラクタの詳細

    • ConfigFile

      public ConfigFile()
      新しいConfigurationオブジェクトを作成します。
      スロー:
      SecurityException - Configurationを初期化できない場合

    • ConfigFile

      public ConfigFile(URI uri)
      指定されたURIから新しいConfigurationオブジェクトを作成します。
      パラメータ:
      uri - URI
      スロー:
      SecurityException - Configurationを初期化できない場合
      NullPointerException - uriがnullの場合

  • メソッドの詳細

    • getAppConfigurationEntry

      public AppConfigurationEntry[] getAppConfigurationEntry(String applicationName)
      アプリケーション名をインデックスとして使用しているConfigurationからのエントリを取得します。
      定義:
      getAppConfigurationEntry、クラスConfiguration
      パラメータ:
      applicationName - Configurationのインデックスとして使用される名前
      戻り値:
      このアプリケーション用にスタックされたLoginModuleの構成に対応する、AppConfigurationEntryの配列。LoginModuleが構成されていない場合はnull。

    • refresh

      public void refresh()
      すべてのログイン構成を読み込み直すことで、Configurationをリフレッシュし、再ロードします。
      オーバーライド:
      refresh、クラスConfiguration