|
Java™ Platform Standard Ed. 6 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object java.security.Identity java.security.IdentityScope
java.security.KeyStore
, the
java.security.cert
package, and
java.security.Principal
.
@Deprecated public abstract class IdentityScope
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
,
Serialized FormConstructor Summary | |
---|---|
protected |
IdentityScope()
Deprecated. This constructor is used for serialization only and should not be used by subclasses. |
|
IdentityScope(String name)
Deprecated. Constructs a new identity scope with the specified name. |
|
IdentityScope(String name,
IdentityScope scope)
Deprecated. Constructs a new identity scope with the specified name and scope. |
Method Summary | |
---|---|
abstract void |
addIdentity(Identity identity)
Deprecated. Adds an identity to this identity scope. |
Identity |
getIdentity(Principal principal)
Deprecated. Retrieves the identity whose name is the same as that of the specified principal. |
abstract Identity |
getIdentity(PublicKey key)
Deprecated. Retrieves the identity with the specified public key. |
abstract Identity |
getIdentity(String name)
Deprecated. Returns the identity in this scope with the specified name (if any). |
static IdentityScope |
getSystemScope()
Deprecated. Returns the system's identity scope. |
abstract Enumeration<Identity> |
identities()
Deprecated. Returns an enumeration of all identities in this identity scope. |
abstract void |
removeIdentity(Identity identity)
Deprecated. Removes an identity from this identity scope. |
protected static void |
setSystemScope(IdentityScope scope)
Deprecated. Sets the system's identity scope. |
abstract int |
size()
Deprecated. Returns the number of identities within this identity scope. |
String |
toString()
Deprecated. Returns a string representation of this identity scope, including its name, its scope name, and the number of identities in this identity scope. |
Methods inherited from class java.security.Identity |
---|
addCertificate, certificates, equals, getInfo, getName, getPublicKey, getScope, hashCode, identityEquals, removeCertificate, setInfo, setPublicKey, toString |
Methods inherited from class java.lang.Object |
---|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
Constructor Detail |
---|
protected IdentityScope()
public IdentityScope(String name)
name
- the scope name.public IdentityScope(String name, IdentityScope scope) throws KeyManagementException
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.Method Detail |
---|
public static IdentityScope getSystemScope()
setSystemScope(java.security.IdentityScope)
protected static void setSystemScope(IdentityScope 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)
public abstract int size()
public abstract Identity getIdentity(String name)
name
- the name of the identity to be retrieved.
name
, or null if there are
no identities named name
in this scope.public Identity getIdentity(Principal principal)
principal
- the principal corresponding to the identity
to be retrieved.
public abstract Identity getIdentity(PublicKey key)
key
- the public key for the identity to be returned.
public abstract void addIdentity(Identity identity) throws KeyManagementException
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.public abstract void removeIdentity(Identity identity) throws KeyManagementException
identity
- the identity to be removed.
KeyManagementException
- if the identity is missing,
or another exception occurs.public abstract Enumeration<Identity> identities()
public String toString()
toString
in interface Principal
toString
in class Identity
SecurityManager.checkSecurityAccess(java.lang.String)
|
Java™ Platform Standard Ed. 6 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Copyright © 1993, 2010, Oracle and/or its affiliates. All rights reserved.