com.oracle.crypto.keystore

Class KeyStore

java.lang.Object

com.oracle.crypto.keystore.KeyStore

public class KeyStore
extends java.lang.Object

The class provides an access to the certificate storage

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	KeyStore.STORAGE Defines certificate storage for which the KeyStore instance is being created

Method Summary

Methods

Modifier and Type	Method and Description
void	addEntry(KeyStoreEntry entry) Adds a KeyStoreEntry instance to the storage
void	delEntry(java.lang.String dn) Removes a KeyStoreEntry with specified DN from the storage
KeyStoreEntry	findAllEntry(java.lang.String dn) Finds a KeyStoreEntry in the storage with desired subject DN.
KeyStoreEntry	findEntry(java.lang.String dn) Finds a KeyStoreEntry in the storage with desired subject DN.
java.util.List<KeyStoreEntry>	getAllEntries() Gets a list of all KeyStoreEntry from the storage.
java.util.List<KeyStoreEntry>	getEntries() Gets a list of KeyStoreEntry from the storage.
static KeyStore	getInstance(KeyStore.STORAGE storage) Return a KeyStore instance for current client or common used certificates

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getInstance

public static KeyStore getInstance(KeyStore.STORAGE storage)
                            throws java.lang.SecurityException,
                                   KeyStoreException

Return a KeyStore instance for current client or common used certificates

Parameters:

storage - defines which KeyStore is required. The COMMON value means common used certificates, CLIENT - certificates belonged to the current client only

Returns:

the KeyStore instance

Throws:

KeyStoreException - if the KeyStore instance can not be created

java.lang.SecurityException - if there is not the KeyStorePermission permission

addEntry

public void addEntry(KeyStoreEntry entry)
              throws KeyStoreException

Adds a KeyStoreEntry instance to the storage

Parameters:

entry - KeyStoreEntry instance to be stored

Throws:

KeyStoreException - if the KeyStoreEntry can not be added

findEntry

public KeyStoreEntry findEntry(java.lang.String dn)
                        throws KeyStoreException

Finds a KeyStoreEntry in the storage with desired subject DN. Only KeyStoreEntry with valid certificate will be returned.

Parameters:

dn - - distinguish name of certificate in form "field0=value0,field1=value1,...,fieldN=valueN" or "field0=value0;field1=value1;...;fieldN=valueN"

Returns:

a KeyStoreEntry object with the desired dn or null.

Throws:

KeyStoreException - in case of bad parameter (null)

findAllEntry

public KeyStoreEntry findAllEntry(java.lang.String dn)
                           throws KeyStoreException

Finds a KeyStoreEntry in the storage with desired subject DN. Test of the certificate(s) validity will not be executed.

Parameters:

dn - - distinguish name of certificate in form "field0=value0,field1=value1,...,fieldN=valueN" or "field0=value0;field1=value1;...;fieldN=valueN"

Returns:

a KeyStoreEntry object with the desired dn or null.

Throws:

KeyStoreException - in case of bad parameter (null)

getEntries

public java.util.List<KeyStoreEntry> getEntries()

Gets a list of KeyStoreEntry from the storage. Only KeyStoreEntry with valid certificate(s) will be returned.

Returns:

list of the KeyStoreEntry objects from the key store or null in case if there are not any KeyStoreEntry objects in the storage.

getAllEntries

public java.util.List<KeyStoreEntry> getAllEntries()

Gets a list of all KeyStoreEntry from the storage. Test of the certificate(s) validity will not be executed.

Returns:

list of the KeyStoreEntry objects from the key store or null in case if there are not any KeyStoreEntry objects in the key store.

delEntry

public void delEntry(java.lang.String dn)
              throws KeyStoreException

Removes a KeyStoreEntry with specified DN from the storage

Parameters:

dn - - distinguish name of certificate in form "field0=value0,field1=value1,...,fieldN=valueN" or "field0=value0;field1=value1;...;fieldN=valueN"

Throws:

KeyStoreException - if the KeyStoreEntry can not be deleted