Subject

Subject

Subject ()

使用 Subject的空白 Set创建 Subject的实例，并清空公共和专用凭证的集合。

新构建的集合检查此Subject在允许后续修改之前是否已设置为只读。 新创建的套件还通过确保呼叫者拥有足够的权限来防止非法修改。

要修改校长集，来电者必须有AuthPermission("modifyPrincipals") 。 要修改公共证书Set，来电者必须有AuthPermission("modifyPublicCredentials") 。 要修改私人凭证Set，来电者必须有AuthPermission("modifyPrivateCredentials") 。

Subject

Subject (boolean readOnly, 
                Set<? extends Principal> principals, 
                Set<?> pubCredentials, 
                Set<?> privCredentials)

使用Principals和凭证创建 Subject的实例。

来自指定集合的委托人和凭证被复制到新构建的集合中。 这些新创建的集合检查此Subject在允许后续修改之前是否已设置为只读。 新创建的套件还通过确保呼叫者拥有足够的权限来防止非法修改。

要修改校长集，来电者必须有AuthPermission("modifyPrincipals") 。 要修改公共证书Set，来电者必须有AuthPermission("modifyPublicCredentials") 。 要修改私人证书Set，来电者必须有AuthPermission("modifyPrivateCredentials") 。

doAs

T doAs (Subject subject, 
                PrivilegedExceptionAction<T> action)

以特定的 Subject执行工作 Subject 。

此方法首先通过AccessController.getContext检索当前线程的AccessControlContext ，然后使用检索的上下文和新的SubjectDomainCombiner （使用提供的Subject ）实例化新的AccessControlContext 。 最后，这个方法调用AccessController.doPrivileged ，传递它提供的PrivilegedExceptionAction ，以及新构建的AccessControlContext 。

doAs

T doAs (Subject subject, 
                PrivilegedAction<T> action)

以特定的 Subject执行工作 Subject 。

此方法首先通过AccessController.getContext检索当前线程的AccessControlContext ，然后使用检索到的上下文和新的SubjectDomainCombiner （使用提供的Subject ）实例化新的AccessControlContext 。 最后，这个方法调用AccessController.doPrivileged ，传递它提供的PrivilegedAction ，以及新构建的AccessControlContext 。

doAsPrivileged

T doAsPrivileged (Subject subject, 
                PrivilegedExceptionAction<T> action, 
                AccessControlContext acc)

执行特殊工作作为特定的 Subject 。

此方法的行为与Subject.doAs完全相同，不同之处在于不使用检索当前线程的AccessControlContext ，而是使用提供的AccessControlContext 。 如果提供的AccessControlContext是null ，则此方法使用一个空的ProtectionDomain集实例化一个新的AccessControlContext 。

doAsPrivileged

T doAsPrivileged (Subject subject, 
                PrivilegedAction<T> action, 
                AccessControlContext acc)

执行特殊工作作为特定的 Subject 。

此方法的行为与Subject.doAs完全相同，只是它不使用检索当前线程的AccessControlContext ，而是使用提供的AccessControlContext 。 如果提供的AccessControlContext为null ，则此方法使用一个空的ProtectionDomain集实例化新的AccessControlContext 。

equals

boolean equals (Object o)

将指定的Object与此Subject进行比较以获得相等性。 如果给定对象也是一个主题和两个返回true Subject实例是等价的。 更正式地说，两名Subject如果它们的实例都是平等Principal个Credential集合相等。

getPrincipals

Set<Principal> getPrincipals ()

返回与此Subject相关的Set负责Subject 。 每个Principal代表这个Subject的身份。

返回的Set由此主题的内部Principal Set 。 对返回的Set进行的任何修改Set影响内部Principal Set 。

getPrincipals

Set<T> getPrincipals (Class<T> c)

返回 Set与此 Subject关联的Principals的 Subject ，它们是指定的 Class实例或子类。

The returned Set is not backed by this Subject's internal Principal Set. A new Set is created and returned for each method invocation. Modifications to the returned Set will not affect the internal Principal Set.

getPrivateCredentials

Set<T> getPrivateCredentials (Class<T> c)

返回与此 Subject关联的 Set个私人凭证，它们是指定的 Class实例或子类。

调用者必须有权访问所有请求的凭证，否则将抛出 SecurityException 。

返回的Set不受本主题的内部专用证书Set 。 为每个方法调用创建并返回一个新的Set 。 对返回的Set修改不会影响内部专用证书Set 。

getPrivateCredentials

Set<Object> getPrivateCredentials ()

返回 Set的私人凭证的 Subject 。

返回的Set由此主题的内部专用证书Set 。 对返回的Set任何修改Set影响到内部私人凭证Set 。

来电者需要权限才能访问返回的Set的凭证，或者要修改Set本身。 如果调用者没有适当的权限，则会引发SecurityException 。

While iterating through the Set, a SecurityException is thrown if the caller does not have permission to access a particular Credential. The Iterator is nevertheless advanced to next element in the Set.

getPublicCredentials

Set<Object> getPublicCredentials ()

退还 Set的公共证书的 Subject 。

返回的Set由此主题的内部公共凭证Set 。 对返回的Set进行的任何修改Set影响内部公共证书Set 。

getPublicCredentials

Set<T> getPublicCredentials (Class<T> c)

返回一个 Set与此相关的公开证书 Subject是实例或指定的子类 Class 。

返回的Set不支持此主题的内部公共凭证Set 。 为每个方法调用创建并返回一个新的Set 。 对返回的Set修改不会影响公共证书Set 。

getSubject

Subject getSubject (AccessControlContext acc)

获取与提供的 Subject关联的 AccessControlContext 。

AccessControlContext可能包含许多主题（来自嵌套的doAs调用）。 在这种情况下，最近Subject与相关AccessControlContext返回。

hashCode

int hashCode ()

返回此 Subject的哈希 Subject 。

isReadOnly

boolean isReadOnly ()

Query whether this Subject is read-only.

setReadOnly

void setReadOnly ()

将此 Subject设置为只读。

本主题的Principal Set和凭证集的修改（添加和删除）将被禁止。 对该主题凭据的destroy操作仍将被允许。

随后尝试修改主题的Principal和凭证集将导致引发IllegalStateException 。 另外，一旦Subject是只读的，它就不能被重置为可再次写入。

toString

String toString ()

返回此 Subject的字符串表示 Subject 。