Класс 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.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.

Подробное описание конструкторов

ConfigFile

public ConfigFile()

Создать новый объект Configuration.

Исключения:

SecurityException - если Configuration нельзя инициализировать

ConfigFile

public ConfigFile(URI uri)

Создать новый объект Configuration из указанного URI.

Параметры:

uri - указанный URI

Исключения:

SecurityException - если Configuration нельзя инициализировать

NullPointerException - если uri равно null

Подробное описание методов

getAppConfigurationEntry

public AppConfigurationEntry[] getAppConfigurationEntry(String applicationName)

Получить запись из Configuration, используя имя приложения в качестве индекса.

Унаследованно от:

getAppConfigurationEntry в классе Configuration

Параметры:

applicationName - имя, используемое для индексации Configuration

Возвращает:

массив AppConfigurationEntry, соответствующий стопке конфигураций LoginModule для данного приложения, или null, если для данного приложения нет настроенных LoginModule.

refresh

public void refresh()

Обновить и перезагрузить Configuration, повторно прочитав все конфигурации входа в систему.

Переопределяет:

refresh в классе Configuration

Исключения:

SecurityException - если у вызывающего кода нет разрешения на обновление Configuration