Policy (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

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 的目录。

构造方法摘要
protected	Policy()           已过时。 惟一的构造方法。

 

方法摘要
abstract  PermissionCollection	getPermissions(Subject subject, CodeSource cs)           已过时。 检索授予与指定的 CodeSource 关联的 Principals 的 Permissions。
static Policy	getPolicy()           已过时。 返回安装的 Policy 对象。
abstract  void	refresh()           已过时。 刷新/重新加载 Policy。
static void	setPolicy(Policy policy)           已过时。 设置系统级 Policy 对象。

 

从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

 

构造方法详细信息

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 的权限。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。