模块  java.base
软件包  java.security

Class Identity

  • 实现的所有接口
    Serializable ， Principal
    已知直接子类：
    IdentityScope ， Signer 
    @Deprecated(since="1.2",            forRemoval=true)public abstract class Identityextends Objectimplements Principal, Serializable
    Deprecated, for removal: This API element is subject to removal in a future version.
    This class is deprecated and subject to removal in a future version of Java SE. It has been replaced by java.security.KeyStore, the java.security.cert package, and java.security.Principal.

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

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

    身份还具有一组证书（所有证书都证明其自己的公钥）。 这些证书中指定的主要名称不必相同，只需要密钥。

    身份可以是子类，包括邮政和电子邮件地址，电话号码，面部图像和徽标等。

    从以下版本开始：
    1.1
    另请参见：
    IdentityScope ， Signer ， Principal ， Serialized Form

    • 构造方法摘要

      构造方法  
      变量 构造器 描述
      protected Identity()
      不推荐使用，要删除：此API元素将在以后的版本中删除。
      仅用于序列化的构造函数。
        Identity​(String name)
      不推荐使用，要删除：此API元素将在以后的版本中删除。
      构造具有指定名称且不具有范围的标识。
        Identity​(String name, IdentityScope scope)
      不推荐使用，要删除：此API元素将在以后的版本中删除。
      构造具有指定名称和范围的标识。

    • 方法摘要

      所有方法  实例方法 具体的方法  弃用的方法 
      变量和类型 方法 描述
      void addCertificate​(Certificate certificate)
      不推荐使用，要删除：此API元素将在以后的版本中删除。
      为此标识添加证书。
      Certificate[] certificates()
      不推荐使用，要删除：此API元素将在以后的版本中删除。
      返回此标识的所有证书的副本。
      boolean equals​(Object identity)
      不推荐使用，要删除：此API元素将在以后的版本中删除。
      测试指定对象与此标识之间的相等性。
      String getInfo()
      不推荐使用，要删除：此API元素将在以后的版本中删除。
      返回先前为此标识指定的常规信息。
      String getName()
      不推荐使用，要删除：此API元素将在以后的版本中删除。
      返回此标识的名称。
      PublicKey getPublicKey()
      不推荐使用，要删除：此API元素将在以后的版本中删除。
      返回此标识的公钥。
      IdentityScope getScope()
      不推荐使用，要删除：此API元素将在以后的版本中删除。
      返回此标识的范围。
      int hashCode()
      不推荐使用，要删除：此API元素将在以后的版本中删除。
      返回此标识的哈希码。
      protected boolean identityEquals​(Identity identity)
      不推荐使用，要删除：此API元素将在以后的版本中删除。
      测试指定标识与此标识之间的相等性。
      void removeCertificate​(Certificate certificate)
      不推荐使用，要删除：此API元素将在以后的版本中删除。
      从此标识中删除证书。
      void setInfo​(String info)
      不推荐使用，要删除：此API元素将在以后的版本中删除。
      指定此标识的常规信息字符串。
      void setPublicKey​(PublicKey key)
      不推荐使用，要删除：此API元素将在以后的版本中删除。
      设置此标识的公钥。
      String toString()
      不推荐使用，要删除：此API元素将在以后的版本中删除。
      返回描述此标识的短字符串，告知其名称及其范围（如果有）。
      String toString​(boolean detailed)
      不推荐使用，要删除：此API元素将在以后的版本中删除。
      返回此标识的字符串表示形式，可选择的细节多于 toString方法提供的不带任何参数的详细信息。

    • 构造方法详细信息

      • Identity

        protected Identity()
        Deprecated, for removal: This API element is subject to removal in a future version.
        仅用于序列化的构造函数。

      • Identity

        public Identity​(String name,                IdentityScope scope)         throws KeyManagementException
        Deprecated, for removal: This API element is subject to removal in a future version.
        构造具有指定名称和范围的标识。
        参数
        name - 身份名称。
        scope - 身份的范围。
        异常
        KeyManagementException - 如果范围中已存在具有相同名称的标识。

      • Identity

        public Identity​(String name)
        Deprecated, for removal: This API element is subject to removal in a future version.
        构造具有指定名称且不具有范围的标识。
        参数
        name - 身份名称。

    • 方法详细信息

      • getName

        public final String getName()
        Deprecated, for removal: This API element is subject to removal in a future version.
        返回此标识的名称。
        Specified by:
        getName ，界面 Principal
        结果
        这个身份的名称。

      • getScope

        public final IdentityScope getScope()
        Deprecated, for removal: This API element is subject to removal in a future version.
        返回此标识的范围。
        结果
        这个身份的范围。

      • getPublicKey

        public PublicKey getPublicKey()
        Deprecated, for removal: This API element is subject to removal in a future version.
        返回此标识的公钥。
        结果
        这个身份的公钥。
        另请参见：
        setPublicKey(java.security.PublicKey)

      • setPublicKey

        public void setPublicKey​(PublicKey key)                  throws KeyManagementException
        Deprecated, for removal: This API element is subject to removal in a future version.
        设置此标识的公钥。 此操作将删除旧密钥和所有此身份证书。

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

        参数
        key - 此标识的公钥。
        异常
        KeyManagementException - 如果标识范围内的另一个标识具有相同的公钥，或者发生另一个异常。
        SecurityException - 如果存在安全管理器且其 checkSecurityAccess方法不允许设置公钥。
        另请参见：
        getPublicKey() ， SecurityManager.checkSecurityAccess(java.lang.String)

      • setInfo

        public void setInfo​(String info)
        Deprecated, for removal: This API element is subject to removal in a future version.
        指定此标识的常规信息字符串。

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

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

      • getInfo

        public String getInfo()
        Deprecated, for removal: This API element is subject to removal in a future version.
        返回先前为此标识指定的常规信息。
        结果
        有关此身份的一般信息。
        另请参见：
        setInfo(java.lang.String)

      • addCertificate

        public void addCertificate​(Certificate certificate)                    throws KeyManagementException
        Deprecated, for removal: This API element is subject to removal in a future version.
        为此标识添加证书。 如果标识具有公钥，则证书中的公钥必须相同，如果标识没有公钥，则标识的公钥将设置为证书中指定的公钥。

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

        参数
        certificate - 要添加的证书。
        异常
        KeyManagementException - 如果证书无效，则添加的证书中的公钥与此标识的公钥冲突，或者是否发生另一个异常。
        SecurityException - 如果存在安全管理器且其 checkSecurityAccess方法不允许添加证书。
        另请参见：
        SecurityManager.checkSecurityAccess(java.lang.String)

      • removeCertificate

        public void removeCertificate​(Certificate certificate)                       throws KeyManagementException
        Deprecated, for removal: This API element is subject to removal in a future version.
        从此标识中删除证书。

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

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

      • certificates

        public Certificate[] certificates()
        Deprecated, for removal: This API element is subject to removal in a future version.
        返回此标识的所有证书的副本。
        结果
        此身份的所有证书的副本。

      • equals

        public final boolean equals​(Object identity)
        Deprecated, for removal: This API element is subject to removal in a future version.
        测试指定对象与此标识之间的相等性。 这首先测试实体是否实际引用同一个对象，在这种情况下它返回true。 接下来，它检查实体是否具有相同的名称和相同的范围。 如果是，则该方法返回true。 否则，它调用identityEquals ，子类应该覆盖。
        Specified by:
        equals在接口 Principal
        重写：
        equals ，课程 Object
        参数
        identity - 要测试与此标识相等的对象。
        结果
        如果对象被认为是相等的则为true，否则为false。
        另请参见：
        identityEquals(java.security.Identity)

      • identityEquals

        protected boolean identityEquals​(Identity identity)
        Deprecated, for removal: This API element is subject to removal in a future version.
        测试指定标识与此标识之间的相等性。 子类应该覆盖此方法以测试相等性。 如果名称和公钥相等，则默认行为是返回true。
        参数
        identity - 用于测试与此标识的相等性的标识。
        结果
        如果身份被认为是相等的则为true，否则为false。
        另请参见：
        equals(java.lang.Object)

      • toString

        public String toString()
        Deprecated, for removal: This API element is subject to removal in a future version.
        返回描述此标识的短字符串，告知其名称及其范围（如果有）。

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

        Specified by:
        toString接口 Principal
        重写：
        toString在课堂上 Object
        结果
        有关此标识的信息，例如其名称和范围名称（如果有）。
        异常
        SecurityException - 如果存在安全管理器且其 checkSecurityAccess方法不允许返回描述此标识的字符串。
        另请参见：
        SecurityManager.checkSecurityAccess(java.lang.String)

      • toString

        public String toString​(boolean detailed)
        Deprecated, for removal: This API element is subject to removal in a future version.
        返回此标识的字符串表示形式，可选择的详细信息比toString方法提供的更多详细信息，不带任何参数。

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

        参数
        detailed - 是否提供详细信息。
        结果
        有关此身份的信息。 如果detailed为true，则此方法返回的信息多于toString方法提供的信息，而不带任何参数。
        异常
        SecurityException - 如果存在安全管理器且其 checkSecurityAccess方法不允许返回描述此标识的字符串。
        另请参见：
        toString() ， SecurityManager.checkSecurityAccess(java.lang.String)