net.named_data.jndn.security.v2

Class CertificateFetcher

java.lang.Object

net.named_data.jndn.security.v2.CertificateFetcher

Direct Known Subclasses:

CertificateFetcherFromNetwork, CertificateFetcherOffline

public abstract class CertificateFetcher
extends Object

CertificateFetcher is an abstract base class which provides an interface used by the validator to fetch missing certificates.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	CertificateFetcher.ValidationContinuation

Field Summary

Fields

Modifier and Type	Field and Description
protected CertificateStorage	certificateStorage_

Constructor Summary

Constructors

Constructor and Description
CertificateFetcher()

Method Summary

Modifier and Type	Method and Description
protected abstract void	doFetch(CertificateRequest certificateRequest, ValidationState state, CertificateFetcher.ValidationContinuation continueValidation) An implementation to fetch a certificate asynchronously.
void	fetch(CertificateRequest certificateRequest, ValidationState state, CertificateFetcher.ValidationContinuation continueValidation) Asynchronously fetch a certificate.
void	setCertificateStorage(CertificateStorage certificateStorage) Assign the certificate storage used to check for known certificates and to cache unverified ones.

Methods inherited from class java.lang.Object

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

Field Detail

certificateStorage_

protected CertificateStorage certificateStorage_

Constructor Detail

CertificateFetcher

public CertificateFetcher()

Method Detail

setCertificateStorage

public void setCertificateStorage(CertificateStorage certificateStorage)

Assign the certificate storage used to check for known certificates and to cache unverified ones.

Parameters:

certificateStorage - The certificate storage object which must be valid for the lifetime of this CertificateFetcher.

fetch

public final void fetch(CertificateRequest certificateRequest,
                        ValidationState state,
                        CertificateFetcher.ValidationContinuation continueValidation)
                 throws CertificateV2.Error,
                        ValidatorConfigError

Asynchronously fetch a certificate. setCertificateStorage must have been called first. If the requested certificate exists in the storage, then this method will immediately call continueValidation with the certificate. If certificate is not available, then the implementation-specific doFetch will be called to asynchronously fetch the certificate. The successfully-retrieved certificate will be automatically added to the unverified cache of the certificate storage. When the requested certificate is retrieved, continueValidation is called. Otherwise, the fetcher implementation calls state.failed() with the appropriate error code and diagnostic message.

Parameters:

certificateRequest - The the request with the Interest for fetching the certificate.

state - The validation state.

continueValidation - After fetching, this calls continueValidation.continueValidation(certificate, state) where certificate is the fetched certificate and state is the ValidationState.

Throws:

CertificateV2.Error

ValidatorConfigError

doFetch

protected abstract void doFetch(CertificateRequest certificateRequest,
                                ValidationState state,
                                CertificateFetcher.ValidationContinuation continueValidation)
                         throws CertificateV2.Error

An implementation to fetch a certificate asynchronously. The subclass must implement this method.

Parameters:

certificateRequest - The the request with the Interest for fetching the certificate.

state - The validation state.

continueValidation - After fetching, this calls continueValidation.continueValidation(certificate, state) where certificate is the fetched certificate and state is the ValidationState.

Throws:

CertificateV2.Error