Java javax.security.auth 类 Policy（JDK5）

所有类

javax.security.auth
类 Policy

java.lang.Object
  javax.security.auth.Policy

        public PermissionCollection getPermissions
            (java.security.ProtectionDomain pd)
 
 

        public ProtectionDomain
            (CodeSource cs,
             PermissionCollection permissions,
             ClassLoader loader,
             Principal[] principals)
 

@Deprecated
public abstract class Policy
   
   
   
   
   
extends Object
   
   
   
   
   

这是用于表示基于 Subject 授权的系统策略的抽象类。此类的子类实现提供一种方式来指定一个基于 Subject 的访问控制 Policy。

可以通过以下方式查询 Policy 对象，查找授予作为 Principal 运行的代码的 Permission 集合：

        policy = Policy.getPolicy();
        PermissionCollection perms = policy.getPermissions(subject,
                                                        codeSource);
 

Policy 包含下面的信息。注意，此例子只表示默认的 Policy 实现的语法。此类的子类实现可以实现替代语法，也可以根据任何如文件、数据库或服务器之类的源检索 Policy。

Policy 中的每一项表示为一个 grant 条目。每个 grant 条目指定代码基、代码签名者和 Principals 三元组，以及授予该三元组的 Permissions。

        grant CodeBase ["URL"], Signedby ["signers"],
              Principal [Principal_Class] "Principal_Name" {
            Permission Permission_Class ["Target_Name"]
                                        [, "Permission_Actions"]
                                        [, signedBy "SignerName"];
        };
 

        grant CodeBase "foo.com", Signedby "foo",
              Principal com.sun.security.auth.SolarisPrincipal "duke" {
            permission java.io.FilePermission "/home/duke", "read, write";
        };
 

为了作为一个特定的 Principal“运行”，代码调用 Subject.doAs(subject, ...) 方法。调用该方法后，代码作为与指定的 Subject 相关联的所有 Principals 运行。注意，只在调用 Subject.doAs 之后，此 Policy（以及在此 Policy 中授予的 Permission）才有效。

多个 Principals 可以列在一个 grant 条目中。在 grant 条目中的所有 Principals 必须与提供给 Subject.doAs 的 Subject 相关联，以便授予该 Subject 指定的 Permissions。

        grant Principal com.sun.security.auth.SolarisPrincipal "duke",
              Principal com.sun.security.auth.SolarisNumericUserPrincipal "0" {
            permission java.io.FilePermission "/home/duke", "read, write";
            permission java.net.SocketPermission "duke.com", "connect";
        };
 

注意，在此 Policy 中不允许非基于 Principal 的 grant 条目。因此，像下面这样的 grant 条目：

        grant CodeBase "foo.com", Signedby "foo" {
            permission java.io.FilePermission "/tmp/scratch", "read, write";
        };
 

可以通过把 "auth.policy.provider" 安全属性（在 Java 安全属性文件中）的值设置为所需的 Policy 实现类的完全限定名，从而改变默认的 Policy 实现。Java 安全属性文件位于名称为 <JAVA_HOME>/lib/security/java.security 的文件中，其中 <JAVA_HOME> 是指安装 JDK 的目录。

Policy

protected Policy()

已过时。 

惟一的构造方法。（由子类构造方法调用，通常是隐式的）。

getPolicy

public static Policy getPolicy()

已过时。 

返回安装的 Policy 对象。此方法首先通过 AuthPermission("getPolicy") 权限调用 SecurityManager.checkPermission ，以确保调用方具有获取 Policy 对象的权限。

返回：

安装的 Policy。返回值不能为 null。

抛出：

SecurityException - 如果当前线程不具有获取此 Policy 对象的权限。

另请参见：

setPolicy(javax.security.auth.Policy)

setPolicy

public static void setPolicy(Policy policy)

已过时。 

设置系统级 Policy 对象。此方法首先通过 AuthPermission("setPolicy") 权限调用 SecurityManager.checkPermission ，以确保调用方具有设置 Policy 对象的权限。

参数：

policy - 新的系统 Policy 对象。

抛出：

SecurityException - 如果当前线程不具有设置此 Policy 的权限。

另请参见：

getPolicy()

getPermissions

public abstract PermissionCollection getPermissions(Subject subject,
                                                    CodeSource cs)

已过时。 

检索授予与指定的 CodeSource 关联的 Principals 的 Permissions。

参数：

subject - 与此 Subject（主题）所关联的 Principal（主体）与提供的 CodeSource 共同确定此方法返回的 Permission。此参数可以为 null。

cs - 它的 CodeSource 所指定的代码，与提供的 CodeSource 一起使用，确定此方法返回的 Permissions。此参数可以为 null。

返回：

授予所有的 Subject 以及提供的 subject 和 cs 参数中指定的代码的 Permissions Collection。

refresh

public abstract void refresh()

已过时。 

刷新/重新加载 Policy。

此方法使该对象刷新/重新加载其当前 Policy。这是依赖于实现的。例如，如果 Policy 对象存储在文件中，调用 refresh 将会引起重新读取该文件。

抛出：

SecurityException - 如果调用方没有刷新此 Policy 的权限。