JavaTM Platform
Standard Ed. 6

javax.security.auth
类 AuthPermission

java.lang.Object
  继承者 java.security.Permission
      继承者 java.security.BasicPermission
          继承者 javax.security.auth.AuthPermission
所有已实现的接口:
Serializable, Guard

public final class AuthPermission
extends BasicPermission

此类用于验证权限。AuthPermission 包含一个名称(也称为“目标名称”),但没有动作列表;您并非一定拥有所指定的权限。

目标名称就是安全配置参数的名称(见下文)。目前 AuthPermission 对象可用来保护对 Policy、Subject、LoginContext 和 Configuration 对象的访问。

AuthPermission 的可能目标名称有:

        doAs -                  允许调用者调用
                                Subject.doAs 方法。

        doAsPrivileged -        允许调用者调用
                                Subject.doAsPrivileged 方法。

       getSubject - 允许获取与当前的 Thread 关联的一个或多个 Subject(主题)。               
                                
                                

        getSubjectFromDomainCombiner - 允许获取与 SubjectDomainCombiner 关联的 Subject。    
                                
                                

        setReadOnly - 允许调用者将 Subject 设置为只读。


        modifyPrincipals - 允许调用者修改与 Subject 关联的 Principals Set。



        modifyPublicCredentials - 允许调用者修改与 Subject 关联的公共证书 Set。



        modifyPrivateCredentials - 允许调用者修改与 Subject 关联的私有证书 Set。



       refreshCredential - 允许代码在一个实现了 Refreshable 接口的证书对象上调用 refresh 方法。        



        destroyCredential - 允许代码在一个实现了 Destroyable 接口的证书对象上调用 destroy 方法。       




        createLoginContext.{name} - 允许代码用指定的 name 实例化一个 LoginContext。name 可用作为安装的登录 Configuration(通过 Configuration.getConfiguration() 返回)中的索引。name 可以使用通配符(设置为 '*'),从而允许使用任何名称。


       getLoginConfiguration - 允许获取系统级登录 Configuration。

        createLoginConfiguration.{type} - 允许代码通过 Configuration.getInstance 获取 Configuration 对象。                            

       setLoginConfiguration - 允许设置系统级登录 Configuration。


        refreshLoginConfiguration - 允许刷新系统级登录 Configuration。

 

以下目标名称已过时,推荐使用 createLoginContext.{name}

        createLoginContext - 允许代码实例化一个 LoginContext

javax.security.auth.Policy 已过时,推荐使用 java.security.Policy。因此,以下目标名称也已经过时:

        getPolicy - 允许调用者获取系统级基于 Subject 的访问控制策略。


        setPolicy - 允许调用者设置系统级基于 Subject 的访问控制策略。


        refreshPolicy - 允许调用者刷新系统级基于 Subject 的访问控制策略。

另请参见:
序列化表格

构造方法摘要
AuthPermission(String name)
          创建具有指定名称的新 AuthPermission。
AuthPermission(String name, String actions)
          创建具有指定名称的新 AuthPermission 对象。
 
方法摘要
 
从类 java.security.BasicPermission 继承的方法
equals, getActions, hashCode, implies, newPermissionCollection
 
从类 java.security.Permission 继承的方法
checkGuard, getName, toString
 
从类 java.lang.Object 继承的方法
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

构造方法详细信息

AuthPermission

public AuthPermission(String name)
创建具有指定名称的新 AuthPermission。name 是 AuthPermission 的符号名。

参数:
name - AuthPermission 的名称
抛出:
NullPointerException - 如果 namenull
IllegalArgumentException - 如果 name 为空。

AuthPermission

public AuthPermission(String name,
                      String actions)
创建具有指定名称的新 AuthPermission 对象。name 是 AuthPermission 的符号名,并且 actions 字符串目前未使用,应该为 null。

参数:
name - AuthPermission 的名称

actions - 应该为 null。
抛出:
NullPointerException - 如果 namenull
IllegalArgumentException - 如果 name 为空。

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

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