Конфигурация (Платформа Java SE 7)

java.lang. Объект
- javax.security.auth.login. Конфигурация

```
public abstract class Configuration
extends Object
```
Объект Конфигурации ответственен за определение, который LoginModules должен использоваться для определенного приложения, и в том, какой порядок LoginModules должен быть вызван.
Конфигурация входа в систему содержит следующую информацию. Отметьте, что этот пример только представляет синтаксис по умолчанию для Configuration. Реализации подкласса этого класса могут реализовать альтернативные синтаксисы и могут получить Configuration из любого источника, такого как файлы, базы данных, или серверы.
```
      Name {
            ModuleClass  Flag    ModuleOptions;
            ModuleClass  Flag    ModuleOptions;
            ModuleClass  Flag    ModuleOptions;
      };
      Name {
            ModuleClass  Flag    ModuleOptions;
            ModuleClass  Flag    ModuleOptions;
      };
      other {
            ModuleClass  Flag    ModuleOptions;
            ModuleClass  Flag    ModuleOptions;
      };
 
```
Каждая запись в Configuration индексируется через имя приложения, Имя, и содержит список LoginModules, сконфигурированного для того приложения. Каждый LoginModule определяется через его полностью определенное имя класса. Аутентификация продолжает вниз список модулей в точном определенном порядке. Если у приложения нет определенной записи, оно принимает значение по умолчанию к определенной записи для "другого".
Флаговое значение управляет полным поведением, поскольку аутентификация продолжает вниз стек. Следующее представляет описание допустимых значений для Флага и их соответствующей семантики:
```
      1) Required     - The LoginModule is required to succeed.
                      If it succeeds or fails, authentication still continues
                      to proceed down the LoginModule list.

      2) Requisite    - The LoginModule is required to succeed.
                      If it succeeds, authentication continues down the
                      LoginModule list.  If it fails,
                      control immediately returns to the application
                      (authentication does not proceed down the
                      LoginModule list).

      3) Sufficient   - The LoginModule is not required to
                      succeed.  If it does succeed, control immediately
                      returns to the application (authentication does not
                      proceed down the LoginModule list).
                      If it fails, authentication continues down the
                      LoginModule list.

      4) Optional     - The LoginModule is not required to
                      succeed.  If it succeeds or fails,
                      authentication still continues to proceed down the
                      LoginModule list.
 
```
Полная аутентификация успешно выполняется, только если все Необходимое и Необходимое LoginModules успешно выполняются. Если Достаточное LoginModule конфигурируется и успешно выполняется, тогда только Необходимое и Необходимое LoginModules до этого Достаточного LoginModule потребность успешно выполниться для полной аутентификации, чтобы успешно выполниться. Если никакое Необходимое или Необходимое LoginModules не конфигурируются для приложения, то по крайней мере один Достаточный или Дополнительный LoginModule должен успешно выполниться.
ModuleOptions является пространством разделенный список LoginModuleСпецифичные значения, которые передают непосредственно к базовому LoginModules. Опции определяются LoginModule непосредственно, и управление поведение в пределах этого. Например, a LoginModule может определить опции, чтобы поддерживать возможности отладки/тестирования. Корректный способ определить опции в Configuration при использовании следующего соединения значения ключа: отладьте = "истина". Ключ и значение должны быть разделены, 'равняется' символу, и значение должно быть окружено двойными кавычками. Если Строка в форме, $ {system.property}, произойдет в значении, то это будет расширено до значения системного свойства. Отметьте, что нет никакого предела числу вариантов a LoginModule может определить.
Следующее представляет пример Configuration запись, основанная на синтаксисе выше:
```
 Login {
   com.sun.security.auth.module.UnixLoginModule required;
   com.sun.security.auth.module.Krb5LoginModule optional
                   useTicketCache="true"
                   ticketCache="${user.home}${/}tickets";
 };
 
```
Это Configuration определяет, что названное приложение, "Вход в систему", требует, чтобы пользователи сначала аутентифицировали к com.sun.security.auth.module.UnixLoginModule, который обязан успешно выполняться. Даже если аутентификация UnixLoginModule перестала работать, com.sun.security.auth.module.Krb5LoginModule все еще вызывается. Это помогает скрыть источник отказа. Так как Krb5LoginModule является Дополнительным, полная аутентификация успешно выполняется, только если (Необходимый) UnixLoginModule успешно выполняется.
Также отметьте, что опции LoginModule-specific, useTicketCache = "истина" и ticketCache= $ {user.home} $ {/} билеты", передают к Krb5LoginModule. Эти опции дают Krb5LoginModule команду использовать кэш билета в указанном расположении. Системные свойства, user.home и / (file.separator), расширяются до их соответствующих значений.
Есть только один объект Конфигурации, установленный во время выполнения в любой момент времени. Объект Конфигурации может быть установлен, вызывая setConfiguration метод. Установленный объект Конфигурации может быть получен, вызывая getConfiguration метод.
Если никакой объект Конфигурации не был установлен во время выполнения, звонок getConfiguration устанавливает экземпляр реализации Конфигурации по умолчанию (реализация подкласса по умолчанию этого абстрактного класса). Реализация Конфигурации по умолчанию может быть изменена, устанавливая значение "login.configuration.provider" свойства безопасности (в файле свойств безопасности Java) к полностью определенному имени требуемой реализации подкласса Конфигурации. Файл свойств безопасности Java располагается в файле под названием <JAVA_HOME>/lib/security/java.security. <JAVA_HOME> обращается к значению java.home системного свойства, и определяет каталог, где JRE устанавливается.
Код программы может непосредственно разделить Конфигурацию на подклассы, чтобы обеспечить пользовательскую реализацию. Кроме того, экземпляр объекта Конфигурации может быть создан, вызывая один из getInstance методы фабрики со стандартным типом. Тип политики по умолчанию является "JavaLoginConfig". См. раздел Конфигурации в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для списка стандартных типов Конфигурации.
См. Также:
LoginContext

Вложенная Сводка Класса

Вложенные Классы
Модификатор и Тип	Класс и Описание
`static interface`	`Конфигурация. Параметры` Это представляет интерфейс маркера для Параметров конфигурации.

Сводка конструктора

Конструкторы
Модификатор Конструктор и Описание

protected Configuration()
Единственный конструктор.

Конструкторы
Модификатор	Конструктор и Описание
`protected`	`Configuration()` Единственный конструктор.

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`abstract AppConfigurationEntry[]`	`getAppConfigurationEntry(String name)` Получите AppConfigurationEntries для указанного имени от этой Конфигурации.
`static Configuration`	`getConfiguration()` Получите установленную Конфигурацию входа в систему.
`static Configuration`	`getInstance(String type, Configuration.Parameters params)` Возвращает объект Конфигурации указанного типа.
`static Configuration`	`getInstance(String type, Configuration.Parameters params, Provider provider)` Возвращает объект Конфигурации указанного типа.
`static Configuration`	`getInstance(String type, Configuration.Parameters params, String provider)` Возвращает объект Конфигурации указанного типа.
`Конфигурация. Параметры`	`getParameters()` Возвратите Параметры конфигурации.
`Провайдер`	`getProvider()` Возвратите Провайдера этой Конфигурации.
`Строка`	`getType()` Возвратите тип этой Конфигурации.
`void`	`refresh()` Обновите и перезагрузите Конфигурацию.
`static void`	`setConfiguration(Configuration configuration)` Установите вход в систему `Configuration`.

Методы java.lang унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Деталь конструктора
  - Конфигурация
```
protected Configuration()
```
    Единственный конструктор. (Для вызова конструкторами подкласса, обычно неявными.)
- Деталь метода
  - getConfiguration
```
public static Configuration getConfiguration()
```
    Получите установленную Конфигурацию входа в систему.
    
    Возвраты:
    Конфигурация входа в систему. Если объект Конфигурации был установлен через Configuration.setConfiguration метод, тогда тот объект возвращается. Иначе, объект Конфигурации по умолчанию возвращается.
    
    Броски:
    
    SecurityException - если у вызывающей стороны нет разрешения, чтобы получить Конфигурацию.
    См. Также:
    setConfiguration(javax.security.auth.login.Configuration)
  - setConfiguration
```
public static void setConfiguration(Configuration configuration)
```
    Установите вход в систему Configuration.
    
    Параметры:
    configuration - новое Configuration
    
    Броски:
    
    SecurityException - если у текущего потока нет Разрешения, чтобы установить Configuration.
    См. Также:
    getConfiguration()
  - getInstance
```
public static Configuration getInstance(String type,
                        Configuration.Parameters params)
                                 throws NoSuchAlgorithmException
```
    Возвращает объект Конфигурации указанного типа.
    Этот метод пересекает список зарегистрированных поставщиков систем обеспечения безопасности, запускающихся с самого привилегированного Провайдера. Возвращается новый объект Конфигурации инкапсуляция реализации ConfigurationSpi от первого Провайдера, который поддерживает указанный тип.
    Отметьте, что список зарегистрированных провайдеров может быть получен через Security.getProviders() метод.
    
    Параметры:
    type - указанный тип Конфигурации. См. раздел Конфигурации в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для списка стандартных типов Конфигурации.
    params - параметры для Конфигурации, которая может быть нулем.
    
    Возвраты:
    новый объект Конфигурации.
    
    Броски:
    
    SecurityException - если у вызывающей стороны нет разрешения, чтобы получить экземпляр Конфигурации для указанного типа.
    
    NullPointerException - если указанный тип является нулем.
    
    IllegalArgumentException - если указанные параметры не понимаются под реализацией ConfigurationSpi от выбранного Провайдера.
    
    NoSuchAlgorithmException - если никакой Провайдер не поддерживает реализацию ConfigurationSpi для указанного типа.
    С тех пор:
    
    1.6
    
    См. Также:
    Provider
  - getInstance
```
public static Configuration getInstance(String type,
                        Configuration.Parameters params,
                        String provider)
                                 throws NoSuchProviderException,
                                        NoSuchAlgorithmException
```
    Возвращает объект Конфигурации указанного типа.
    Возвращается новый объект Конфигурации инкапсуляция реализации ConfigurationSpi от указанного провайдера. Указанный провайдер должен быть зарегистрирован в списке провайдера.
    Отметьте, что список зарегистрированных провайдеров может быть получен через Security.getProviders() метод.
    
    Параметры:
    type - указанный тип Конфигурации. См. раздел Конфигурации в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для списка стандартных типов Конфигурации.
    params - параметры для Конфигурации, которая может быть нулем.
    provider - провайдер.
    
    Возвраты:
    новый объект Конфигурации.
    
    Броски:
    
    SecurityException - если у вызывающей стороны нет разрешения, чтобы получить экземпляр Конфигурации для указанного типа.
    
    NullPointerException - если указанный тип является нулем.
    
    IllegalArgumentException - если указанный провайдер является нулем или пустой, или если указанные параметры не понимаются под реализацией ConfigurationSpi от указанного провайдера.
    
    NoSuchProviderException - если указанный провайдер не регистрируется в списке поставщика систем обеспечения безопасности.
    
    NoSuchAlgorithmException - если указанный провайдер не поддерживает реализацию ConfigurationSpi для указанного типа.
    С тех пор:
    
    1.6
    
    См. Также:
    Provider
  - getInstance
```
public static Configuration getInstance(String type,
                        Configuration.Parameters params,
                        Provider provider)
                                 throws NoSuchAlgorithmException
```
    Возвращает объект Конфигурации указанного типа.
    Возвращается новый объект Конфигурации инкапсуляция реализации ConfigurationSpi от указанного объекта Провайдера. Отметьте, что указанный объект Провайдера не должен быть зарегистрирован в списке провайдера.
    
    Параметры:
    type - указанный тип Конфигурации. См. раздел Конфигурации в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для списка стандартных типов Конфигурации.
    params - параметры для Конфигурации, которая может быть нулем.
    provider - Провайдер.
    
    Возвраты:
    новый объект Конфигурации.
    
    Броски:
    
    SecurityException - если у вызывающей стороны нет разрешения, чтобы получить экземпляр Конфигурации для указанного типа.
    
    NullPointerException - если указанный тип является нулем.
    
    IllegalArgumentException - если указанный Провайдер является нулем, или если указанные параметры не понимаются под реализацией ConfigurationSpi от указанного Провайдера.
    
    NoSuchAlgorithmException - если указанный Провайдер не поддерживает реализацию ConfigurationSpi для указанного типа.
    С тех пор:
    
    1.6
    
    См. Также:
    Provider
  - getProvider
```
public Provider getProvider()
```
    Возвратите Провайдера этой Конфигурации.
    У этого экземпляра Конфигурации только будет Провайдер, если он был получен через звонок Configuration.getInstance. Иначе этот метод возвращает нуль.
    
    Возвраты:
    Провайдер этой Конфигурации, или нуль.
    С тех пор:
    
    1.6
  - getType
```
public String getType()
```
    Возвратите тип этой Конфигурации.
    У этого экземпляра Конфигурации только будет тип, если он был получен через звонок Configuration.getInstance. Иначе этот метод возвращает нуль.
    
    Возвраты:
    тип этой Конфигурации, или нуль.
    С тех пор:
    
    1.6
  - getParameters
```
public Configuration.Parameters getParameters()
```
    Возвратите Параметры конфигурации.
    У этого экземпляра Конфигурации только будут параметры, если он был получен через звонок Configuration.getInstance. Иначе этот метод возвращает нуль.
    
    Возвраты:
    Параметры конфигурации, или нуль.
    С тех пор:
    
    1.6
  - getAppConfigurationEntry
```
public abstract AppConfigurationEntry[] getAppConfigurationEntry(String name)
```
    Получите AppConfigurationEntries для указанного имени от этой Конфигурации.
    
    Параметры:
    name - имя, используемое, чтобы индексировать Конфигурацию.
    
    Возвраты:
    массив AppConfigurationEntries для указанного имени от этой Конфигурации, или нуль, если нет никаких записей для указанного имени
  - обновление
```
public void refresh()
```
    Обновите и перезагрузите Конфигурацию.
    Этот метод вызывает этот объект Конфигурации обновить/перезагрузить его содержание зависящим от реализации способом. Например, если эта Конфигурация объектно-ориентированные памяти ее записи в файле, вызывая refresh может заставить файл быть перечитанным.
    Реализация по умолчанию этого метода ничего не делает. Этот метод должен быть переопределен, если работа обновления поддерживается реализацией.
    
    Броски:
    
    SecurityException - если у вызывающей стороны нет разрешения, чтобы обновить его Конфигурацию.

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Конфигурация класса

Вложенная Сводка Класса

Сводка конструктора

Сводка метода

Методы java.lang унаследованный от класса. Объект

Деталь конструктора

Конфигурация

Деталь метода

getConfiguration

setConfiguration

getInstance

getInstance

getInstance

getProvider

getType

getParameters

getAppConfigurationEntry

обновление