IdentityScope

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

所有已实现的接口:

Serializable, Principal

已过时。
This class is no longer used. Its functionality has been replaced by java.security.KeyStore, the java.security.cert package, and java.security.Principal.
```
@Deprecated
public abstract class IdentityScope
extends Identity
```
This class represents a scope for identities. It is an Identity itself, and therefore has a name and can have a scope. It can also optionally have a public key and associated certificates.
An IdentityScope can contain Identity objects of all kinds, including Signers. All types of Identity objects can be retrieved, added, and removed using the same methods. Note that it is possible, and in fact expected, that different types of identity scopes will apply different policies for their various operations on the various types of Identities.
There is a one-to-one mapping between keys and identities, and there can only be one copy of one key per scope. For example, suppose Acme Software, Inc is a software publisher known to a user. Suppose it is an Identity, that is, it has a public key, and a set of associated certificates. It is named in the scope using the name "Acme Software". No other named Identity in the scope has the same public key. Of course, none has the same name as well.

另请参阅:

Identity, Signer, Principal, Key, 序列化表格

构造器概要

构造器
限定符	构造器	说明
`protected`	`IdentityScope()`	已过时。 This constructor is used for serialization only and should not be used by subclasses.
	`IdentityScope(String name)`	已过时。 Constructs a new identity scope with the specified name.
	`IdentityScope(String name, IdentityScope scope)`	已过时。 Constructs a new identity scope with the specified name and scope.

方法概要

所有方法静态方法实例方法抽象方法具体方法已过时的方法
限定符和类型	方法	说明
`abstract void`	`addIdentity(Identity identity)`	已过时。 Adds an identity to this identity scope.
`abstract Identity`	`getIdentity(String name)`	已过时。 Returns the identity in this scope with the specified name (if any).
`Identity`	`getIdentity(Principal principal)`	已过时。 Retrieves the identity whose name is the same as that of the specified principal.
`abstract Identity`	`getIdentity(PublicKey key)`	已过时。 Retrieves the identity with the specified public key.
`static IdentityScope`	`getSystemScope()`	已过时。 Returns the system's identity scope.
`abstract Enumeration<Identity>`	`identities()`	已过时。 Returns an enumeration of all identities in this identity scope.
`abstract void`	`removeIdentity(Identity identity)`	已过时。 Removes an identity from this identity scope.
`protected static void`	`setSystemScope(IdentityScope scope)`	已过时。 Sets the system's identity scope.
`abstract int`	`size()`	已过时。 Returns the number of identities within this identity scope.
`String`	`toString()`	已过时。 Returns a string representation of this identity scope, including its name, its scope name, and the number of identities in this identity scope.

从类继承的方法 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()
```
    已过时。
    
    This constructor is used for serialization only and should not be used by subclasses.
  - IdentityScope
```
public IdentityScope(String name)
```
    已过时。
    
    Constructs a new identity scope with the specified name.
    
    参数:
    
    name - the scope name.
  - IdentityScope
```
public IdentityScope(String name,
                     IdentityScope scope)
              throws KeyManagementException
```
    已过时。
    
    Constructs a new identity scope with the specified name and scope.
    
    参数:
    
    name - the scope name.
    
    scope - the scope for the new identity scope.
    
    抛出:
    
    KeyManagementException - if there is already an identity with the same name in the scope.
- 方法详细资料
  - getSystemScope
```
public static IdentityScope getSystemScope()
```
    已过时。
    
    Returns the system's identity scope.
    
    返回:
    
    the system's identity scope, or null if none has been set.
    
    另请参阅:
    
    setSystemScope(java.security.IdentityScope)
  - setSystemScope
```
protected static void setSystemScope(IdentityScope scope)
```
    已过时。
    
    Sets the system's identity scope.
    First, if there is a security manager, its checkSecurityAccess method is called with "setSystemScope" as its argument to see if it's ok to set the identity scope.
    
    参数:
    
    scope - the scope to set.
    
    抛出:
    
    SecurityException - if a security manager exists and its checkSecurityAccess method doesn't allow setting the identity scope.
    
    另请参阅:
    
    getSystemScope(), SecurityManager.checkSecurityAccess(java.lang.String)
  - size
```
public abstract int size()
```
    已过时。
    
    Returns the number of identities within this identity scope.
    
    返回:
    
    the number of identities within this identity scope.
  - getIdentity
```
public abstract Identity getIdentity(String name)
```
    已过时。
    
    Returns the identity in this scope with the specified name (if any).
    
    参数:
    
    name - the name of the identity to be retrieved.
    
    返回:
    
    the identity named name, or null if there are no identities named name in this scope.
  - getIdentity
```
public Identity getIdentity(Principal principal)
```
    已过时。
    
    Retrieves the identity whose name is the same as that of the specified principal. (Note: Identity implements Principal.)
    
    参数:
    
    principal - the principal corresponding to the identity to be retrieved.
    
    返回:
    
    the identity whose name is the same as that of the principal, or null if there are no identities of the same name in this scope.
  - getIdentity
```
public abstract Identity getIdentity(PublicKey key)
```
    已过时。
    
    Retrieves the identity with the specified public key.
    
    参数:
    
    key - the public key for the identity to be returned.
    
    返回:
    
    the identity with the given key, or null if there are no identities in this scope with that key.
  - addIdentity
```
public abstract void addIdentity(Identity identity)
                          throws KeyManagementException
```
    已过时。
    
    Adds an identity to this identity scope.
    
    参数:
    
    identity - the identity to be added.
    
    抛出:
    
    KeyManagementException - if the identity is not valid, a name conflict occurs, another identity has the same public key as the identity being added, or another exception occurs.
  - removeIdentity
```
public abstract void removeIdentity(Identity identity)
                             throws KeyManagementException
```
    已过时。
    
    Removes an identity from this identity scope.
    
    参数:
    
    identity - the identity to be removed.
    
    抛出:
    
    KeyManagementException - if the identity is missing, or another exception occurs.
  - identities
```
public abstract Enumeration<Identity> identities()
```
    已过时。
    
    Returns an enumeration of all identities in this identity scope.
    
    返回:
    
    an enumeration of all identities in this identity scope.
  - toString
```
public String toString()
```
    已过时。
    
    Returns a string representation of this identity scope, including its name, its scope name, and the number of identities in this identity scope.
    
    指定者:
    
    toString 在接口中 Principal
    
    覆盖:
    
    toString 在类中 Identity
    
    返回:
    
    a string representation of this identity scope.
    
    另请参阅:
    
    SecurityManager.checkSecurityAccess(java.lang.String)

类 IdentityScope

构造器概要

方法概要

从类继承的方法 java.security.Identity

从类继承的方法 java.lang.Object

从接口继承的方法 java.security.Principal

构造器详细资料

IdentityScope

IdentityScope

IdentityScope

方法详细资料

getSystemScope

setSystemScope

size

getIdentity

getIdentity

getIdentity

addIdentity

removeIdentity

identities

toString