public abstract class

Identity

extends Object
implements Serializable Principal

java.lang.Object
↳	java.security.Identity

Known Direct Subclasses

IdentityScope, Signer

This class is deprecated.
The functionality of this class has been replace by Principal, KeyStore and the java.security.cert package.

Class Overview

Identity represents an identity like a person or a company.

Summary

Public Constructors
	Identity(String name) Creates a new instance of `Identity` with the specified name.
	Identity(String name, IdentityScope scope) Creates a new instance of `Identity` with the specified name and the scope of this `Identity`.

Protected Constructors
	Identity() Constructs a new instance of `Identity`.

Public Methods
void	addCertificate(Certificate certificate) Adds a `Certificate` to this `Identity`.
Certificate[]	certificates() Returns the certificates for this `Identity`.
final boolean	equals(Object obj) Compares the specified object with this `Identity` for equality and returns `true` if the specified object is equal, `false` otherwise.
String	getInfo() Returns the information string of this `Identity`.
final String	getName() Returns the name of this `Identity`.
PublicKey	getPublicKey() Returns the `PublicKey` associated with this `Identity`.
final IdentityScope	getScope() Returns the `IdentityScope` of this `Identity`.
int	hashCode() Returns the hash code value for this `Identity`.
void	removeCertificate(Certificate certificate) Removes the specified `Certificate` from this `Identity`.
void	setInfo(String info) Sets an information string for this `Identity`.
void	setPublicKey(PublicKey key) Sets the specified `PublicKey` to this `Identity`.
String	toString(boolean detailed) Returns a string containing a concise, human-readable description of the this `Identity`.
String	toString() Returns a string containing a concise, human-readable description of the this `Identity` including its name and its scope.

Protected Methods
boolean	identityEquals(Identity identity) Compares the specified `Identity` with this `Identity` for equality and returns `true` if the specified object is equal, `false` otherwise.

[Expand]

Inherited Methods

From class java.lang.Object

Object	clone() Creates and returns a copy of this `Object`.
boolean	equals(Object o) Compares this instance with the specified object and indicates if they are equal.
void	finalize() Invoked when the garbage collector has detected that this instance is no longer reachable.
final Class<?>	getClass() Returns the unique instance of `Class` that represents this object's class.
int	hashCode() Returns an integer hash code for this object.
final void	notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
final void	notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
String	toString() Returns a string containing a concise, human-readable description of this object.
final void	wait() Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object.
final void	wait(long millis, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait(long millis) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.

From interface java.security.Principal

Public Constructors

public Identity (String name)

Since: API Level 1

Creates a new instance of Identity with the specified name.

Parameters

name	the name of this `Identity`.

public Identity (String name, IdentityScope scope)

Since: API Level 1

Creates a new instance of Identity with the specified name and the scope of this Identity.

Parameters

name	the name of this `Identity`.
scope	the `IdentityScope` of this `Identity`.

Throws

KeyManagementException	if an `Identity` with the same name is already present in the specified scope.

Protected Constructors

protected Identity ()

Since: API Level 1

Constructs a new instance of Identity.

Public Methods

public void addCertificate (Certificate certificate)

Since: API Level 1

Adds a Certificate to this Identity.

Parameters

certificate	the `Certificate` to be added to this `Identity`.

Throws

KeyManagementException	if the certificate is not valid.

public Certificate[] certificates ()

Since: API Level 1

Returns the certificates for this Identity. External modifications of the returned array has no impact on this Identity.

Returns

the Certificates for this Identity

public final boolean equals (Object obj)

Since: API Level 1

Compares the specified object with this Identity for equality and returns true if the specified object is equal, false otherwise. Identity objects are considered equal, if they have the same name and are in the same scope.

Parameters

obj	object to be compared for equality with this `Identity`.

Returns

true if the specified object is equal to this Identity, otherwise false.

public String getInfo ()

Since: API Level 1

Returns the information string of this Identity.

Returns

the information string of this Identity.

public final String getName ()

Since: API Level 1

Returns the name of this Identity.

Returns

the name of this Identity.

public PublicKey getPublicKey ()

Since: API Level 1

Returns the PublicKey associated with this Identity.

Returns

the PublicKey associated with this Identity.

public final IdentityScope getScope ()

Since: API Level 1

Returns the IdentityScope of this Identity.

Returns

the IdentityScope of this Identity.

public int hashCode ()

Since: API Level 1

Returns the hash code value for this Identity. Returns the same hash code for Identitys that are equal to each other as required by the general contract of hashCode().

Returns

the hash code value for this Identity.

public void removeCertificate (Certificate certificate)

Since: API Level 1

Removes the specified Certificate from this Identity.

Parameters

certificate	the `Certificate` to be removed.

Throws

KeyManagementException	if the certificate is not found.

public void setInfo (String info)

Since: API Level 1

Sets an information string for this Identity.

Parameters

info	the information to be set.

public void setPublicKey (PublicKey key)

Since: API Level 1

Sets the specified PublicKey to this Identity.

Parameters

key	the `PublicKey` to be set.

Throws

KeyManagementException	if another `Identity` in the same scope as this `Identity` already has the same `PublicKey`.

public String toString (boolean detailed)

Since: API Level 1

Returns a string containing a concise, human-readable description of the this Identity.

Parameters

detailed	whether or not this method should return detailed information.

Returns

a printable representation for this Permission.

public String toString ()

Since: API Level 1

Returns a string containing a concise, human-readable description of the this Identity including its name and its scope.

Returns

a printable representation for this Identity.

Protected Methods

protected boolean identityEquals (Identity identity)

Since: API Level 1

Compares the specified Identity with this Identity for equality and returns true if the specified object is equal, false otherwise.

To be equal, two Identity objects need to have the same name and the same public keys.

Parameters

identity	the identity to check for equality.

Returns

true if the Identity objects are equal, false otherwise.

Interfaces

Classes

Enums

Exceptions

Identity

Class Overview

Summary

Public Constructors

public Identity (String name)

Parameters

public Identity (String name, IdentityScope scope)

Parameters

Throws

Protected Constructors

protected Identity ()

Public Methods

public void addCertificate (Certificate certificate)

Parameters

Throws

public Certificate[] certificates ()

Returns

public final boolean equals (Object obj)

Parameters

Returns

public String getInfo ()

Returns

public final String getName ()

Returns

public PublicKey getPublicKey ()

Returns

public final IdentityScope getScope ()

Returns

public int hashCode ()

Returns

See Also

public void removeCertificate (Certificate certificate)

Parameters

Throws

public void setInfo (String info)

Parameters

public void setPublicKey (PublicKey key)

Parameters

Throws

public String toString (boolean detailed)

Parameters

Returns

public String toString ()

Returns

Protected Methods

protected boolean identityEquals (Identity identity)

Parameters

Returns