Summary: Ctors | Methods | Inherited Methods | [Expand All]

public class

IdentityDatabase

extends IdentityScope
implements Serializable

java.lang.Object
↳	java.security.Identity
	↳	java.security.IdentityScope
		↳	sun.security.provider.IdentityDatabase

Class Overview

An implementation of IdentityScope as a persistent identity database.

Summary

Public Constructors
	IdentityDatabase(File file) Construct a new, empty database with a specified source file.
	IdentityDatabase(String name) Construct a new, empty database.

Public Methods
void	addIdentity(Identity identity) Adds an identity to the database.
static IdentityDatabase	fromFile(File f) Initialize an IdentityDatabase from file.
static IdentityDatabase	fromStream(InputStream is) Initialize an identity database from a stream.
Identity	getIdentity(String name) Returns the identity in this scope with the specified name (if any).
Identity	getIdentity(PublicKey key) Get an identity by key.
Enumeration<Identity>	identities() Returns an enumeration of all identities in this identity scope.
void	removeIdentity(Identity identity) Removes an identity to the database.
void	save() Saves the database to the default source file.
void	save(OutputStream os) Save the database in its current state to an output stream.
int	size() Returns the number of identities within this identity scope.
String	toString() Returns a string representation of this identity scope, including its name, its scope name, and the number of identities in this identity scope.

[Expand]

Inherited Methods

From class java.security.IdentityScope

abstract void	addIdentity(Identity identity) Adds an identity to this identity scope.
abstract Identity	getIdentity(String name) Returns the identity in this scope with the specified name (if any).
abstract Identity	getIdentity(PublicKey key) Retrieves the identity with the specified public key.
Identity	getIdentity(Principal principal) Retrieves the identity whose name is the same as that of the specified principal.
static IdentityScope	getSystemScope() Returns the system's identity scope.
abstract Enumeration<Identity>	identities() Returns an enumeration of all identities in this identity scope.
abstract void	removeIdentity(Identity identity) Removes an identity from this identity scope.
static void	setSystemScope(IdentityScope scope) Sets the system's identity scope.
abstract int	size() Returns the number of identities within this identity scope.
String	toString() Returns a string representation of this identity scope, including its name, its scope name, and the number of identities in this identity scope.

From class java.security.Identity

void	addCertificate(Certificate certificate) Adds a certificate for this identity.
Certificate[]	certificates() Returns a copy of all the certificates for this identity.
final boolean	equals(Object identity) Tests for equality between the specified object and this identity.
String	getInfo() Returns general information previously specified for this identity.
final String	getName() Returns this identity's name.
PublicKey	getPublicKey() Returns this identity's public key.
final IdentityScope	getScope() Returns this identity's scope.
int	hashCode() Returns a hashcode for this identity.
boolean	identityEquals(Identity identity) Tests for equality between the specified identity and this identity.
void	removeCertificate(Certificate certificate) Removes a certificate from this identity.
void	setInfo(String info) Specifies a general information string for this identity.
void	setPublicKey(PublicKey key) Sets this identity's public key.
String	toString(boolean detailed) Returns a string representation of this identity, with optionally more details than that provided by the `toString` method without any arguments.
String	toString() Returns a short string describing this identity, telling its name and its scope (if any).

From class java.lang.Object

Object	clone() Creates and returns a copy of this object.
boolean	equals(Object obj) Indicates whether some other object is "equal to" this one.
void	finalize() Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
final Class<?>	getClass() Returns the runtime class of this `Object`.
int	hashCode() Returns a hash code value for the object.
final void	notify() Wakes up a single thread that is waiting on this object's monitor.
final void	notifyAll() Wakes up all threads that are waiting on this object's monitor.
String	toString() Returns a string representation of the object.
final void	wait() Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.
final void	wait(long timeout, int nanos) Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
final void	wait(long timeout) Causes the current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.

From interface java.security.Principal

Public Constructors

public IdentityDatabase (File file)

Construct a new, empty database with a specified source file.

Parameters

file	the source file.

Throws

InvalidParameterException

public IdentityDatabase (String name)

Construct a new, empty database.

Throws

InvalidParameterException

Public Methods

public void addIdentity (Identity identity)

Adds an identity to the database.

Parameters

identity	the identity to be added.

Throws

KeyManagementException	if a name or key clash occurs, or if another exception occurs.

public static IdentityDatabase fromFile (File f)

Initialize an IdentityDatabase from file.

Parameters

f	the filename where the identity database is stored.

Throws

IOException	a file-related exception occurs (e.g. the directory of the file passed does not exists, etc.

public static IdentityDatabase fromStream (InputStream is)

Initialize an identity database from a stream. The stream should contain data to initialized a serialized IdentityDatabase object.

Parameters

is	the input stream from which to restore the database.

Throws

IOException	if a stream IO exception occurs

public Identity getIdentity (String name)

Returns the identity in this scope with the specified name (if any).

Parameters

name	the name of the identity to be retrieved.

Returns

the identity named name, or null if there are no identities named name in the database.

public Identity getIdentity (PublicKey key)

Get an identity by key.

Parameters

key	the public key for the identity to be returned.

Returns

the identity with a given key, or null if there are no identities with that key in the database.

public Enumeration<Identity> identities ()

Returns an enumeration of all identities in this identity scope.

Returns

an enumeration of all identities in the database.

public void removeIdentity (Identity identity)

Removes an identity to the database.

Parameters

identity	the identity to be removed.

Throws

KeyManagementException

public void save ()

Saves the database to the default source file.

Throws

KeyManagementException	when there is no default source file specified for this database.
IOException

public void save (OutputStream os)

Save the database in its current state to an output stream.

Parameters

os	the output stream to which the database should be serialized.

Throws

IOException	if an IO exception is raised by stream operations.

public int size ()

Returns the number of identities within this identity scope.

Returns

the number of identities in the database.

public String toString ()

Returns a string representation of this identity scope, including its name, its scope name, and the number of identities in this identity scope.

Returns

a string representation of this identity scope.

Classes

Exceptions

IdentityDatabase

Class Overview

See Also

Summary

Public Constructors

public IdentityDatabase (File file)

Parameters

Throws

public IdentityDatabase (String name)

Throws

Public Methods

public void addIdentity (Identity identity)

Parameters

Throws

public static IdentityDatabase fromFile (File f)

Parameters

Throws

public static IdentityDatabase fromStream (InputStream is)

Parameters

Throws

public Identity getIdentity (String name)

Parameters

Returns

public Identity getIdentity (PublicKey key)

Parameters

Returns

public Enumeration<Identity> identities ()

Returns

public void removeIdentity (Identity identity)

Parameters

Throws

public void save ()

Throws

public void save (OutputStream os)

Parameters

Throws

public int size ()

Returns

public String toString ()

Returns