Identity

目录搜索

文字

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

java.security
类 Identity

java.lang.Object
  java.security.Identity

所有已实现的接口：: Serializable, Principal

直接已知子类：: IdentityScope, Signer

已过时。 不再使用此类。其功能已经由 java.security.KeyStore、java.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`

构造方法详细信息

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

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

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

java.security 类 Identity

Identity

Identity

Identity

getName

getScope

getPublicKey

setPublicKey

setInfo

getInfo

addCertificate

removeCertificate

certificates

equals

identityEquals

toString

toString

hashCode

java.security
类 Identity