Package org.apache.harmony.security.provider.cert

Class X509CertFactoryImpl

java.lang.Object

java.security.cert.CertificateFactorySpi

org.apache.harmony.security.provider.cert.X509CertFactoryImpl

public class X509CertFactoryImpl
extends CertificateFactorySpi

X509 Certificate Factory Service Provider Interface Implementation. It supports CRLs and Certificates in (PEM) ASN.1 DER encoded form, and Certification Paths in PkiPath and PKCS7 formats. For Certificates and CRLs factory maintains the caching mechanisms allowing to speed up repeated Certificate/CRL generation.

See Also:

Cache

Constructor Summary

Constructors

Constructor	Description
X509CertFactoryImpl()	Default constructor.

Method Summary

Modifier and Type	Method	Description
Certificate	engineGenerateCertificate(InputStream inStream)	Generates the X.509 certificate from the data in the stream.
Collection<? extends Certificate>	engineGenerateCertificates(InputStream inStream)	Generates the collection of the certificates on the base of provided via input stream encodings.
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 CertificateFactorySpi.engineGetCertPathEncodings().
CertPath	engineGenerateCertPath(List<? extends Certificate> certificates)	Generates a CertPath from the provided list of certificates.
CRL	engineGenerateCRL(InputStream inStream)	Generates and initializes a Certificate Revocation List (CRL) from the provided input stream.
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 Details

X509CertFactoryImpl

public X509CertFactoryImpl()

Default constructor. Creates the instance of Certificate Factory SPI ready for use.

Method Details

engineGenerateCertificate

public Certificate engineGenerateCertificate(InputStream inStream)
                                      throws CertificateException

Generates the X.509 certificate from the data in the stream. The data in the stream can be either in ASN.1 DER encoded X.509 certificate, or PEM (Base64 encoding bounded by "-----BEGIN CERTIFICATE-----" at the beginning and "-----END CERTIFICATE-----" at the end) representation of the former encoded form. Before the generation the encoded form is looked up in the cache. If the cache contains the certificate with requested encoded form it is returned from it, otherwise it is generated by ASN.1 decoder.

Specified by:

engineGenerateCertificate in class CertificateFactorySpi

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.

See Also:

method documentation for more info

engineGenerateCertificates

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

Generates the collection of the certificates on the base of provided via input stream encodings.

Specified by:

engineGenerateCertificates in class CertificateFactorySpi

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.

See Also:

method documentation for more info

engineGenerateCRL

public CRL engineGenerateCRL(InputStream inStream)
                      throws CRLException

Description copied from class: CertificateFactorySpi

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

Specified by:

engineGenerateCRL in class CertificateFactorySpi

Parameters:

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

Returns:

an CRL instance.

Throws:

CRLException - if parsing problems are detected.

See Also:

method documentation for more info

engineGenerateCRLs

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

Description copied from class: CertificateFactorySpi

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

Specified by:

engineGenerateCRLs in class CertificateFactorySpi

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.

See Also:

method documentation for more info

engineGenerateCertPath

public CertPath engineGenerateCertPath(InputStream inStream)
                                throws CertificateException

Description copied from class: CertificateFactorySpi

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

Overrides:

engineGenerateCertPath in class CertificateFactorySpi

Parameters:

inStream - an input stream with encoded data.

Returns:

a CertPath initialized from the provided data.

Throws:

CertificateException - if parsing problems are detected.

See Also:

method documentation for more info

engineGenerateCertPath

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

Description copied from class: CertificateFactorySpi

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

Overrides:

engineGenerateCertPath in class CertificateFactorySpi

Throws:

CertificateException - if parsing problems are detected.

See Also:

method documentation for more info

engineGenerateCertPath

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

Description copied from class: CertificateFactorySpi

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

Overrides:

engineGenerateCertPath in class CertificateFactorySpi

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.

See Also:

method documentation for more info

engineGetCertPathEncodings

public Iterator<String> engineGetCertPathEncodings()

Description copied from class: CertificateFactorySpi

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

Overrides:

engineGetCertPathEncodings in class CertificateFactorySpi

Returns:

an iterator over supported CertPath encodings (as Strings).

See Also:

method documentation for more info