com.entrust.toolkit.keystore

Class CertStore

java.lang.Object

com.entrust.toolkit.keystore.CertStore

public class CertStore
extends java.lang.Object

The CertStore class reads and writes certificates.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	ALG_STRING_3DES
static java.lang.String	ALG_STRING_CAST
static java.lang.String	ALG_STRING_DES
static java.lang.String	ALG_STRING_IDEA
static boolean	DEBUG

Constructor Summary

Constructors

Constructor and Description
CertStore(boolean write) Creates an empty certificate store.
CertStore(java.lang.String path, SecureStringBuffer password, boolean write) Creates a new CertStore object.

Method Summary

Modifier and Type	Method and Description
void	addCertificate(java.security.cert.Certificate cert, java.lang.String alias) Adds a certificate to this certificate store.
boolean	containsAlias(java.lang.String alias) Returns true if the certificate store contains a certificate for the given alias.
void	deleteAllCertificates() Deletes all certificates from this certificate store.
void	deleteCertificate(java.lang.String alias) Deletes the certificate with the given alias from this certificate store.
java.lang.String	getAlias(java.security.cert.Certificate cert) Returns the alias of the given certificate, or null if the certificate cannot be found.
java.lang.String[]	getAliases() Returns all aliases contained in this certificate store.
java.security.cert.Certificate	getCertificate(java.lang.String alias) Returns the certificate with the given alias.
boolean	isWriteStore() Returns true if this is a read/write store, and false if it is a read-only store.
int	size() Returns the number of entries this certificate store contains.
void	store() Writes this certicate store to the p12 file if it is a read/write certificate store.
void	store(java.io.OutputStream os, SecureStringBuffer pwd) Writes this certificate store to the given output stream and protects it with the given password.

Methods inherited from class java.lang.Object

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

Field Detail

ALG_STRING_CAST

public static final java.lang.String ALG_STRING_CAST

See Also:

Constant Field Values

ALG_STRING_DES

public static final java.lang.String ALG_STRING_DES

See Also:

Constant Field Values

ALG_STRING_3DES

public static final java.lang.String ALG_STRING_3DES

See Also:

Constant Field Values

ALG_STRING_IDEA

public static final java.lang.String ALG_STRING_IDEA

See Also:

Constant Field Values

DEBUG

public static final boolean DEBUG

See Also:

Constant Field Values

Constructor Detail

CertStore

public CertStore(java.lang.String path,
                 SecureStringBuffer password,
                 boolean write)
          throws java.io.IOException

Creates a new CertStore object.

The CertStore is checked to determine if the given CertStore already exists. If so, the certificates from this CertStore are read.

Parameters:

path - the full pathname to the certificate store (*.p12)

password - the password used to protect the certificate store

write - indicates whether this certificate store is used for writing certificates (true), or for reading certificates (false)

Throws:

java.lang.IllegalArgumentException - thrown if path does not point to a .p12 file

java.io.IOException - Thrown if a certificate with the given path exists, but cannot be read

CertStore

public CertStore(boolean write)

Creates an empty certificate store.

Add certificates by calling the addCertificate method.

Parameters:

write - true to create a read/write cert store, false to create a read-only store

Method Detail

isWriteStore

public boolean isWriteStore()

Returns true if this is a read/write store, and false if it is a read-only store.

Returns:

true if this is a read/write store

addCertificate

public void addCertificate(java.security.cert.Certificate cert,
                           java.lang.String alias)

Adds a certificate to this certificate store.

If a certificate already exists with the given alias, the old entry is overwritten.

Parameters:

cert - the certificate to be added to the certificate store

alias - the alias under which the certificate will be stored

deleteCertificate

public void deleteCertificate(java.lang.String alias)

Deletes the certificate with the given alias from this certificate store.

If there is no certificate with the given alias in the certificate store, the method returns without doing anything.

Parameters:

alias - the alias of the certificate to be deleted

deleteAllCertificates

public void deleteAllCertificates()

Deletes all certificates from this certificate store.

getCertificate

public java.security.cert.Certificate getCertificate(java.lang.String alias)

Returns the certificate with the given alias.

Parameters:

alias - the alias of the certificate to be returned, if it is found

containsAlias

public boolean containsAlias(java.lang.String alias)

Returns true if the certificate store contains a certificate for the given alias.

Parameters:

alias - the alias of the certificate to be found

getAliases

public java.lang.String[] getAliases()

Returns all aliases contained in this certificate store.

Returns:

all aliases from this certificate store

getAlias

public java.lang.String getAlias(java.security.cert.Certificate cert)

Returns the alias of the given certificate, or null if the certificate cannot be found.

Returns:

the alias of the certificate

size

public int size()

Returns the number of entries this certificate store contains.

Returns:

number of certificates in the certificate store

store

public void store()
           throws java.io.IOException

Writes this certicate store to the p12 file if it is a read/write certificate store.

Throws:

java.io.IOException - thrown if the certificate store cannot be written

store

public void store(java.io.OutputStream os,
                  SecureStringBuffer pwd)
           throws java.io.IOException

Writes this certificate store to the given output stream and protects it with the given password.

Throws:

java.io.IOException - thrown if the certificate store cannot be stored