java.security: abstract public class: IdentityScope

java.security
abstract public class: IdentityScope [javadoc | source]

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

All Implemented Interfaces:
Principal, Serializable

Deprecated! This - class is no longer used. Its functionality has been replaced by java.security.KeyStore, the java.security.cert package, and java.security.Principal.

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.

Also see:

author: Benjamin - Renaud

Fields inherited from java.security.Identity:
info, scope, certificates

Constructor:

Constructor:
protected IdentityScope() { this("restoring..."); } This constructor is used for serialization only and should not be used by subclasses.
public IdentityScope(String name) { super(name); } Constructs a new identity scope with the specified name. Parameters: `name` - the scope name.
public IdentityScope(String name, IdentityScope scope) throws KeyManagementException { super(name, scope); } Constructs a new identity scope with the specified name and scope. Parameters: `name` - the scope name. `scope` - the scope for the new identity scope. Throws: `KeyManagementException` - if there is already an identity with the same name in the scope. exception: `KeyManagementException` - if there is already an identity with the same name in the scope.

 protected IdentityScope() {
        this("restoring...");
}

This constructor is used for serialization only and should not be used by subclasses.

 public IdentityScope(String name) {
        super(name);
}

Constructs a new identity scope with the specified name.

Parameters:

name - the scope name.

 public IdentityScope(String name,
    IdentityScope scope) throws KeyManagementException {
        super(name, scope);
}

Constructs a new identity scope with the specified name and scope.

Parameters:

name - the scope name.

scope - the scope for the new identity scope.

Throws:

KeyManagementException - if there is already an identity with the same name in the scope.

exception: KeyManagementException - if there is already an identity with the same name in the scope.

Method from java.security.IdentityScope Summary:
addIdentity, getIdentity, getIdentity, getIdentity, getSystemScope, identities, removeIdentity, setSystemScope, size, toString

Methods from java.security.Identity:
addCertificate, certificates, equals, fullName, getInfo, getName, getPublicKey, getScope, hashCode, identityEquals, printCertificates, printKeys, removeCertificate, setInfo, setPublicKey, toString, toString

Methods from java.lang.Object:
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method from java.security.IdentityScope Detail:
abstract public void addIdentity(Identity identity) throws KeyManagementException Deprecated! Adds an identity to this identity scope.
abstract public Identity getIdentity(String name) Deprecated! Returns the identity in this scope with the specified name (if any).
public Identity getIdentity(Principal principal) { return getIdentity(principal.getName()); } Deprecated! Retrieves the identity whose name is the same as that of the specified principal. (Note: Identity implements Principal.)
abstract public Identity getIdentity(PublicKey key) Deprecated! Retrieves the identity with the specified public key.
public static IdentityScope getSystemScope() { if (scope == null) { initializeSystemScope(); } return scope; } Deprecated! Returns the system's identity scope.
abstract public Enumeration<Identity> identities() Deprecated! Returns an enumeration of all identities in this identity scope.
abstract public void removeIdentity(Identity identity) throws KeyManagementException Deprecated! Removes an identity from this identity scope.
protected static void setSystemScope(IdentityScope scope) { check("setSystemScope"); IdentityScope.scope = scope; } Deprecated! 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.
abstract public int size() Deprecated! Returns the number of identities within this identity scope.
public String toString() { return super.toString() + "[" + size() + "]"; } Deprecated! Returns a string representation of this identity scope, including its name, its scope name, and the number of identities in this identity scope.