接口 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.net 中 Principal 的使用

返回 Principal 的 java.net 中的方法

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

java.security 中 Principal 的使用

实现 Principal 的 java.security 中的类

class	Identity 已过时。 不再使用此类。其功能已经由 java.security.KeyStore、java.security.cert 包和 java.security.Principal 取代。
class	IdentityScope 已过时。 此类不再被使用。其功能已经由 java.security.KeyStore、java.security.cert 包和 java.security.Principal 取代。
class	Signer 已过时。 将不再使用此类。其功能已由 java.security.KeyStore、java.security.cert 包和 java.security.Principal 所取代。

返回 Principal 的 java.security 中的方法

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

参数类型为 Principal 的 java.security 中的方法

Identity

IdentityScope.getIdentity(Principal principal) 已过时。 获取名称与指定的主体相同的身份。

参数类型为 Principal 的 java.security 中的构造方法

ProtectionDomain(CodeSource codesource, PermissionCollection permissions, ClassLoader classloader, Principal[] principals)
创建由给定的 CodeSource、Permissions、ClassLoader 和 Principal 数组限定的新 ProtectionDomain。

java.security.acl 中 Principal 的使用

java.security.acl 中 Principal 的子接口

interface

Group 此接口用于表示一个主体组。

返回 Principal 的 java.security.acl 中的方法

Principal

AclEntry.getPrincipal() 返回此 ACL 项将为其授予或拒绝权限的主体。

返回变量类型为 Principal 的类型的 java.security.acl 中的方法

Enumeration<? extends Principal>

Group.members() 返回此组中成员的枚举。

参数类型为 Principal 的 java.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.cert 中 Principal 的使用

返回 Principal 的 java.security.cert 中的方法

abstract Principal	X509CRL.getIssuerDN() 已过时，由 X509CRL.getIssuerX500Principal() 替代。
abstract Principal	X509Certificate.getIssuerDN() 已过时，由 X509Certificate.getIssuerX500Principal() 替代。
abstract Principal	X509Certificate.getSubjectDN() 已过时，由 X509Certificate.getSubjectX500Principal() 替代。

javax.management.remote 中 Principal 的使用

实现 Principal 的 javax.management.remote 中的类

class

JMXPrincipal JMX Remote API 的远程客户端的身份。

javax.net.ssl 中 Principal 的使用

返回 Principal 的 javax.net.ssl 中的方法

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

参数类型为 Principal 的 javax.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.auth 中 Principal 的使用

类型参数类型为 Principal 的 javax.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。

类型变量类型为 Principal 的 javax.security.auth 中的构造方法参数

Subject(boolean readOnly, Set<? extends Principal> principals, Set<?> pubCredentials, Set<?> privCredentials)
创建带有 Principal 和证书的 Subject 的实例。

javax.security.auth.kerberos 中 Principal 的使用

实现 Principal 的 javax.security.auth.kerberos 中的类

class

KerberosPrincipal 此类封装 Kerberos 主体。

javax.security.auth.x500 中 Principal 的使用

实现 Principal 的 javax.security.auth.x500 中的类

class

X500Principal 此类表示一个 X.500 Principal。

javax.security.cert 中 Principal 的使用

返回 Principal 的 javax.security.cert 中的方法

abstract Principal	X509Certificate.getIssuerDN() 获取证书的 issuer（发布方的标识名）值。
abstract Principal	X509Certificate.getSubjectDN() 获取证书的 subject（主体的标识名）值。

javax.xml.ws 中 Principal 的使用

返回 Principal 的 javax.xml.ws 中的方法

Principal

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