java.security
Class Identity

java.lang.Object
  java.security.Identity

All Implemented Interfaces:

Serializable, Principal

Direct Known Subclasses:

IdentityScope, Signer

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

@Deprecated
public abstract class Identity
extends Object
implements Principal, Serializable

Identity represents an identity like a person or a company.

Since:

Android 1.0

See Also:

Serialized Form

Constructor Summary

protected	Identity() Deprecated. Constructs a new instance of Identity.
	Identity(String name) Deprecated. Creates a new instance of Identity with the specified name.
	Identity(String name, IdentityScope scope) Deprecated. Creates a new instance of Identity with the specified name and the scope of this Identity.

Method Summary

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

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

Identity

protected Identity()

Deprecated.

Constructs a new instance of Identity.

Since:

Android 1.0

Identity

public Identity(String name)

Deprecated.

Creates a new instance of Identity with the specified name.

Parameters:

name - the name of this Identity.

Since:

Android 1.0

Identity

public Identity(String name,
                IdentityScope scope)
         throws KeyManagementException

Deprecated.

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.

Since:

Android 1.0

Method Detail

addCertificate

public void addCertificate(Certificate certificate)
                    throws KeyManagementException

Deprecated.

Adds a Certificate to this Identity.

If a SecurityManager is installed, code calling this method needs the SecurityPermission addIdentityCertificate to be granted, otherwise a SecurityException will be thrown.

Parameters:

certificate - the Certificate to be added to this Identity.

Throws:

KeyManagementException - if the certificate is not valid.

SecurityException - if a SecurityManager is installed and the caller does not have permission to invoke this method.

Since:

Android 1.0

removeCertificate

public void removeCertificate(Certificate certificate)
                       throws KeyManagementException

Deprecated.

Removes the specified Certificate from this Identity.

If a SecurityManager is installed, code calling this method needs the SecurityPermission "removeIdentityCertificate" to be granted, otherwise a SecurityException will be thrown.

Parameters:

certificate - the Certificate to be removed.

Throws:

KeyManagementException - if the certificate is not found.

SecurityException - if a SecurityManager is installed and the caller does not have permission to invoke this method.

Since:

Android 1.0

certificates

public Certificate[] certificates()

Deprecated.

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

Returns:

the Certificates for this Identity

Since:

Android 1.0

identityEquals

protected boolean identityEquals(Identity identity)

Deprecated.

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.

Since:

Android 1.0

toString

public String toString(boolean detailed)

Deprecated.

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.

Since:

Android 1.0

getScope

public final IdentityScope getScope()

Deprecated.

Returns the IdentityScope of this Identity.

Returns:

the IdentityScope of this Identity.

Since:

Android 1.0

setPublicKey

public void setPublicKey(PublicKey key)
                  throws KeyManagementException

Deprecated.

Sets the specified PublicKey to this Identity.

If a SecurityManager is installed, code calling this method needs the SecurityPermission setIdentityPublicKey to be granted, otherwise a SecurityException will be thrown.

Parameters:

key - the PublicKey to be set.

Throws:

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

SecurityException - if a SecurityManager is installed and the caller does not have permission to invoke this method.

Since:

Android 1.0

getPublicKey

public PublicKey getPublicKey()

Deprecated.

Returns the PublicKey associated with this Identity.

Returns:

the PublicKey associated with this Identity.

Since:

Android 1.0

setInfo

public void setInfo(String info)

Deprecated.

Sets an information string for this Identity.

If a SecurityManager is installed, code calling this method needs the SecurityPermission setIdentityInfo to be granted, otherwise a SecurityException will be thrown.

Parameters:

info - the information to be set.

Throws:

SecurityException - if a SecurityManager is installed and the caller does not have permission to invoke this method.

Since:

Android 1.0

getInfo

public String getInfo()

Deprecated.

Returns the information string of this Identity.

Returns:

the information string of this Identity.

Since:

Android 1.0

equals

public final boolean equals(Object obj)

Deprecated.

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.

Specified by:

equals in interface Principal

Overrides:

equals in class Object

Parameters:

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

Returns:

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

Since:

Android 1.0

See Also:

Object.hashCode()

getName

public final String getName()

Deprecated.

Returns the name of this Identity.

Specified by:

getName in interface Principal

Returns:

the name of this Identity.

Since:

Android 1.0

hashCode

public int hashCode()

Deprecated.

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 Object.hashCode().

Specified by:

hashCode in interface Principal

Overrides:

hashCode in class Object

Returns:

the hash code value for this Identity.

Since:

Android 1.0

See Also:

Object.equals(Object), equals(Object)

toString

public String toString()

Deprecated.

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

If a SecurityManager is installed, code calling this method needs the SecurityPermission printIdentity to be granted, otherwise a SecurityException will be thrown.

Specified by:

toString in interface Principal

Overrides:

toString in class Object

Returns:

a printable representation for this Identity.

Throws:

SecurityException - if a SecurityManager is installed and the caller does not have permission to invoke this method.

Since:

Android 1.0