com.entrust.toolkit.x509.certstore

Class CACrossCertCS

java.lang.Object

com.entrust.toolkit.x509.certstore.CertificateStore

com.entrust.toolkit.x509.certstore.CACrossCertCS

public class CACrossCertCS
extends CertificateStore

This certificate store contains the cross certificates of a CA.

Constructor Summary

Constructors

Constructor and Description
CACrossCertCS(ValidationInfo valInfo) Creates a certificate store that contains cross certificates.

Method Summary

Methods

Modifier and Type	Method and Description
void	clearCache() Clears the URL Cache.
CertificateSet	findCerts(GeneralName location) Generalized version of findCerts.
CertificateSet	findCerts(java.security.Principal dn) Returns all certificates for the entity specified in dn.
void	useCache(boolean useCache) Setting which allows the URL cache to be turned on or off.

Methods inherited from class com.entrust.toolkit.x509.certstore.CertificateStore

find

Methods inherited from class java.lang.Object

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

Constructor Detail

CACrossCertCS

public CACrossCertCS(ValidationInfo valInfo)

Creates a certificate store that contains cross certificates.

Parameters:

valInfo - the validation info that links to the ldap directory to read the cross certificates from

Throws:

java.lang.NullPointerException - if valInfo is null

Method Detail

findCerts

public CertificateSet findCerts(java.security.Principal dn)
                         throws CertificationException

Returns all certificates for the entity specified in dn. If no certificate is found, this method returns null.

Specified by:

findCerts in class CertificateStore

Parameters:

dn - the distinguished name of the key owner

Returns:

the certificates of dn or null if no certificates for dn are found in this CertificateStore

Throws:

CertificationException - if there was an error communicating with the Directory.

Since:

7.0

findCerts

public CertificateSet findCerts(GeneralName location)
                         throws CertificationException

Generalized version of findCerts. This method will use a directory to retrieve DN's contained in either a GeneralName.uniformResourceIdentifier or a GeneralName.directoryName structure.

If the type of data is a uniformResourceIdentifier, it will be parsed using the LdapURL class and the DN and directory information will be used to retrieve the data specified by the LdapURL.

If the type of data is a directoryName, this method will pass the information to findCerts(Principal) to retrieve the data specified by the directoryName.

Overrides:

findCerts in class CertificateStore

Parameters:

location - A Uniform Resource Identifier (URI) or directoryName.

Returns:

A CertificateSet containing the retrieved data, or null if none can be found.

Throws:

CertificationException - if there is a problem finding the certificates.

Since:

7.2

clearCache

public void clearCache()

Clears the URL Cache.

Since:

7.2

useCache

public void useCache(boolean useCache)

Setting which allows the URL cache to be turned on or off. This cache is used to store the certificate information retreived from the directory. Dending on how this class is used, it is possible that the same type of data will be requested from this CertificateStore many times. This cache greatly improves IO performance by getting the data from the Cache if it is available instead of the network.

Note: The cache is only used by method findCerts(GeneralName). By default the cache is turned on.

Parameters:

useCache - a boolean indicate whether cache should be used

Since:

7.2