JavaTM 2 Platform
Standard Ed. 5.0

java.security
类 Identity

java.lang.Object
  继承者 java.security.Identity
所有已实现的接口:
Serializable, Principal
直接已知子类:
IdentityScope, Signer

已过时。 不再使用此类。其功能已经由 java.security.KeyStorejava.security.cert 包和 java.security.Principal 取代。

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

此类表示身份:现实世界的对象,比如人、公司或组织,它们的身份可以通过使用公钥验证。Identity 也可以是更抽象(或具体)的概念,例如守护线程或智能卡。

所有的 Identity 对象都具有一个名称和一个公钥。名称是不可变的。Identity 也可以有作用域。也就是说,如果一个 Identity 被指定具有一个特定的作用域,那么 Identity 的名称和公钥在该作用域内是唯一的。

Identity 也有一个证书集合(都证明其本身的公钥)。只要密钥相同,在这些证书中指定的主体名称不必相同。

可以为 Identity 创建子类,以包括邮政和电子邮件地址、电话号码、面部图像和徽标等等。

另请参见:
IdentityScope, Signer, Principal, 序列化表格

构造方法摘要
protected Identity()
          已过时。 只用于序列化的构造器。
  Identity(String name)
          已过时。 构造一个具有指定名称且没有作用域的 Identity。
  Identity(String name, IdentityScope scope)
          已过时。 构造一个具有指定名称和作用域的 Identity。
 
方法摘要
 void addCertificate(Certificate certificate)
          已过时。 为此 Identity 添加一个证书。
 Certificate[] certificates()
          已过时。 返回此 Identity 所有证书的一个副本。
 boolean equals(Object identity)
          已过时。 测试指定对象与此 Identity 的相等性。
 String getInfo()
          已过时。 返回以前为此 Identity 指定的常规信息字符串。
 String getName()
          已过时。 返回此 Identity 的名称。
 PublicKey getPublicKey()
          已过时。 返回此 Identity 的公钥。
 IdentityScope getScope()
          已过时。 返回此 Identity 的作用域。
 int hashCode()
          已过时。 返回此 Identity 的哈希码。
protected  boolean identityEquals(Identity identity)
          已过时。 测试指定 Identity 与此 Identity 的相等性。
 void removeCertificate(Certificate certificate)
          已过时。 从此 Identity 中移除证书。
 void setInfo(String info)
          已过时。 为此 Identity 指定一个常规信息字符串。
 void setPublicKey(PublicKey key)
          已过时。 设置此 Identity 的公钥。
 String toString()
          已过时。 返回描述此 Identity 的短字符串,说明其名称和作用域(如果有的话)。
 String toString(boolean detailed)
          已过时。 返回此 Identity 的字符串表示形式,可以选择比不带任何参数的 toString 方法带有更多的详细信息。
 
从类 java.lang.Object 继承的方法
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

构造方法详细信息

Identity

protected Identity()
已过时。 
只用于序列化的构造器。


Identity

public Identity(String name,
                IdentityScope scope)
         throws KeyManagementException
已过时。 
构造一个具有指定名称和作用域的 Identity。

参数:
name - Identity 的名称。
scope - Identity 的作用域。
抛出:
KeyManagementException - 在此作用域内已经存在一个具有相同名称的 Identity。

Identity

public Identity(String name)
已过时。 
构造一个具有指定名称且没有作用域的 Identity。

参数:
name - Identity 的名称。
方法详细信息

getName

public final String getName()
已过时。 
返回此 Identity 的名称。

指定者:
接口 Principal 中的 getName
返回:
此 Identity 的名称。

getScope

public final IdentityScope getScope()
已过时。 
返回此 Identity 的作用域。

返回:
此 Identity 的作用域。

getPublicKey

public PublicKey getPublicKey()
已过时。 
返回此 Identity 的公钥。

返回:
此 Identity 的公钥。
另请参见:
setPublicKey(java.security.PublicKey)

setPublicKey

public void setPublicKey(PublicKey key)
                  throws KeyManagementException
已过时。 
设置此 Identity 的公钥。此操作移除旧的密钥和此 Identity 的所有证书。

首先,如果存在安全管理器,则用 "setIdentityPublicKey" 作为参数调用其 checkSecurityAccess 方法,以查看它是否可以设置公钥。

参数:
key - 此 Identity 的公钥。
抛出:
KeyManagementException - 如果在此 Identity 的作用域内的另外一个 Identity 具有相同的公钥,或者发生其他异常。
SecurityException - 如果安全管理器存在并且其 checkSecurityAccess 方法不允许设置公钥。
另请参见:
getPublicKey(), SecurityManager.checkSecurityAccess(java.lang.String)

setInfo

public void setInfo(String info)
已过时。 
为此 Identity 指定一个常规信息字符串。

首先,如果有安全管理器,则用 "setIdentityInfo" 作为参数调用其 checkSecurityAccess 方法,以查看它是否可以指定信息字符串。

参数:
info - 信息字符串。
抛出:
SecurityException - 如果安全管理器存在并且其 checkSecurityAccess 方法不允许设置信息字符串。
另请参见:
getInfo(), SecurityManager.checkSecurityAccess(java.lang.String)

getInfo

public String getInfo()
已过时。 
返回以前为此 Identity 指定的常规信息字符串。

返回:
关于此 Identity 的常规信息。
另请参见:
setInfo(java.lang.String)

addCertificate

public void addCertificate(Certificate certificate)
                    throws KeyManagementException
已过时。 
为此 Identity 添加一个证书。如果 Identity 有一个公钥,则证书中的公钥必须相同,如果 Identity 没有公钥,则将 Identity 的公钥设置为证书中所指定的公钥。

首先,如果存在安全管理器,则用 "addIdentityCertificate" 作为参数调用其 checkSecurityAccess 方法,以查看它是否可以添加一个证书。

参数:
certificate - 要添加的证书。
抛出:
KeyManagementException - 如果证书是无效的;如果要添加到证书中的公钥和此 Identity 冲突;如果发生其他异常。
SecurityException - 如果安全管理器存在并且其 checkSecurityAccess 方法不允许添加证书。
另请参见:
SecurityManager.checkSecurityAccess(java.lang.String)

removeCertificate

public void removeCertificate(Certificate certificate)
                       throws KeyManagementException
已过时。 
从此 Identity 中移除证书。

首先,如果存在安全管理器,则用 "removeIdentityCertificate" 作为参数调用其 checkSecurityAccess 方法,以查看它是否可以移除证书。

参数:
certificate - 要移除的证书。
抛出:
KeyManagementException - 如果证书丢失,或者发生其他异常。
SecurityException - 如果安全管理器存在并且其 checkSecurityAccess 方法不允许移除证书。
另请参见:
SecurityManager.checkSecurityAccess(java.lang.String)

certificates

public Certificate[] certificates()
已过时。 
返回此 Identity 所有证书的一个副本。

返回:
此 Identity 所有证书的一个副本。

equals

public final boolean equals(Object identity)
已过时。 
测试指定对象与此 Identity 的相等性。此方法首先测试两个实体是否实际引用的是同一对象,在这种情况下它返回 true。然后它检查两个实体是否有相同的名称和作用域。如果是这样,则该方法返回 true。否则,它调用子类应该重写的 identityEquals

指定者:
接口 Principal 中的 equals
覆盖:
Object 中的 equals
参数:
identity - 要与此 Identity 进行相等性测试的对象。
返回:
如果对象被视为相等,则返回 true;否则返回 false。
另请参见:
identityEquals(java.security.Identity)

identityEquals

protected boolean identityEquals(Identity identity)
已过时。 
测试指定 Identity 与此 Identity 的相等性。子类应该重写此方法来测试相等性。如果名称和公钥相等,默认的行为是返回 true。

参数:
identity - 要与此 Identity 进行相等性测试的 Identity。
返回:
如果 Identity 被视为相等,则返回 true;否则,返回 false。
另请参见:
equals(java.lang.Object)

toString

public String toString()
已过时。 
返回描述此 Identity 的短字符串,说明其名称和作用域(如果有的话)。

首先,如果存在安全管理器,则用 "printIdentity" 作为参数调用其 checkSecurityAccess 方法,以查看它是否可以返回字符串。

指定者:
接口 Principal 中的 toString
覆盖:
Object 中的 toString
返回:
关于此 Identity 的信息,例如其名称和作用域(如果有的话)。
抛出:
SecurityException - 如果安全管理器存在并且其 checkSecurityAccess 方法不允许返回描述此 Identity 的字符串。
另请参见:
SecurityManager.checkSecurityAccess(java.lang.String)

toString

public String toString(boolean detailed)
已过时。 
返回此 Identity 的字符串表示形式,可以选择比不带任何参数的 toString 方法带有更多的详细信息。

首先,如果存在安全管理器,则用 "printIdentity" 作为参数调用其 checkSecurityAccess 方法,以查看它是否可以返回字符串。

参数:
detailed - 是否提供详细的信息。
返回:
关于此 Identity 的信息。如果 detailed 为 true,那么此方法比不带任何参数的 toString 方法返回更多的信息。
抛出:
SecurityException - 如果安全管理器存在并且其 checkSecurityAccess 方法不允许返回描述此 Identity 的字符串。
另请参见:
toString(), SecurityManager.checkSecurityAccess(java.lang.String)

hashCode

public int hashCode()
已过时。 
返回此 Identity 的哈希码。

指定者:
接口 Principal 中的 hashCode
覆盖:
Object 中的 hashCode
返回:
此 Identity 的哈希码。
另请参见:
Object.equals(java.lang.Object), Hashtable

JavaTM 2 Platform
Standard Ed. 5.0

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

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