模块 java.base
包 java.security

类 IdentityScope

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

此类代表身份的范围。它本身就是一个身份，因此有一个名字并且可以有一个范围。它还可以选择拥有公钥和相关证书。

IdentityScope 可以包含所有类型的 Identity 对象，包括签名者。可以使用相同的方法检索、添加和删除所有类型的 Identity 对象。请注意，不同类型的身份范围可能会针对其对各种类型身份的各种操作应用不同的策略，这实际上是可以预料的。

键和身份之间存在一对一的映射，每个范围只能有一个键的一个副本。例如，假设Acme 软件公司是用户已知的软件发布者。假设它是一个 Identity，即它有一个公钥，以及一组关联的证书。它在范围内使用名称“Acme Software”命名。范围内没有其他命名身份具有相同的公钥。当然，也没有同名的。

自从：
1.1
参见：

  • 构造方法总结

    构造方法
    修饰符
    构造方法
    描述
    protected
    IdentityScope()
    已弃用，将被删除：此 API 元素可能会在未来版本中删除。
    此构造方法仅用于序列化，不应由子类使用。
     
    IdentityScope(String name)
    已弃用，将被删除：此 API 元素可能会在未来版本中删除。
    构造具有指定名称的新身份范围。
     
    IdentityScope(String name, IdentityScope scope)
    已弃用，将被删除：此 API 元素可能会在未来版本中删除。
    构造具有指定名称和范围的新身份范围。

  • 方法总结

    修饰符和类型
    方法
    描述
    abstract void
    addIdentity(Identity identity)
    已弃用，将被删除：此 API 元素可能会在未来版本中删除。
    将 Identity 添加到此身份范围。
    abstract Identity
    getIdentity(String name)
    已弃用，将被删除：此 API 元素可能会在未来版本中删除。
    返回此范围内具有指定名称（如果有）的 Identity。
    Identity
    getIdentity(Principal principal)
    已弃用，将被删除：此 API 元素可能会在未来版本中删除。
    检索名称与指定主体相同的Identity。
    abstract Identity
    getIdentity(PublicKey key)
    已弃用，将被删除：此 API 元素可能会在未来版本中删除。
    使用指定的公钥检索 identity。
    static IdentityScope
    getSystemScope()
    已弃用，将被删除：此 API 元素可能会在未来版本中删除。
    返回系统的身份范围。
    abstract Enumeration<Identity>
    identities()
    已弃用，将被删除：此 API 元素可能会在未来版本中删除。
    返回此身份范围内所有身份的枚举。
    abstract void
    removeIdentity(Identity identity)
    已弃用，将被删除：此 API 元素可能会在未来版本中删除。
    从此身份范围中删除 Identity。
    protected static void
    setSystemScope(IdentityScope scope)
    已弃用，将被删除：此 API 元素可能会在未来版本中删除。
    设置系统的身份范围。
    abstract int
    size()
    已弃用，将被删除：此 API 元素可能会在未来版本中删除。
    返回此身份范围内的身份数。
    String
    toString()
    已弃用，将被删除：此 API 元素可能会在未来版本中删除。
    返回此身份范围的字符串表示形式，包括其名称、范围名称和此身份范围中的身份数。

    在类 java.security.Identity 中声明的方法

    addCertificate, certificates, equals, getInfo, getName, getPublicKey, getScope, hashCode, identityEquals, removeCertificate, setInfo, setPublicKey, toString

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

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

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

    implies

  • 构造方法详细信息

    • IdentityScope

      protected IdentityScope()
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      此构造方法仅用于序列化，不应由子类使用。

    • IdentityScope

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

    • IdentityScope

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

  • 方法详情

    • getSystemScope

      public static IdentityScope  getSystemScope()
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      返回系统的身份范围。
      返回：
      系统的身份范围，如果没有设置则为null。
      参见：

    • setSystemScope

      protected static void setSystemScope(IdentityScope  scope)
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      设置系统的身份范围。

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

      参数：
      scope - 要设置的范围。
      抛出：
      SecurityException - 如果安全管理器存在且其 checkSecurityAccess 方法不允许设置身份范围。
      参见：

    • size

      public abstract int size()
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      返回此身份范围内的身份数。
      返回：
      此身份范围内的身份数。

    • getIdentity

      public abstract Identity  getIdentity(String  name)
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      返回此范围内具有指定名称（如果有）的 Identity。
      参数：
      name - 要检索的 Identity 的名称。
      返回：
      Identity 命名为 name ，或者 null 如果在此范围内没有名为 name 的身份。

    • getIdentity

      public Identity  getIdentity(Principal  principal)
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      检索名称与指定主体相同的Identity。 （注意：Identity 实现了 Principal。）
      参数：
      principal - 对应于要检索的 Identity 的主体。
      返回：
      Identity 其名称与委托人的名称相同，或者 null 如果在此范围内没有同名的身份。

    • getIdentity

      public abstract Identity  getIdentity(PublicKey  key)
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      使用指定的公钥检索 identity。
      参数：
      key - 要返回的身份的公钥。
      返回：
      具有给定密钥的身份，或者 null 如果在此范围内没有具有该密钥的身份。

    • addIdentity

      public abstract void addIdentity(Identity  identity) throws KeyManagementException
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      将 Identity 添加到此身份范围。
      参数：
      identity - 要添加的 Identity。
      抛出：
      KeyManagementException - 如果身份无效，则发生名称冲突，另一个身份与正在添加的身份具有相同的公钥，或者发生另一个异常。

    • removeIdentity

      public abstract void removeIdentity(Identity  identity) throws KeyManagementException
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      从此身份范围中删除 Identity。
      参数：
      identity - 要删除的 Identity。
      抛出：
      KeyManagementException - 如果标识丢失，或发生另一个异常。

    • identities

      public abstract Enumeration <Identity > identities()
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      返回此身份范围内所有身份的枚举。
      返回：
      此身份范围内所有身份的枚举。

    • toString

      public String  toString()
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      返回此身份范围的字符串表示形式，包括其名称、范围名称和此身份范围中的身份数。
      指定者：
      toString 在接口 Principal 中
      重写：
      toString 在类 Identity 中
      返回：
      此身份范围的字符串表示形式。
      参见：