Policy (Java Platform SE 8 )

java.lang.Object
- java.security.Policy

```
public abstract class Policy
extends Object
```
政策对象是负责确定是否在java运行环境中执行代码的权限执行一个安全敏感的操作。
在运行时在任何给定的时间内只有一个策略对象。政策对象可以通过调用setPolicy方法安装。安装的政策对象可以通过调用getPolicy方法得到的。

如果没有政策对象已安装在运行时，调用getPolicy安装的默认策略实现的一个实例（这一抽象类的默认子类实现）。默认的政策的实施，可以通过设置的policy.provider安全属性的值为所需的策略子类实现的完全限定名称改变。

应用程序代码可以直接子类策略提供一个自定义的实现。此外，一个政策的对象的一个实例可以通过调用其中的getInstance工厂方法与标准型构造。默认类型是“javapolicy”政策。

一旦政策实例已安装（或默认，或致电setPolicy），java运行时调用它的implies方法时需要确定是否执行代码（封装在一个ProtectionDomain）可以执行要保护操作。如何检索其策略数据的策略数据取决于策略实现本身。政策是用来存储数据的，例如，在一个平坦的ASCII文件，在一个序列化的二进制文件的策略类，或在数据库中。

的refresh方法使政策对象刷新/重新加载数据。此操作是依赖于实现的。例如，如果政策对象存储其数据配置文件，调用refresh会使它重新读取配置策略文件。如果不支持刷新操作，则此方法不做任何操作。注意，刷新的政策不可能在一个特定的保护范围对类的影响。这是依赖的implies方法的政策提供者的实现及其PermissionCollection缓存策略。

另请参见：

Provider， ProtectionDomain， Permission， security properties

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static interface`	`Policy.Parameters` 这表示策略参数的一个标记接口。

Field Summary

Fields
Modifier and Type	Field and Description
`static PermissionCollection`	`UNSUPPORTED_EMPTY_COLLECTION` 一个只读空PermissionCollection实例。

构造方法摘要

构造方法

Constructor and Description

Policy()

构造方法
Constructor and Description
`Policy()`

方法摘要

所有方法静态方法接口方法具体的方法
Modifier and Type	Method and Description
`static Policy`	`getInstance(String type, Policy.Parameters params)` 返回指定类型的策略对象。
`static Policy`	`getInstance(String type, Policy.Parameters params, Provider provider)` 返回指定类型的策略对象。
`static Policy`	`getInstance(String type, Policy.Parameters params, String provider)` 返回指定类型的策略对象。
`Policy.Parameters`	`getParameters()` 返回策略参数。
`PermissionCollection`	`getPermissions(CodeSource codesource)` 返回一个包含授予指定权限集PermissionCollection CodeSource对象。
`PermissionCollection`	`getPermissions(ProtectionDomain domain)` 返回一个包含授予指定权限集PermissionCollection客体保护范围。
`static Policy`	`getPolicy()` 返回已安装的策略对象。
`Provider`	`getProvider()` 返回此策略的提供程序。
`String`	`getType()` 返回此策略的类型。
`boolean`	`implies(ProtectionDomain domain, Permission permission)` 对全球政策的权限授予ProtectionDomain是否授予权限。
`void`	`refresh()` 刷新/重新加载策略配置。
`static void`	`setPolicy(Policy p)` 设置系统范围的策略对象。

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

- Field Detail
  - UNSUPPORTED_EMPTY_COLLECTION
```
public static final PermissionCollection UNSUPPORTED_EMPTY_COLLECTION
```
    一个只读空PermissionCollection实例。
    
    从以下版本开始：
    
    一点六
- Constructor Detail
  - Policy
```
public Policy()
```
- 方法详细信息
  - getPolicy
```
public static Policy getPolicy()
```
    返回已安装的策略对象。这个值不应该被缓存，因为它可能会改变一个电话 setPolicy。该方法首先调用 SecurityManager.checkPermission与 SecurityPermission("getPolicy")权限以确保可以获得政策对象。
    
    结果
    
    已安装的策略。
    
    异常
    
    SecurityException -如果存在一个安全管理及其 checkPermission方法不允许获得政策对象。
    
    另请参见：
    
    SecurityManager.checkPermission(Permission)， setPolicy(java.security.Policy)
  - setPolicy
```
public static void setPolicy(Policy p)
```
    设置系统范围的策略对象。该方法首先调用 SecurityManager.checkPermission与 SecurityPermission("setPolicy")权限以确保可以设定政策。
    
    参数
    
    p -新制度的政策目标。
    
    异常
    
    SecurityException -如果存在一个安全管理及其 checkPermission方法不允许设置策略。
    
    另请参见：
    
    SecurityManager.checkPermission(Permission)， getPolicy()
  - getInstance
```
public static Policy getInstance(String type,
                                 Policy.Parameters params)
                          throws NoSuchAlgorithmException
```
    返回指定类型的策略对象。
    该方法通过注册安全提供商列表，从最开始的首选供应商。新政策的实施对象封装policyspi，支持指定类型的第一个提供程序返回。
    
    注意，注册商的列表可以通过Security.getProviders()检索方法。
    
    参数
    
    type -指定的政策类型。看到一个标准的政策类型的 Java Cryptography Architecture Standard Algorithm Name Documentation政策部分。
    
    params -政策参数，这可能是空的。
    
    结果
    
    新政策对象。
    
    异常
    
    SecurityException如果调用者没有权限指定类型的实例得到政策。
    
    NullPointerException -如果指定类型的空。
    
    IllegalArgumentException -如果指定的参数是不理解的policyspi实现从选定的供应商。
    
    NoSuchAlgorithmException -如果没有供应商的支持为指定的类型policyspi实施。
    
    从以下版本开始：
    
    一点六
    
    另请参见：
    
    Provider
  - getInstance
```
public static Policy getInstance(String type,
                                 Policy.Parameters params,
                                 String provider)
                          throws NoSuchProviderException,
                                 NoSuchAlgorithmException
```
    返回指定类型的策略对象。
    一个新的政策对象封装policyspi实现从指定的提供程序返回。指定的提供程序必须在提供者列表中注册。
    
    注意，注册商的列表可以通过Security.getProviders()检索方法。
    
    参数
    
    type -指定的政策类型。看到一个标准的政策类型的 Java Cryptography Architecture Standard Algorithm Name Documentation政策部分。
    
    params -政策参数，这可能是空的。
    
    provider -供应商。
    
    结果
    
    新政策对象。
    
    异常
    
    SecurityException如果调用者没有权限指定类型的实例得到政策。
    
    NullPointerException -如果指定类型的空。
    
    IllegalArgumentException -如果指定供应商是null或空，或者指定的参数是不理解的policyspi实现从指定的供应商。
    
    NoSuchProviderException -如果指定的供应商不在安全提供商注册名单。
    
    NoSuchAlgorithmException -如果指定的提供程序不支持指定类型的policyspi实施。
    
    从以下版本开始：
    
    一点六
    
    另请参见：
    
    Provider
  - getInstance
```
public static Policy getInstance(String type,
                                 Policy.Parameters params,
                                 Provider provider)
                          throws NoSuchAlgorithmException
```
    返回指定类型的策略对象。
    一个新的政策对象封装policyspi实现从指定的提供程序对象返回。请注意，指定的提供程序对象不必在提供者列表中注册。
    
    参数
    
    type -指定的政策类型。看到一个标准的政策类型的 Java Cryptography Architecture Standard Algorithm Name Documentation政策部分。
    
    params -政策参数，这可能是空的。
    
    provider -供应商。
    
    结果
    
    新政策对象。
    
    异常
    
    SecurityException如果调用者没有权限指定类型的实例得到政策。
    
    NullPointerException -如果指定类型的空。
    
    IllegalArgumentException -如果指定的提供程序是无效的，或者指定的参数是不理解的policyspi实现从指定的供应商。
    
    NoSuchAlgorithmException -如果指定的提供程序不支持指定类型的policyspi实施。
    
    从以下版本开始：
    
    一点六
    
    另请参见：
    
    Provider
  - getProvider
```
public Provider getProvider()
```
    返回此策略的提供程序。
    这一政策实例将只有通过电话Policy.getInstance得到供应商。否则，此方法返回空。
    
    结果
    
    此策略的提供程序或空。
    
    从以下版本开始：
    
    一点六
  - getType
```
public String getType()
```
    返回此策略的类型。
    这一政策实例将只有通过电话Policy.getInstance得到型。否则，此方法返回空。
    
    结果
    
    该策略的类型或空。
    
    从以下版本开始：
    
    一点六
  - getParameters
```
public Policy.Parameters getParameters()
```
    返回策略参数。
    这一政策实例将只有通过电话Policy.getInstance得到参数。否则，此方法返回空。
    
    结果
    
    政策参数或空。
    
    从以下版本开始：
    
    一点六
  - getPermissions
```
public PermissionCollection getPermissions(CodeSource codesource)
```
    返回一个包含授予指定权限集PermissionCollection CodeSource对象。
    应用程序不鼓励调用此方法，因为此操作可能不受所有策略实现的支持。应用程序应该仅仅依靠implies方法执行策略检查。如果一个应用程序必须调用一个getpermissions方法，它应该叫getPermissions(ProtectionDomain)。
    
    此方法的默认实现将返回policy.unsupported_empty_collection。该方法可以被重写，如果政策的实施可以返回一组权限授予CodeSource。
    
    参数
    
    codesource - CodeSource，返回PermissionCollection已授予。
    
    结果
    
    一组授予指定权限CodeSource。如果支持这个操作，返回的权限集必须是一个新的实例，它必须支持异构的权限类型。如果不支持该操作，policy.unsupported_empty_collection返回。
  - getPermissions
```
public PermissionCollection getPermissions(ProtectionDomain domain)
```
    返回一个包含授予指定权限集PermissionCollection客体保护范围。
    应用程序不鼓励调用此方法，因为此操作可能不受所有策略实现的支持。应用程序应该依靠implies方法执行策略检查。
    
    此方法的默认实现第一检索权限返回通过getPermissions(CodeSource)（CodeSource取自指定的保护范围），以及权限在指定的保护范围。所有这些权限相结合，并在一个新的PermissionCollection对象返回。如果getPermissions(CodeSource)返回policy.unsupported_empty_collection，那么这个方法返回包含在指定的保护范围中的一个新的PermissionCollection对象的权限。
    
    该方法可以被重写，如果政策实施支持返回一组授予权限保护范围。
    
    参数
    
    domain - ProtectionDomain，返回PermissionCollection已授予。
    
    结果
    
    一组权限授予指定的保护范围。如果支持这个操作，返回的权限集必须是一个新的实例，它必须支持异构的权限类型。如果不支持该操作，policy.unsupported_empty_collection返回。
    
    从以下版本开始：
    
    一点四
  - implies
```
public boolean implies(ProtectionDomain domain,
                       Permission permission)
```
    对全球政策的权限授予ProtectionDomain是否授予权限。
    
    参数
    
    domain - ProtectionDomain测试
    
    permission的权限对象进行测试的意义。
    
    结果
    
    如果“许可”是一个允许这种保护范围的子集。
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    ProtectionDomain
  - refresh
```
public void refresh()
```
    刷新/重新加载策略配置。这种方法的行为取决于实现。例如，调用 refresh在基于文件的政策将导致文件被重新读取。
    这种方法的默认实现不做任何事。这种方法应该重写如果刷新操作是由政策执行支持。

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class Policy

Nested Class Summary

Field Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Field Detail

UNSUPPORTED_EMPTY_COLLECTION

Constructor Detail

Policy

方法详细信息

getPolicy

setPolicy

getInstance

getInstance

getInstance

getProvider

getType

getParameters

getPermissions

getPermissions

implies

refresh