compact1, compact2, compact3

java.security

Class Identity

java.lang.Object

java.security.Identity

All Implemented Interfaces:

Serializable， Principal

已知直接子类：

IdentityScope， Signer

过时的。

这个类不再使用。它的功能已经取代了java.security.KeyStore，java.security.cert包，和java.security.Principal。

@Deprecated
public abstract class Identity
extends Object
implements Principal, Serializable

这个类代表身份：真实世界的对象，如人，公司或组织的身份可以通过他们的公共密钥进行身份验证。身份也可能是更抽象的（或混凝土）结构，如守护线程或智能卡。

所有的标识对象都有一个名称和一个公钥。名字是不可变的。身份也可能范围。也就是说，如果指定了一个身份有特定的范围，那么在该范围内的身份的名称和公钥是唯一的。

身份也有一组证书（所有证明其自己的公共密钥）。在这些证书中指定的主要名称不必是相同的，只有键。

一个身份可以定义，包括邮政地址、电子邮件地址、电话号码、面孔和徽标图像，等等。

另请参见：

IdentityScope， Signer， Principal， Serialized Form

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	Identity() 过时的。 仅用于序列化的构造函数。
	Identity(String name) 过时的。 用指定的名称和无作用域构造一个标识。
	Identity(String name, IdentityScope scope) 过时的。 用指定的名称和范围构造一个标识。

方法摘要

Modifier and Type	Method and Description
void	addCertificate(Certificate certificate) 过时的。 为这个身份添加一个证书。
Certificate[]	certificates() 过时的。 返回此身份的所有证书的副本。
boolean	equals(Object identity) 过时的。 指定对象和此标识之间的相等性的测试。
String	getInfo() 过时的。 返回先前指定的此标识的一般信息。
String	getName() 过时的。 返回此身份的名称。
PublicKey	getPublicKey() 过时的。 返回此身份的公钥。
IdentityScope	getScope() 过时的。 返回此标识的范围。
int	hashCode() 过时的。 返回该身份的hashCode。
protected boolean	identityEquals(Identity identity) 过时的。 指定的身份和该身份之间的平等性的测试。
void	removeCertificate(Certificate certificate) 过时的。 从这个身份中移除一个证书。
void	setInfo(String info) 过时的。 指定此标识的通用信息字符串。
void	setPublicKey(PublicKey key) 过时的。 设置此身份的公共密钥。
String	toString() 过时的。 返回一个简短的字符串来描述这个身份，告诉它的名称和它的范围（如果有的话）。
String	toString(boolean detailed) 过时的。 返回该身份的字符串表示，随着更多的细节比随意的 toString方法提供不带任何参数。

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.security.Principal

implies

Constructor Detail

Identity

protected Identity()

过时的。

仅用于序列化的构造函数。

Identity

public Identity(String name,
                IdentityScope scope)
         throws KeyManagementException

过时的。

用指定的名称和范围构造一个标识。

参数

name -标识名称。

scope -身份的范围。

异常

KeyManagementException如果范围中具有相同名称的身份已经有了。

Identity

public Identity(String name)

过时的。

用指定的名称和无作用域构造一个标识。

参数

name -标识名称。

方法详细信息

getName

public final String getName()

过时的。

返回此身份的名称。

Specified by:

getName 接口 Principal

结果

这个身份的名称。

getScope

public final IdentityScope getScope()

过时的。

返回此标识的范围。

结果

这种身份的范围。

getPublicKey

public PublicKey getPublicKey()

过时的。

返回此身份的公钥。

结果

这个身份的公钥。

另请参见：

setPublicKey(java.security.PublicKey)

setPublicKey

public void setPublicKey(PublicKey key)
                  throws KeyManagementException

过时的。

设置此身份的公共密钥。旧的密钥和所有此身份的证书都被此操作删除。

首先，如果存在安全管理器，它的checkSecurityAccess方法被称为"setIdentityPublicKey"来看看是否可以设置公钥参数。

参数

key -这种身份的公钥。

异常

KeyManagementException -如果在身份范围的另一个身份具有相同的公共密钥，或者如果一个异常发生。

SecurityException -如果存在一个安全管理及其 checkSecurityAccess方法不允许设置公钥。

另请参见：

getPublicKey()， SecurityManager.checkSecurityAccess(java.lang.String)

setInfo

public void setInfo(String info)

过时的。

指定此标识的通用信息字符串。

首先，如果存在安全管理器，它的checkSecurityAccess方法被称为"setIdentityInfo"来看看是否可以指定信息的字符串参数。

参数

info -信息的字符串。

异常

SecurityException -如果存在一个安全管理及其 checkSecurityAccess方法不允许设置信息的字符串。

另请参见：

getInfo()， SecurityManager.checkSecurityAccess(java.lang.String)

getInfo

public String getInfo()

过时的。

返回先前指定的此标识的一般信息。

结果

关于这个身份的一般信息。

另请参见：

setInfo(java.lang.String)

addCertificate

public void addCertificate(Certificate certificate)
                    throws KeyManagementException

过时的。

为这个身份添加一个证书。如果身份有一个公钥，证书中的公钥必须是相同的，如果身份没有公钥，身份的公钥将被设置为在证书中指定的。

首先，如果存在安全管理器，它的checkSecurityAccess方法被称为"addIdentityCertificate"来看看是否可以将证书添加参数。

参数

certificate -证书被添加。

异常

KeyManagementException -如果证书是无效的，如果在证书中加入冲突，这种身份的公共密钥的公钥，或者另一个例外发生。

SecurityException -如果存在一个安全管理及其 checkSecurityAccess方法不允许添加证书。

另请参见：

SecurityManager.checkSecurityAccess(java.lang.String)

removeCertificate

public void removeCertificate(Certificate certificate)
                       throws KeyManagementException

过时的。

从这个身份中移除一个证书。

首先，如果存在安全管理器，它的checkSecurityAccess方法被称为"removeIdentityCertificate"作为是否可以删除证书的说法。

参数

certificate -证书被删除。

异常

KeyManagementException -如果证书丢失，或者如果一个异常发生。

SecurityException -如果存在一个安全管理及其 checkSecurityAccess方法不允许删除证书。

另请参见：

SecurityManager.checkSecurityAccess(java.lang.String)

certificates

public Certificate[] certificates()

过时的。

返回此身份的所有证书的副本。

结果

此身份的所有证书的副本。

equals

public final boolean equals(Object identity)

过时的。

指定对象和此标识之间的相等性的测试。这第一个测试，看看是否实体实际上指向同一个对象，在这种情况下，它返回。下一步，它检查实体是否有相同的名称和相同的范围。如果他们这样做，该方法返回真。否则，它要求 identityEquals，这类应重写。

Specified by:

equals 接口 Principal

重写：

equals 方法重写，继承类 Object

参数

identity -与此身份平等的测试对象。

结果

如果对象被认为是相等的，否则是错误的。

另请参见：

identityEquals(java.security.Identity)

identityEquals

protected boolean identityEquals(Identity identity)

过时的。

指定的身份和该身份之间的平等性的测试。这种方法应该被平等的子类的测试。默认的行为是返回真实的，如果名称和公共密钥是相等的。

参数

identity -身份与身份平等的测试。

结果

如果身份被认为是相等的，否则是错误的。

另请参见：

equals(java.lang.Object)

toString

public String toString()

过时的。

返回一个简短的字符串来描述这个身份，告诉它的名称和它的范围（如果有的话）。

首先，如果存在安全管理器，它的checkSecurityAccess方法被称为"printIdentity"作为是否可以返回字符串参数。

Specified by:

toString 接口 Principal

重写：

toString 方法重写，继承类 Object

结果

关于这个身份的信息，如它的名称和范围（如果有的话）的名称。

异常

SecurityException -如果存在一个安全管理及其 checkSecurityAccess方法不允许返回一个描述这个身份字符串。

另请参见：

SecurityManager.checkSecurityAccess(java.lang.String)

toString

public String toString(boolean detailed)

过时的。

返回该身份的字符串表示，随着更多的细节比随意的 toString方法提供不带任何参数。

首先，如果存在安全管理器，它的checkSecurityAccess方法被称为"printIdentity"作为是否可以返回字符串参数。

参数

detailed -是否提供详细的信息。

结果

关于这个身份的信息。如果 detailed是真的，那么这个方法返回于 toString方法提供不带任何参数的更多信息。

异常

SecurityException -如果存在一个安全管理及其 checkSecurityAccess方法不允许返回一个描述这个身份字符串。

另请参见：

toString()， SecurityManager.checkSecurityAccess(java.lang.String)

hashCode

public int hashCode()

过时的。

返回该身份的hashCode。

Specified by:

hashCode 接口 Principal

重写：

hashCode 方法重写，继承类 Object

结果

这一身份的hashCode。

另请参见：

Object.equals(java.lang.Object)， System.identityHashCode(java.lang.Object)