JavaTM Platform
Standard Ed. 6

接口 java.security.Principal
的使用

使用 Principal 的软件包
java.net 为实现网络应用程序提供类。 
java.security 为安全框架提供类和接口。 
java.security.acl 此包中的类和接口已经被 java.security 包中的类取代。 
java.security.cert 提供用于解析和管理证书、证书撤消列表 (CRL) 和证书路径的类和接口。 
javax.management.remote 对 JMX MBean 服务器进行远程访问使用的接口。 
javax.net.ssl 提供用于安全套接字包的类。 
javax.security.auth 此包提供用于进行验证和授权的框架。 
javax.security.auth.kerberos 此包包含与 Kerberos 网络验证协议相关的实用工具类。 
javax.security.auth.x500 此包包含应该用来在 Subject 中存储 X500 Principal 和 X500 Private Crendentials 的类。 
javax.security.cert 为公钥证书提供类。 
javax.xml.ws 此包包含核心 JAX-WS API。 
 

java.netPrincipal 的使用
 

返回 Principaljava.net 中的方法
abstract  Principal SecureCacheResponse.getLocalPrincipal()
          返回在获得了网络资源的初始连接中的联络期间发送到服务器的主体。
abstract  Principal SecureCacheResponse.getPeerPrincipal()
          返回服务器的主体,该主体是作为在获得了网络资源的初始连接期间定义会话的一部分建立的。
 

java.securityPrincipal 的使用
 

实现 Principaljava.security 中的类
 class Identity
          已过时。 不再使用此类。其功能已经由 java.security.KeyStorejava.security.cert 包和 java.security.Principal 取代。
 class IdentityScope
          已过时。 此类不再被使用。其功能已经由 java.security.KeyStorejava.security.cert 包和 java.security.Principal 取代。
 class Signer
          已过时。 将不再使用此类。其功能已由 java.security.KeyStorejava.security.cert 包和 java.security.Principal 所取代。
 

返回 Principaljava.security 中的方法
 Principal Certificate.getGuarantor()
          已过时。 返回证书的保证人,即某个主体,其保证与此证书关联的公钥是与此证书关联的主体的公钥。
 Principal Certificate.getPrincipal()
          已过时。 返回保证人所保证的主体密钥对的主体。
 Principal[] ProtectionDomain.getPrincipals()
          返回此域的 principals 数组。
 

参数类型为 Principaljava.security 中的方法
 Identity IdentityScope.getIdentity(Principal principal)
          已过时。 获取名称与指定的主体相同的身份。
 

参数类型为 Principaljava.security 中的构造方法
ProtectionDomain(CodeSource codesource, PermissionCollection permissions, ClassLoader classloader, Principal[] principals)
          创建由给定的 CodeSource、Permissions、ClassLoader 和 Principal 数组限定的新 ProtectionDomain。
 

java.security.aclPrincipal 的使用
 

java.security.aclPrincipal 的子接口
 interface Group
          此接口用于表示一个主体组。
 

返回 Principaljava.security.acl 中的方法
 Principal AclEntry.getPrincipal()
          返回此 ACL 项将为其授予或拒绝权限的主体。
 

返回变量类型为 Principal 的类型的 java.security.acl 中的方法
 Enumeration<? extends Principal> Group.members()
          返回此组中成员的枚举。
 

参数类型为 Principaljava.security.acl 中的方法
 boolean Acl.addEntry(Principal caller, AclEntry entry)
          向此 ACL 中添加 ACL 项。
 boolean Group.addMember(Principal user)
          向组中添加指定的成员。
 boolean Owner.addOwner(Principal caller, Principal owner)
          添加一个所有者。
 boolean Acl.checkPermission(Principal principal, Permission permission)
          检查指定的主体是否具有指定的权限。
 boolean Owner.deleteOwner(Principal caller, Principal owner)
          删除一个所有者。
 Enumeration<Permission> Acl.getPermissions(Principal user)
          返回一个指定主体(表示一个实体,如个体或组)的许可权限集合的枚举。
 boolean Group.isMember(Principal member)
          如果传递的主体是组的一个成员,则返回 true。
 boolean Owner.isOwner(Principal owner)
          如果给定的主体是该 ACL 的所有者,则返回 true。
 boolean Acl.removeEntry(Principal caller, AclEntry entry)
          从此 ACL 中移除 ACL 项。
 boolean Group.removeMember(Principal user)
          从组中移除指定的成员。
 void Acl.setName(Principal caller, String name)
          设置此 ACL 的名称。
 boolean AclEntry.setPrincipal(Principal user)
          指定此 ACL 项要为其授予或拒绝权限的主体。
 

java.security.certPrincipal 的使用
 

返回 Principaljava.security.cert 中的方法
abstract  Principal X509CRL.getIssuerDN()
          已过时,由 X509CRL.getIssuerX500Principal() 替代。
abstract  Principal X509Certificate.getIssuerDN()
          已过时,由 X509Certificate.getIssuerX500Principal() 替代。
abstract  Principal X509Certificate.getSubjectDN()
          已过时,由 X509Certificate.getSubjectX500Principal() 替代。
 

javax.management.remotePrincipal 的使用
 

实现 Principaljavax.management.remote 中的类
 class JMXPrincipal
          JMX Remote API 的远程客户端的身份。
 

javax.net.sslPrincipal 的使用
 

返回 Principaljavax.net.ssl 中的方法
 Principal HandshakeCompletedEvent.getLocalPrincipal()
          返回握手期间发送到同位体的主体。
 Principal SSLSession.getLocalPrincipal()
          返回握手期间发送给同位体的主体。
 Principal HttpsURLConnection.getLocalPrincipal()
          返回握手期间发送到服务器的主体。
 Principal HandshakeCompletedEvent.getPeerPrincipal()
          返回同位体的标识,同位体是作为定义会话的一部分而建立的。
 Principal SSLSession.getPeerPrincipal()
          返回同级身份,该同级身份是作为定义会话的一部分而建立的。
 Principal HttpsURLConnection.getPeerPrincipal()
          返回服务器的主体,它是作为定义会话的一部分而建立的。
 

参数类型为 Principaljavax.net.ssl 中的方法
 String X509KeyManager.chooseClientAlias(String[] keyType, Principal[] issuers, Socket socket)
          根据给定公钥类型和同位体识别的证书发行者授权机构列表(如果有),选择用于验证安全套接字客户端的别名。
 String X509ExtendedKeyManager.chooseEngineClientAlias(String[] keyType, Principal[] issuers, SSLEngine engine)
          选择别名,对给出公钥类型的 SSLEngine 连接的客户端和由同位体(如果有)识别的证书发行者授权列表进行验证。
 String X509ExtendedKeyManager.chooseEngineServerAlias(String keyType, Principal[] issuers, SSLEngine engine)
          选择别名,对给出公钥类型的 SSLEngine 连接的服务器和由同位体(如果有)识别的证书发行者授权列表进行验证。
 String X509KeyManager.chooseServerAlias(String keyType, Principal[] issuers, Socket socket)
          根据给定公钥类型和同位体识别的证书发行者授权机构列表(如果有),选择用于验证安全套接字服务器端的别名。
 String[] X509KeyManager.getClientAliases(String keyType, Principal[] issuers)
          根据给定公钥类型和同位体识别的证书发行者授权机构列表(如果有),获取用于验证安全套接字客户端的匹配别名。
 String[] X509KeyManager.getServerAliases(String keyType, Principal[] issuers)
          根据给定公钥类型和同位体识别的证书发行者授权机构列表(如果有),获取用于验证安全套接字服务器端的别名。
 

javax.security.authPrincipal 的使用
 

类型参数类型为 Principaljavax.security.auth 中的方法
<T extends Principal>
Set<T>
Subject.getPrincipals(Class<T> c)
          返回与此 Subject 关联的 Principal Set,它是指定的 Class 的实例或子类。
 

返回变量类型为 Principal 的类型的 javax.security.auth 中的方法
 Set<Principal> Subject.getPrincipals()
          返回与此 Subject 关联的 Principal Set
 

类型变量类型为 Principaljavax.security.auth 中的构造方法参数
Subject(boolean readOnly, Set<? extends Principal> principals, Set<?> pubCredentials, Set<?> privCredentials)
          创建带有 Principal 和证书的 Subject 的实例。
 

javax.security.auth.kerberosPrincipal 的使用
 

实现 Principaljavax.security.auth.kerberos 中的类
 class KerberosPrincipal
          此类封装 Kerberos 主体。
 

javax.security.auth.x500Principal 的使用
 

实现 Principaljavax.security.auth.x500 中的类
 class X500Principal
           此类表示一个 X.500 Principal
 

javax.security.certPrincipal 的使用
 

返回 Principaljavax.security.cert 中的方法
abstract  Principal X509Certificate.getIssuerDN()
          获取证书的 issuer(发布方的标识名)值。
abstract  Principal X509Certificate.getSubjectDN()
          获取证书的 subject(主体的标识名)值。
 

javax.xml.wsPrincipal 的使用
 

返回 Principaljavax.xml.ws 中的方法
 Principal WebServiceContext.getUserPrincipal()
          返回标识当前正服务请求发送方的 Principal。
 


JavaTM Platform
Standard Ed. 6

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

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