com.entrust.toolkit.x509.certstore

Class HTTPCS

java.lang.Object

com.entrust.toolkit.x509.certstore.CertificateStore

com.entrust.toolkit.x509.certstore.HTTPCS

public class HTTPCS
extends CertificateStore

Constructor Summary

Constructors

Constructor and Description
HTTPCS() Creates a HTTPCS that uses default connection and read timeout values.
HTTPCS(ValidationInfo valInfo) Creates a HTTPCS that reads certificates from the specified HTTP server.

Method Summary

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) This method is not supported by this class, as a DN has nothing to do with an HTTP address.
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

HTTPCS

public HTTPCS(ValidationInfo valInfo)

Creates a HTTPCS that reads certificates from the specified HTTP server.

Parameters:

valInfo - the validation info is used to obtain the User specified connection and read timeout values (from the UserConfigSettings object) If none is defined, the default values specified in HTTPConnection will be used.

Throws:

java.lang.NullPointerException - if valInfo is null

HTTPCS

public HTTPCS()

Creates a HTTPCS that uses default connection and read timeout values.

Method Detail

findCerts

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

This method is not supported by this class, as a DN has nothing to do with an HTTP address. However, since it extends CertificateStore, it must implement this method.

This method always returns null.

Specified by:

findCerts in class CertificateStore

Parameters:

dn -

Returns:

null

Throws:

CertificationException - if there is a problem finding the certificates.

Since:

7.2

findCerts

public CertificateSet findCerts(GeneralName location)
                         throws CertificationException

Generalized version of findCerts. This method will use a HTTP connection to retrieve certificates contained at the HTTP URI specified by GeneralName.uniformResourceIdentifier

The type of data must be a uniformResourceIdentifier. It will be parsed for validity, and the Http location will be used to retrieve the data specified by the URL which this location represents.

Overrides:

findCerts in class CertificateStore

Parameters:

location - a Uniform Resource Identifier (URI)

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 retrieved from the http location. Depending 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