All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class java.security.Identity

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

public class Identity

extends Object

implements Principal, Serializable

This class represents identities: real-world objects such as people, companies or organizations that can be authenticated using a public key. Identities may also be more abstract (or concrete) constructs, such as daemon threads or smart cards.

All Identity objects have a name and a public key. Names are immutable. Identities may also be scoped. That is, if an Identity is specified to have a particular scope, then the name and public key of the Identity are unique within that scope.

An Identity also has a set of certificates (all for its own key). The Principal names specified in these certificates need not be the same, only the key.

An Identity can be subclassed, to include postal and email addresses, telephone numbers, images of faces and logos, and so on.

See Also:

IdentityScope, Signer, Principal

Identity()

Constructor for serialization only.

Identity(String)

Constructs an identity with the specified name and no scope.

Identity(String, IdentityScope)

Constructs an identity with the specified name and scope.

addCertificate(Certificate)

Adds a certificate to this identity.

certificates()

Returns a copy of all the certificates for this identity.

equals(Object)

Tests for equality between the specified object and this identity.

getInfo()

Returns general information previously specified for this identity.

getName()

Returns this identity's name.

getPublicKey()

Return this identity's public key.

getScope()

Returns this identity's scope.

hashCode()

Returns a hashcode for this identity.

identityEquals(Identity)

This method should be overriden by subclasses to test for equality.

removeCertificate(Certificate)

Removes a certificate from this identity.

setInfo(String)

Specifies a general information string for this identity.

setPublicKey(PublicKey)

Set this identity's public key.

toString()

Returns a succint and human-readable view of this identity.

toString(boolean)

Returns a human-readable representation of this identity, with optionally more details than that provided by the toString method without any arguments.

  protected Identity()

Constructor for serialization only.

  public Identity(String name,
                  IdentityScope scope) throws KeyManagementException

Constructs an identity with the specified name and scope.

Parameters:

name - the identity name.

scope - the scope of the identity

Throws: KeyManagementException

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

  public Identity(String name)

Constructs an identity with the specified name and no scope.

Parameters:

name - the identity name.

  public final String getName()

Returns this identity's name.

Returns:

the name of this identity.

  public final IdentityScope getScope()

Returns this identity's scope.

Returns:

the scope of this identity.

  public PublicKey getPublicKey()

Return this identity's public key.

Returns:

the public key for this identity.

  protected void setPublicKey(PublicKey key) throws KeyManagementException

Set this identity's public key. The old key and all of this identity's certificates are removed by this operation.

Parameters:

key - the public key for this identity.

Throws: KeyManagementException

if another identity in the identity's scope has the same public key.

  protected void setInfo(String info)

Specifies a general information string for this identity.

Parameters:

info - the information string.

See Also:

getInfo

  public String getInfo()

Returns general information previously specified for this identity.

Returns:

general information about this identity.

See Also:

setInfo

  protected void addCertificate(Certificate certificate) throws KeyManagementException

Adds a certificate to this identity. If the identity has a public key, the public key in the certificate must be the same, and if the identity does not have a public key, the identity's public key is set to be that specified in the certificate.

Parameters:

certificate - the certificate to be added.

Throws: KeyManagementException

if the certificate is not valid, if the public key in the certificate being added conflicts with this identity's public key, or if another exception occurs.

  protected void removeCertificate(Certificate certificate) throws KeyManagementException

Removes a certificate from this identity.

Parameters:

certificate - the certificate to be removed.

Throws: KeyManagementException

if the certificate is missing, or if another exception occurs.

  public Certificate[] certificates()

Returns a copy of all the certificates for this identity.

Returns:

a copy of all the certificates for this identity.

  public final boolean equals(Object identity)

Tests for equality between the specified object and this identity. This first tests to see if the entities are the same. Entities which have the same name and the same scope are always considered the same. Subclasses should override identityEquals.

Parameters:

identity - the object to test for equality with this identity.

Returns:

true if the objects are considered equal, false otherwise.

Overrides:

equals in class Object

See Also:

identityEquals

  protected boolean identityEquals(Identity identity)

This method should be overriden by subclasses to test for equality. The default behavior is to return true if the names and public keys are equal.

Parameters:

identity - the identity to test for equality with this identity.

  public String toString()

Returns a succint and human-readable view of this identity.

Returns:

information about this identity, such as its name and the name of its scope (if any).

Overrides:

toString in class Object

  public String toString(boolean detailed)

Returns a human-readable representation of this identity, with optionally more details than that provided by the toString method without any arguments.

Parameters:

detailed - whether or not to provide detailed information.

Returns:

information about this identity. If detailed is true, then this method returns more information than that provided by the toString method without any arguments.

See Also:

toString

  public int hashCode()

Returns a hashcode for this identity.

Returns:

a hashcode for this identity.

Overrides:

hashCode in class Object

All Packages  Class Hierarchy  This Package  Previous  Next  Index