java.security.cert

Class CertificateFactorySpi

java.lang.Object

java.security.cert.CertificateFactorySpi

Direct Known Subclasses:

CertificateFactory, OpenSSLX509CertificateFactory

public abstract class CertificateFactorySpi
extends Object

This class defines the Service Provider Interface (SPI) for the CertificateFactory class. This SPI must be implemented for each certificate type a security provider wishes to support.

Constructor Summary

Constructors

Constructor and Description
CertificateFactorySpi() Constructs a new instance of this class.

Method Summary

Modifier and Type	Method and Description
abstract Certificate	engineGenerateCertificate(InputStream inStream) Generates and initializes a Certificate from the provided input stream.
abstract Collection<? extends Certificate>	engineGenerateCertificates(InputStream inStream) Generates and initializes a collection of certificates from the provided input stream.
CertPath	engineGenerateCertPath(InputStream inStream) Generates a CertPath from the provided InputStream.
CertPath	engineGenerateCertPath(InputStream inStream, String encoding) Generates a CertPath (a certificate chain) from the given inputStream, assuming the given encoding from engineGetCertPathEncodings().
CertPath	engineGenerateCertPath(List<? extends Certificate> certificates) Generates a CertPath from the provided list of certificates.
abstract CRL	engineGenerateCRL(InputStream inStream) Generates and initializes a Certificate Revocation List (CRL) from the provided input stream.
abstract Collection<? extends CRL>	engineGenerateCRLs(InputStream inStream) Generates and initializes a collection of Certificate Revocation List (CRL) from the provided input stream.
Iterator<String>	engineGetCertPathEncodings() Returns an Iterator over the supported CertPath encodings (as Strings).

Methods inherited from class java.lang.Object

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

Constructor Detail

CertificateFactorySpi

public CertificateFactorySpi()

Constructs a new instance of this class.

Method Detail

engineGenerateCertificate

public abstract Certificate engineGenerateCertificate(InputStream inStream)
                                               throws CertificateException

Generates and initializes a Certificate from the provided input stream.

Parameters:

inStream - the stream from which the data is read to create the certificate.

Returns:

an initialized certificate.

Throws:

CertificateException - if parsing problems are detected.

engineGenerateCertificates

public abstract Collection<? extends Certificate> engineGenerateCertificates(InputStream inStream)
                                                                      throws CertificateException

Generates and initializes a collection of certificates from the provided input stream.

Parameters:

inStream - the stream from where data is read to create the certificates.

Returns:

a collection of certificates.

Throws:

CertificateException - if parsing problems are detected.

engineGenerateCRL

public abstract CRL engineGenerateCRL(InputStream inStream)
                               throws CRLException

Generates and initializes a Certificate Revocation List (CRL) from the provided input stream.

Parameters:

inStream - the stream from where data is read to create the CRL.

Returns:

an CRL instance.

Throws:

CRLException - if parsing problems are detected.

engineGenerateCRLs

public abstract Collection<? extends CRL> engineGenerateCRLs(InputStream inStream)
                                                      throws CRLException

Generates and initializes a collection of Certificate Revocation List (CRL) from the provided input stream.

Parameters:

inStream - the stream from which the data is read to create the CRLs.

Returns:

a collection of CRLs.

Throws:

CRLException - if parsing problems are detected.

engineGenerateCertPath

public CertPath engineGenerateCertPath(InputStream inStream)
                                throws CertificateException

Generates a CertPath from the provided InputStream. The default encoding scheme is applied.

Parameters:

inStream - an input stream with encoded data.

Returns:

a CertPath initialized from the provided data.

Throws:

CertificateException - if parsing problems are detected.

engineGenerateCertPath

public CertPath engineGenerateCertPath(InputStream inStream,
                                       String encoding)
                                throws CertificateException

Generates a CertPath (a certificate chain) from the given inputStream, assuming the given encoding from engineGetCertPathEncodings().

Throws:

CertificateException - if parsing problems are detected.

UnsupportedOperationException - if the provider does not implement this method.

engineGenerateCertPath

public CertPath engineGenerateCertPath(List<? extends Certificate> certificates)
                                throws CertificateException

Generates a CertPath from the provided list of certificates. The encoding is the default encoding.

Parameters:

certificates - the list containing certificates in a format supported by the CertificateFactory.

Returns:

a CertPath initialized from the provided data.

Throws:

CertificateException - if parsing problems are detected.

UnsupportedOperationException - if the provider does not implement this method.

engineGetCertPathEncodings

public Iterator<String> engineGetCertPathEncodings()

Returns an Iterator over the supported CertPath encodings (as Strings). The first element is the default encoding.

Returns:

an iterator over supported CertPath encodings (as Strings).