ConfigFile (Java SE 9 & JDK 9 )

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.lang.System属性java.security.auth.login.config也可以设置为指向另一个登录配置文件（在运行时用户使用-D开关的情况下）的URL 。如果定义了此属性，并且安全属性文件（Security属性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 ， security properties

Nested Class Summary
- Nested classes/interfaces inherited from class javax.security.auth.login.Configuration
  Configuration.Parameters

构造方法摘要

构造方法
Constructor	描述
`ConfigFile()`	创建一个新的 `Configuration`对象。
`ConfigFile(URI uri)`	从指定的 `URI`创建一个新的 `Configuration`对象。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	方法	描述
`AppConfigurationEntry[]`	`getAppConfigurationEntry(String applicationName)`	使用应用程序名称作为索引从 `Configuration`检索条目。
`void`	`refresh()`	通过重新读取所有登录配置刷新并重新加载 `Configuration` 。

Methods inherited from class javax.security.auth.login.Configuration
getConfiguration, getInstance, getInstance, getInstance, getParameters, getProvider, getType, setConfiguration

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造方法详细信息
  - ConfigFile
```
public ConfigFile()
```
    创建一个新的 Configuration对象。
    
    异常
    
    SecurityException - 如果 Configuration无法初始化
  - ConfigFile
```
public ConfigFile(URI uri)
```
    从指定的 URI创建一个新的 Configuration对象。
    
    参数
    
    uri - URI
    
    异常
    
    SecurityException - 如果 Configuration无法初始化
    
    NullPointerException - 如果 uri为空
- 方法详细信息
  - getAppConfigurationEntry
```
public AppConfigurationEntry[] getAppConfigurationEntry(String applicationName)
```
    使用应用程序名称作为索引从 Configuration检索条目。
    
    Specified by:
    
    getAppConfigurationEntry在 Configuration
    
    参数
    
    applicationName - 用于索引 Configuration的名称
    
    结果
    
    一个 AppConfigurationEntry阵列，对应于此应用程序的 LoginModule的堆叠配置，如果此应用程序没有配置 LoginModule s， LoginModule null。
  - refresh
```
public void refresh()
```
    刷新并重新加载 Configuration ，重新读取所有登录配置。
    
    重写：
    
    refresh在 Configuration
    
    异常
    
    SecurityException - if the caller does not have permission to refresh the Configuration