接口的使用
java.security.Principal

使用 Principal 的包

包	描述
com.sun.net.httpserver	提供简单的高级 Http 服务 API，可用于构建嵌入式 HTTP 服务。
com.sun.security.auth	提供 Principal 的实现。
java.net	提供用于实现网络应用程序的类。
java.nio.file.attribute	提供对文件和文件系统属性的访问的接口和类。
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	此包包含应用于将 X500 Principal 和 X500 Private Credentials 存储在Subject.
javax.security.cert	提供公钥证书类。

Principal 在 com.sun.net.httpserver 中的用法

com.sun.net.httpserver 中实现 Principal 的类

修饰符和类型	类	描述
class	HttpPrincipal	表示通过 HTTP Basic 或 Digest 身份验证进行身份验证的用户。

Principal 在 com.sun.security.auth 中的用法

com.sun.security.auth 中实现 Principal 的类

修饰符和类型	类	描述
final class	LdapPrincipal	由 RFC 2253 指定的专有名称标识的主体。
class	NTDomainPrincipal	此类实现 Principal 接口并表示用户在其中进行身份验证的 Windows NT 域的名称。
class	NTSid	此类实现 Principal 接口并表示有关 Windows NT 用户、组或领域的信息。
class	NTSidDomainPrincipal	此类扩展 NTSid 并表示 Windows NT 用户的域 SID。
class	NTSidGroupPrincipal	此类扩展 NTSid 并表示 Windows NT 用户所属的组之一。
class	NTSidPrimaryGroupPrincipal	此类扩展 NTSid 并表示 Windows NT 用户的主要组 SID。
class	NTSidUserPrincipal	此类扩展 NTSid 并表示 Windows NT 用户的 SID。
class	NTUserPrincipal	此类实现 Principal 接口并表示 Windows NT 用户。
class	UnixNumericGroupPrincipal	此类实现 Principal 接口并表示用户的 Unix 组标识号 (GID)。
class	UnixNumericUserPrincipal	此类实现 Principal 接口并表示用户的 Unix 标识号 (UID)。
class	UnixPrincipal	此类实现了 Principal 接口并表示一个 Unix 用户。
final class	UserPrincipal	由用户名或帐户名标识的用户主体。

Principal 在 java.net 中的用法

java.net 中返回 Principal 的方法

修饰符和类型	方法	描述
abstract Principal	SecureCacheResponse.getLocalPrincipal()	返回在检索网络资源的原始连接中握手期间发送到服务的主体。
abstract Principal	SecureCacheResponse.getPeerPrincipal()	返回服务的主体，该主体是在检索网络资源的原始连接期间作为定义会话的一部分而建立的。

Principal 在 java.nio.file.attribute 中的用法

java.nio.file.attribute 中 Principal 的子接口

修饰符和类型	接口	描述
interface	GroupPrincipal	UserPrincipal 表示 group identity ，用于确定对文件系统中对象的访问权限。
interface	UserPrincipal	Principal 表示用于确定对文件系统中对象的访问权限的标识。

Principal 在 java.security 中的用法

java.security 中实现 Principal 的类

修饰符和类型	类	描述
class	Identity	已弃用，将被删除：此 API 元素可能会在未来版本中删除。 此类已弃用，并可能在 Java SE 的未来版本中删除。
class	IdentityScope	已弃用，将被删除：此 API 元素可能会在未来版本中删除。 此类已弃用，并可能在 Java SE 的未来版本中删除。
class	Signer	已弃用，将被删除：此 API 元素可能会在未来版本中删除。 此类已弃用，并可能在 Java SE 的未来版本中删除。

java.security 中返回 Principal 的方法

修饰符和类型	方法	描述
Principal	Certificate.getGuarantor()	已弃用，将被删除：此 API 元素可能会在未来版本中删除。 返回证书的担保人，即保证与该证书关联的公钥是与该证书关联的委托人的委托人。
Principal	Certificate.getPrincipal()	已弃用，将被删除：此 API 元素可能会在未来版本中删除。 返回由担保人担保的委托人-密钥对的委托人。
final Principal[]	ProtectionDomain.getPrincipals()	返回此域的主体数组。

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

修饰符和类型	方法	描述
Identity	IdentityScope.getIdentity(Principal principal)	已弃用，将被删除：此 API 元素可能会在未来版本中删除。 检索名称与指定主体相同的Identity。

java.security 中的构造函数，参数类型为 Principal

修饰符	构造方法	描述
	ProtectionDomain(CodeSource codesource, PermissionCollection permissions, ClassLoader classloader, Principal[] principals)	创建一个由给定的 CodeSource、权限、ClassLoader 和主体数组限定的新 ProtectionDomain。

Principal 在 java.security.cert 中的用法

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

修饰符和类型	方法	描述
abstract Principal	X509Certificate.getIssuerDN()	已弃用。 请改用 X509Certificate.getIssuerX500Principal() 。
abstract Principal	X509CRL.getIssuerDN()	已弃用。 请改用 X509CRL.getIssuerX500Principal() 。
abstract Principal	X509Certificate.getSubjectDN()	已弃用。 请改用 X509Certificate.getSubjectX500Principal() 。

Principal 在 javax.management.remote 中的用法

javax.management.remote 中实现 Principal 的类

修饰符和类型	类	描述
class	JMXPrincipal	JMX 远程 API 的远程客户端的身份。

Principal 在 javax.net.ssl 中的用法

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

修饰符和类型	方法	描述
Principal	HandshakeCompletedEvent.getLocalPrincipal()	返回握手期间发送给对等方的委托人。
Principal	HttpsURLConnection.getLocalPrincipal()	返回握手期间发送到服务的主体。
Principal	SSLSession.getLocalPrincipal()	返回握手期间发送给对等方的委托人。
Principal	HandshakeCompletedEvent.getPeerPrincipal()	返回作为定义会话的一部分而建立的对等方的身份。
Principal	HttpsURLConnection.getPeerPrincipal()	返回作为定义会话的一部分而建立的服务主体。
Principal	SSLSession.getPeerPrincipal()	返回作为定义会话的一部分而建立的对等方的身份。

javax.net.ssl 中的方法，参数类型为 Principal

修饰符和类型	方法	描述
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)	在给定公钥类型和对等方认可的证书颁发机构列表（如果有）的情况下，获取用于验证安全套接字服务端的匹配别名。

Principal 在 javax.security.auth 中的用法

javax.security.auth 中的方法，类型参数类型为 Principal

修饰符和类型	方法	描述
<T extends Principal> Set<T>	Subject.getPrincipals(Class<T> c)	返回与此 Subject 关联的主体的 Set，它们是指定的 Class 的实例或子类。

返回类型中包含 Principal 类型参数的 javax.security.auth 中的方法

修饰符和类型	方法	描述
Set<Principal>	Subject.getPrincipals()	返回与此 Subject 关联的委托人的 Set。

javax.security.auth 中的构造函数参数，类型参数为 Principal

修饰符	构造方法	描述
	Subject(boolean readOnly, Set<? extends Principal> principals, Set<?> pubCredentials, Set<?> privCredentials)	使用主体和凭据创建 Subject 的实例。

Principal 在 javax.security.auth.kerberos 中的用法

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

修饰符和类型	类	描述
final class	KerberosPrincipal	此类封装了 Kerberos 主体。

Principal 在 javax.security.auth.x500 中的用法

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

修饰符和类型	类	描述
final class	X500Principal	这个类代表一个 X.500 Principal 。

Principal 在 javax.security.cert 中的用法

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

修饰符和类型	方法	描述
abstract Principal	X509Certificate.getIssuerDN()	已弃用，将被删除：此 API 元素可能会在未来版本中删除。 从证书中获取 issuer（颁发者专有名称）值。
abstract Principal	X509Certificate.getSubjectDN()	已弃用，将被删除：此 API 元素可能会在未来版本中删除。 从证书中获取 subject（使用者专有名称）值。