类 java.security.IdentityScope

java.lang.Object
   |
   +----java.security.Identity
           |
           +----java.security.IdentityScope

public abstract class IdentityScope

extends Identity

该类表示身份的作用域。它自身就是一个 Identity，具有一个名字，并可有一个作用域。它也可以具有可选的公共密钥及与之相关的证书。

一个 IdentityScope 可以包含所有类型的 Identity 对象，包括 Signers。使用相同的方法可以检索、添加、删除所有类型的 Identity。注意，正如实际中所希望的那样，不同类型的身份作用域能够针对不同类型的 Identity 中的各种操作采用不同的策略。

密钥和身份之间存在一个一对一的映射，每个作用域中，一个密钥只能有一个拷贝。例如，假设 Acme Software, Inc 是用户知道的软件发行商。假设它是一个 Identity，即它有一个公共密钥和一个相关证书集合。在作用域中，它被命名为 "Acme Software"。在这个作用域中，其它被命名的 Identity 都没有与之相同的公共密钥。当然也没有相同的名字。

参见：

Identity, Signer, Principal, Key

构造子索引

IdentityScope()

该构造子只用于串行化，并且其子类不能使用它。

IdentityScope(String)

用指定的名字构造一个新的身份作用域。

IdentityScope(String, IdentityScope)

用指定的名字和作用域构造一个新的身份作用域。

方法索引

addIdentity(Identity)

在该身份作用域中添加一个身份。

getIdentity(Principal)

检索名字与指定的主体相同的身份。

getIdentity(PublicKey)

用指定的公共密钥检索身份。

getIdentity(String)

返回该作用域中具有指定名字的身份 ( 如果存在 )。

getSystemScope()

返回系统的身份作用域。

identities()

返回该身份作用域中所有身份的一个枚举。

removeIdentity(Identity)

从该身份的作用域中删除一个身份。

setSystemScope(IdentityScope)

设置系统的身份作用域。

size()

返回该身份作用域中的身份的数目。

toString()

返回该身份作用域的字符串表示，包括它的名字、作用域名和该身份作用域中身份的数目。

构造子

 protected IdentityScope()

该构造子只用于串行化，并且其子类不能使用它。

 public IdentityScope(String name)

用指定的名字构造一个新的身份作用域。

参数：

name - 作用域名。

 public IdentityScope(String name,
                      IdentityScope scope) throws KeyManagementException

用指定的名字和作用域构造一个新的身份作用域。

参数：

name - 作用域名。

scope - 新建身份作用域的作用域。

抛出： KeyManagementException

如果作用域中有一个身份具有相同的名字。

方法

 public static IdentityScope getSystemScope()

返回系统的身份作用域。

返回值：

系统的身份作用域。

 protected static void setSystemScope(IdentityScope scope)

设置系统的身份作用域。

参数：

scope - 要设置的作用域。

 public abstract int size()

返回该身份作用域中的身份的数目。

返回值：

该身份作用域中的身份的数目。

 public abstract Identity getIdentity(String name)

返回该作用域中具有指定名字的身份 ( 如果存在 )。

参数：

name - 要检索的身份的名字。

返回值：

命名为 name 的身份，如果该作用域中没有命名为 name 的身份则为 null。

 public Identity getIdentity(Principal principal)

检索与指定的主体具有相同名字身份。 ( 注意：Identity 实现了 Principal。)

参数：

principal - 与要检索的身份相应的主体。

返回值：

主体，如果该作用域中没有与主体具有相同名字的身份则为 null。

 public abstract Identity getIdentity(PublicKey key)

用指定的公共密钥检索身份。

参数：

key - 要返回身份的公共密钥。

返回值：

具有给定密钥的社身份，如果该作用域中没有具有该密钥的身份则为 null。

 public abstract void addIdentity(Identity identity) throws KeyManagementException

在该身份作用域中添加一个身份。

参数：

identity - 要添加的身份。

抛出： KeyManagementException

如果该身份是无效的，或发生了名字冲突，或另一个身份具有与被添加的身份相同的公共密钥，或发生了另一个异常。

 public abstract void removeIdentity(Identity identity) throws KeyManagementException

从该身份的作用域中删除一个身份。

参数：

identity - 要删除的身份。

抛出： KeyManagementException

如果丢失了该身份或发生了另一个异常。

 public abstract Enumeration identities()

返回该身份作用域中所有身份的一个枚举。

返回值：

该身份作用域中所有身份的一个枚举。

 public String toString()

返回该身份作用域的字符串表示，包括它的名字、作用域名和该身份作用域中身份的数目。

返回值：

该身份作用域的字符串表示。

覆盖：

类 Identity 中的 toString