com.itextpdf.signatures

Class CrlClientOnline

java.lang.Object

com.itextpdf.signatures.CrlClientOnline

All Implemented Interfaces:

ICrlClient

public class CrlClientOnline
extends Object
implements ICrlClient

An implementation of the CrlClient that fetches the CRL bytes from an URL.

Field Summary

Fields

Modifier and Type	Field and Description
protected List<URL>	urls The URLs of the CRLs.

Constructor Summary

Constructors

Constructor and Description
CrlClientOnline() Creates a CrlClientOnline instance that will try to find a single CRL by walking through the certificate chain.
CrlClientOnline(Certificate[] chain) Creates a CrlClientOnline instance using a certificate chain.
CrlClientOnline(String... crls) Creates a CrlClientOnline instance using one or more URLs.
CrlClientOnline(URL... crls) Creates a CrlClientOnline instance using one or more URLs.

Method Summary

Modifier and Type	Method and Description
protected void	addUrl(String url) Adds an URL to the list of CRL URLs
protected void	addUrl(URL url) Adds an URL to the list of CRL URLs
protected InputStream	getCrlResponse(X509Certificate cert, URL urlt) Get CRL response represented as InputStream.
Collection<byte[]>	getEncoded(X509Certificate checkCert, String url) Fetches the CRL bytes from an URL.
int	getUrlsSize()

Methods inherited from class java.lang.Object

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

Field Detail

urls

protected List<URL> urls

The URLs of the CRLs.

Constructor Detail

CrlClientOnline

public CrlClientOnline()

Creates a CrlClientOnline instance that will try to find a single CRL by walking through the certificate chain.

CrlClientOnline

public CrlClientOnline(String... crls)

Creates a CrlClientOnline instance using one or more URLs.

Parameters:

crls - the CRLs as Strings

CrlClientOnline

public CrlClientOnline(URL... crls)

Creates a CrlClientOnline instance using one or more URLs.

Parameters:

crls - the CRLs as URLs

CrlClientOnline

public CrlClientOnline(Certificate[] chain)

Creates a CrlClientOnline instance using a certificate chain.

Parameters:

chain - a certificate chain

Method Detail

getEncoded

public Collection<byte[]> getEncoded(X509Certificate checkCert,
                                     String url)
                              throws CertificateEncodingException

Fetches the CRL bytes from an URL. If no url is passed as parameter, the url will be obtained from the certificate. If you want to load a CRL from a local file, subclass this method and pass an URL with the path to the local file to this method. An other option is to use the CrlClientOffline class.

Specified by:

getEncoded in interface ICrlClient

Parameters:

checkCert - The certificate which a CRL URL can be obtained from.

url - A CRL url if you don't want to obtain it from the certificate.

Returns:

A collection of byte array each representing a crl. It may return null or an empty collection.

Throws:

CertificateEncodingException - if an encoding error occurs in X509Certificate.

See Also:

ICrlClient.getEncoded(java.security.cert.X509Certificate, java.lang.String)

getCrlResponse

protected InputStream getCrlResponse(X509Certificate cert,
                                     URL urlt)
                              throws IOException

Get CRL response represented as InputStream.

Parameters:

cert - X509Certificate certificate to get CRL response for

urlt - URL link, which is expected to be used to get CRL response from

Returns:

CRL response bytes, represented as InputStream

Throws:

IOException - if an I/O error occurs

addUrl

protected void addUrl(String url)

Adds an URL to the list of CRL URLs

Parameters:

url - an URL in the form of a String

addUrl

protected void addUrl(URL url)

Adds an URL to the list of CRL URLs

Parameters:

url - an URL object

getUrlsSize

public int getUrlsSize()