Package eu.europa.esig.dss.service.crl

Class FileCacheCRLSource

java.lang.Object

eu.europa.esig.dss.spi.x509.revocation.RepositoryRevocationSource<CRL>

eu.europa.esig.dss.spi.x509.revocation.FileRevocationSource<CRL>

eu.europa.esig.dss.service.crl.FileCacheCRLSource

All Implemented Interfaces:

CRLSource, MultipleRevocationSource<CRL>, RevocationSource<CRL>, Serializable

public class FileCacheCRLSource
extends FileRevocationSource<CRL>
implements CRLSource

CRLSource that provides file-based caching functionality for CRL revocation data.

WARNING: The class represents an experimental functionality and included in the DSS version 6.3. Please note the class was not extensively tested.

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class eu.europa.esig.dss.spi.x509.revocation.FileRevocationSource

FileRevocationSource.FileCacheEntry

Field Summary

Fields inherited from class eu.europa.esig.dss.spi.x509.revocation.RepositoryRevocationSource

proxiedSource

Constructor Summary

Constructors

Constructor	Description
FileCacheCRLSource()	Empty constructor.
FileCacheCRLSource(CRLSource proxiedSource)	Constructor that initializes the file cache CRL source with a proxiedCRLSource provided.

Method Summary

Modifier and Type	Method	Description
protected List<String>	getRevocationAccessUrls(CertificateToken certificateToken)	Returns a revocation access URLs of the given revocation type for the provided CertificateToken
protected String	getRevocationFileExtension()	Gets the file extension used for cached revocation files.
CRLToken	getRevocationToken(CertificateToken certificateToken, CertificateToken issuerCertificateToken)	This method retrieves a RevocationToken for the certificateToken
CRLToken	getRevocationToken(CertificateToken certificateToken, CertificateToken issuerCertificateToken, boolean forceRefresh)	Retrieves a revocation token for the given CertificateToken
protected String	getRevocationTokenKey(CertificateToken certificateToken, String urlString)	Gets a unique revocation token identifier used to store the revocation token for this certificateToken within a repository
protected List<String>	initRevocationTokenKeys(CertificateToken certificateToken)	Initialize a list of revocation token keys String from the given CertificateToken
protected RevocationToken<CRL>	reconstructTokenFromEncodedData(FileRevocationSource<CRL>.FileCacheEntry revocationCache, CertificateToken certificateToken, CertificateToken issuerCertToken)	Creates a revocation token from cached encoded data
protected void	saveRevocationToken(FileRevocationSource<CRL>.FileCacheEntry revocationCache, RevocationToken<CRL> token)	Writes the revocationToken within the file system

Methods inherited from class eu.europa.esig.dss.spi.x509.revocation.FileRevocationSource

clearCache, deleteCacheFile, findRevocations, getFileCacheDirectory, insertRevocation, removeRevocation, setFileCacheDirectory, updateRevocation

Methods inherited from class eu.europa.esig.dss.spi.x509.revocation.RepositoryRevocationSource

getRevocationSourceUrl, getRevocationTokens, getRevocationTokens, isNotExpired, setDefaultNextUpdateDelay, setMaxNextUpdateDelay, setProxySource, setRemoveExpired

Methods inherited from class java.lang.Object

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

Constructor Details

FileCacheCRLSource

public FileCacheCRLSource()

Empty constructor. The proxied CRLSource can be provided using the #setProxySource method.

FileCacheCRLSource

public FileCacheCRLSource(CRLSource proxiedSource)

Constructor that initializes the file cache CRL source with a proxiedCRLSource provided.

Parameters:

proxiedSource - CRLSource to be used to load CRL when the corresponding revocation document is not available in the file system.

Method Details

reconstructTokenFromEncodedData

protected RevocationToken<CRL> reconstructTokenFromEncodedData(FileRevocationSource<CRL>.FileCacheEntry revocationCache,
 CertificateToken certificateToken,
 CertificateToken issuerCertToken)

Description copied from class: FileRevocationSource

Creates a revocation token from cached encoded data

Specified by:

reconstructTokenFromEncodedData in class FileRevocationSource<CRL>

Parameters:

revocationCache - FileRevocationSource<R extends Revocation>.FileCacheEntry the cached revocation data entry

certificateToken - CertificateToken the certificate token

issuerCertToken - CertificateToken the issuer certificate token

Returns:

the revocation token or null if creation fails

saveRevocationToken

protected void saveRevocationToken(FileRevocationSource<CRL>.FileCacheEntry revocationCache,
 RevocationToken<CRL> token)

Description copied from class: FileRevocationSource

Writes the revocationToken within the file system

Overrides:

saveRevocationToken in class FileRevocationSource<CRL>

Parameters:

revocationCache - FileRevocationSource<R extends Revocation>.FileCacheEntry

token - RevocationToken to store

getRevocationFileExtension

protected String getRevocationFileExtension()

Description copied from class: FileRevocationSource

Gets the file extension used for cached revocation files.

Specified by:

getRevocationFileExtension in class FileRevocationSource<CRL>

Returns:

the file extension (e.g., ".crl" or ".ocsp")

getRevocationTokenKey

protected String getRevocationTokenKey(CertificateToken certificateToken,
 String urlString)

Description copied from class: RepositoryRevocationSource

Gets a unique revocation token identifier used to store the revocation token for this certificateToken within a repository

Specified by:

getRevocationTokenKey in class RepositoryRevocationSource<CRL>

Parameters:

certificateToken - CertificateToken

urlString - String representing a URL used to download the revocation token from

Returns:

String revocation token key

getRevocationAccessUrls

protected List<String> getRevocationAccessUrls(CertificateToken certificateToken)

Description copied from class: RepositoryRevocationSource

Returns a revocation access URLs of the given revocation type for the provided CertificateToken

Specified by:

getRevocationAccessUrls in class RepositoryRevocationSource<CRL>

Parameters:

certificateToken - CertificateToken to get revocation URLs for

Returns:

a list of String URLs

initRevocationTokenKeys

protected List<String> initRevocationTokenKeys(CertificateToken certificateToken)

Description copied from class: RepositoryRevocationSource

Initialize a list of revocation token keys String from the given CertificateToken

Specified by:

initRevocationTokenKeys in class RepositoryRevocationSource<CRL>

Parameters:

certificateToken - CertificateToken

Returns:

list of String revocation keys

getRevocationToken

public CRLToken getRevocationToken(CertificateToken certificateToken,
 CertificateToken issuerCertificateToken,
 boolean forceRefresh)

Description copied from class: RepositoryRevocationSource

Retrieves a revocation token for the given CertificateToken

Overrides:

getRevocationToken in class RepositoryRevocationSource<CRL>

Parameters:

certificateToken - CertificateToken

issuerCertificateToken - CertificateToken of the issuer of certificateToken

forceRefresh - if true, explicitly skips the cache

Returns:

RevocationToken

getRevocationToken

public CRLToken getRevocationToken(CertificateToken certificateToken,
 CertificateToken issuerCertificateToken)

Description copied from interface: RevocationSource

This method retrieves a RevocationToken for the certificateToken

Specified by:

getRevocationToken in interface CRLSource

Specified by:

getRevocationToken in interface RevocationSource<CRL>

Overrides:

getRevocationToken in class RepositoryRevocationSource<CRL>

Parameters:

certificateToken - The CertificateToken for which the request is made

issuerCertificateToken - The CertificateToken which is the issuer of the certificateToken

Returns:

an instance of RevocationToken