模块 java.base
包 java.security

类 Identity

java.lang.Object
java.security.Identity
所有已实现的接口：
Serializable , Principal
已知子类：
IdentityScope , Signer
@Deprecated (since ="1.2", forRemoval =true) public abstract class Identity extends Object implements Principal , Serializable
已弃用，将被删除：此 API 元素可能会在未来版本中删除。
此类已弃用，并可能在 Java SE 的未来版本中删除。它已被 java.security.KeyStore 、 java.security.cert 包和 java.security.Principal 取代。

此类表示身份：现实世界中的对象，例如人、公司或组织，其身份可以使用其公钥进行身份验证。身份也可以是更抽象（或具体）的构造，例如守护线程或智能卡。

所有 Identity 对象都有一个名称和一个公钥。名称是不可变的。身份也可以有范围。也就是说，如果 Identity 被指定为具有特定范围，则 Identity 的名称和公钥在该范围内是唯一的。

Identity 也有一组证书（都证明自己的公钥）。这些证书中指定的委托人名称不必相同，只需是密钥即可。

Identity 可以被子类化，包括邮政和电子邮件地址、电话号码、面部图像和徽标等。

自从：
1.1
参见：

  • 构造方法总结

    构造方法
    修饰符
    构造方法
    描述
    protected
    Identity()
    已弃用，将被删除：此 API 元素可能会在未来版本中删除。
    仅用于序列化的构造方法。
     
    Identity(String name)
    已弃用，将被删除：此 API 元素可能会在未来版本中删除。
    构造一个具有指定名称且没有作用域的 Identity。
     
    Identity(String name, IdentityScope scope)
    已弃用，将被删除：此 API 元素可能会在未来版本中删除。
    构造具有指定名称和范围的 Identity。

  • 方法总结

    修饰符和类型
    方法
    描述
    void
    addCertificate(Certificate certificate)
    已弃用，将被删除：此 API 元素可能会在未来版本中删除。
    为此 Identity 添加证书。
    Certificate[]
    certificates()
    已弃用，将被删除：此 API 元素可能会在未来版本中删除。
    返回此 Identity 的所有证书的副本。
    final boolean
    equals(Object identity)
    已弃用，将被删除：此 API 元素可能会在未来版本中删除。
    测试指定对象与此 Identity 之间的相等性。
    String
    getInfo()
    已弃用，将被删除：此 API 元素可能会在未来版本中删除。
    返回先前为此 Identity 指定的一般信息。
    final String
    getName()
    已弃用，将被删除：此 API 元素可能会在未来版本中删除。
    返回此身份的名称。
    PublicKey
    getPublicKey()
    已弃用，将被删除：此 API 元素可能会在未来版本中删除。
    返回此身份的公钥。
    final IdentityScope
    getScope()
    已弃用，将被删除：此 API 元素可能会在未来版本中删除。
    返回此身份的范围。
    int
    hashCode()
    已弃用，将被删除：此 API 元素可能会在未来版本中删除。
    返回此 Identity 的哈希码。
    protected boolean
    identityEquals(Identity identity)
    已弃用，将被删除：此 API 元素可能会在未来版本中删除。
    测试指定的 Identity 和这个 Identity 之间的相等性。
    void
    removeCertificate(Certificate certificate)
    已弃用，将被删除：此 API 元素可能会在未来版本中删除。
    从此 Identity 中删除证书。
    void
    setInfo(String info)
    已弃用，将被删除：此 API 元素可能会在未来版本中删除。
    为此 Identity 指定一般信息字符串。
    void
    setPublicKey(PublicKey key)
    已弃用，将被删除：此 API 元素可能会在未来版本中删除。
    设置此身份的公钥。
    String
    toString()
    已弃用，将被删除：此 API 元素可能会在未来版本中删除。
    返回描述此 Identity 的短字符串，告知其名称及其范围（如果有）。
    String
    toString(boolean detailed)
    已弃用，将被删除：此 API 元素可能会在未来版本中删除。
    返回此 Identity 的字符串表示形式，可选择比不带任何参数的 toString 方法提供的详细信息更多。

    在类 java.lang.Object 中声明的方法

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

    在接口 java.security.Principal 中声明的方法

    implies

  • 构造方法详细信息

    • Identity

      protected Identity()
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      仅用于序列化的构造方法。

    • Identity

      public Identity(String  name, IdentityScope  scope) throws KeyManagementException
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      构造具有指定名称和范围的 Identity。
      参数：
      name - Identity 名称。
      scope - Identity 的范围。
      抛出：
      KeyManagementException - 如果作用域中已经有同名的 Identity。

    • Identity

      public Identity(String  name)
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      构造一个具有指定名称且没有作用域的 Identity。
      参数：
      name - 身份名称。

  • 方法详情

    • getName

      public final String  getName()
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      返回此身份的名称。
      指定者：
      getName 在接口 Principal 中
      返回：
      这个 Identity 的名字。

    • getScope

      public final IdentityScope  getScope()
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      返回此身份的范围。
      返回：
      这个 Identity 的范围。

    • getPublicKey

      public PublicKey  getPublicKey()
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      返回此身份的公钥。
      返回：
      这个 Identity 的公钥。
      参见：

    • setPublicKey

      public void setPublicKey(PublicKey  key) throws KeyManagementException
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      设置此身份的公钥。此操作将删除旧密钥和所有此身份的证书。

      首先，如果有安全管理器，它的 checkSecurityAccess 方法会以 "setIdentityPublicKey" 作为参数调用，以查看是否可以设置公钥。

      参数：
      key - 这个 Identity 的公钥。
      抛出：
      KeyManagementException - 如果身份范围内的另一个身份具有相同的公钥，或者发生另一个异常。
      SecurityException - 如果安全管理器存在且其 checkSecurityAccess 方法不允许设置公钥。
      参见：

    • setInfo

      public void setInfo(String  info)
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      为此 Identity 指定一般信息字符串。

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

      参数：
      info - 信息字符串。
      抛出：
      SecurityException - 如果安全管理器存在且其 checkSecurityAccess 方法不允许设置信息字符串。
      参见：

    • getInfo

      public String  getInfo()
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      返回先前为此 Identity 指定的一般信息。
      返回：
      有关此 Identity 的一般信息。
      参见：

    • addCertificate

      public void addCertificate(Certificate  certificate) throws KeyManagementException
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      为此 Identity 添加证书。如果Identity有公钥，则证书中的公钥必须相同，如果Identity没有公钥，则将身份的公钥设置为证书中指定的公钥。

      首先，如果有安全管理器，它的 checkSecurityAccess 方法会以 "addIdentityCertificate" 作为参数调用，以查看是否可以添加证书。

      参数：
      certificate - 要添加的证书。
      抛出：
      KeyManagementException - 如果证书无效，正在添加的证书中的公钥与此身份的公钥冲突，或者发生其他异常。
      SecurityException - 如果安全管理器存在且其 checkSecurityAccess 方法不允许添加证书。
      参见：

    • removeCertificate

      public void removeCertificate(Certificate  certificate) throws KeyManagementException
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      从此 Identity 中删除证书。

      首先，如果有安全管理器，它的 checkSecurityAccess 方法将以 "removeIdentityCertificate" 作为参数调用，以查看是否可以删除证书。

      参数：
      certificate - 要删除的证书。
      抛出：
      KeyManagementException - 如果证书丢失，或者发生另一个异常。
      SecurityException - 如果安全管理器存在且其 checkSecurityAccess 方法不允许删除证书。
      参见：

    • certificates

      public Certificate [] certificates()
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      返回此 Identity 的所有证书的副本。
      返回：
      此 Identity 的所有证书的副本。

    • equals

      public final boolean equals(Object  identity)
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      测试指定对象与此 Identity 之间的相等性。这首先测试实体是否实际引用同一个对象，在这种情况下它返回 true 。接下来，它检查实体是否具有相同的名称和相同的范围。如果他们这样做，该方法返回 true 。否则，它调用 identityEquals ，子类应该覆盖。
      指定者：
      equals 在接口 Principal 中
      重写：
      equals 在类 Object 中
      参数：
      identity - 要测试与此 Identity 是否相等的对象。
      返回：
      true 如果对象被认为是相等的，false 否则。
      参见：

    • identityEquals

      protected boolean identityEquals(Identity  identity)
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      测试指定的 Identity 和这个 Identity 之间的相等性。这个方法应该被子类覆盖以测试是否相等。如果名称和公钥相等，默认行为是返回 true。
      参数：
      identity - 用于测试与此 identity 是否相等的身份。
      返回：
      true 如果身份被认为是相等的，false 否则。
      参见：

    • toString

      public String  toString()
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      返回描述此 Identity 的短字符串，告知其名称及其范围（如果有）。

      首先，如果有安全管理器，它的 checkSecurityAccess 方法会以 "printIdentity" 作为参数调用，以查看是否可以返回字符串。

      指定者：
      toString 在接口 Principal 中
      重写：
      toString 在类 Object 中
      返回：
      有关此 Identity 的信息，例如其名称和范围名称（如果有）。
      抛出：
      SecurityException - 如果安全管理器存在且其 checkSecurityAccess 方法不允许返回描述此 Identity 的字符串。
      参见：

    • toString

      public String  toString(boolean detailed)
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      返回此 Identity 的字符串表示形式，可选择比不带任何参数的 toString 方法提供的详细信息更多。

      首先，如果有安全管理器，它的 checkSecurityAccess 方法会以 "printIdentity" 作为参数调用，以查看是否可以返回字符串。

      参数：
      detailed - 是否提供详细信息。
      返回：
      有关此 Identity 的信息。如果 detailed 是 true ，则此方法返回的信息比不带任何参数的 toString 方法提供的信息更多。
      抛出：
      SecurityException - 如果安全管理器存在且其 checkSecurityAccess 方法不允许返回描述此 Identity 的字符串。
      参见：

    • hashCode

      public int hashCode()
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      返回此 Identity 的哈希码。
      指定者：
      hashCode 在接口 Principal 中
      重写：
      hashCode 在类 Object 中
      返回：
      这个 Identity 的哈希码。
      参见：