iaik.x509

Class CertificateFactory

java.lang.Object

java.security.cert.CertificateFactorySpi

iaik.x509.CertificateFactory

Direct Known Subclasses:

QualifiedCertificateFactory

public class CertificateFactory
extends java.security.cert.CertificateFactorySpi

This class implements a CertificateFactory for X.509.

Certificate Factories are used for reading encoded certificates and Certificate Recovation Lists (CRLs) from input streams.

For instantiating the IAIK certificate factory call the getInstance factory method of the java.security.cert.CertificateFactory engine class, thereby supplying the certificate type ("X.509") and the name of the IAIK provider:

 CertifiacteFactory certFactory =
                CertificateFactory.getInstance("X.509", "IAIK");
 

Subsequently use the generateCertificate, generateCertificates, generateCRL, or generateCRLs method for pasrsing a X.509 certificate, a collection of X.509 certificates, a X.509 CRL, or a collection of X.509 CRLs, respectively, e.g.:

 Collection c = certFactory.generateCertificates(is);
 

See Also:

X509Certificate, X509CRL

Constructor Summary

Constructors

Constructor and Description
CertificateFactory()

Method Summary

Modifier and Type	Method and Description
java.security.cert.Certificate	engineGenerateCertificate(java.io.InputStream is) Parses a X.509 certificate from the supplied input stream.
java.util.Collection	engineGenerateCertificates(java.io.InputStream is) Parses a collection of X.509 certificates from the supplied input stream.
java.security.cert.CertPath	engineGenerateCertPath(java.io.InputStream inStream) Generates a CertPath object and initializes it with the data read from the InputStream inStream.
java.security.cert.CertPath	engineGenerateCertPath(java.io.InputStream inStream, java.lang.String encoding) Generates a CertPath object and initializes it with the data read from the InputStream inStream.
java.security.cert.CertPath	engineGenerateCertPath(java.util.List<? extends java.security.cert.Certificate> certificates) Generates a CertPath object and initializes it with a List of Certificates.
java.security.cert.CRL	engineGenerateCRL(java.io.InputStream is) Parses a X.509 CRL from the supplied input stream.
java.util.Collection	engineGenerateCRLs(java.io.InputStream is) Parses a collection of X.509 CRLs from the supplied input stream.
java.util.Iterator<java.lang.String>	engineGetCertPathEncodings() Returns an iteration of the CertPath encodings supported by this certificate factory, with the default encoding first.

Methods inherited from class java.lang.Object

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

Constructor Detail

CertificateFactory

public CertificateFactory()

Method Detail

engineGenerateCertificate

public java.security.cert.Certificate engineGenerateCertificate(java.io.InputStream is)
                                                         throws java.security.cert.CertificateException

Parses a X.509 certificate from the supplied input stream.

Specified by:

engineGenerateCertificate in class java.security.cert.CertificateFactorySpi

Parameters:

is - the input stream supplying the encoded certificate

Returns:

the X509Certificate parsed from the stream

Throws:

java.security.cert.CertificateException - if an decoding/parsing error occurs

engineGenerateCertificates

public java.util.Collection engineGenerateCertificates(java.io.InputStream is)
                                                throws java.security.cert.CertificateException

Parses a collection of X.509 certificates from the supplied input stream. The collection may be supplied in one of the following formats (encoding = DER):

1. PKCS7CertList
2. Chain of DER encoded X.509 certificates
3. NetscapeCertList

This method requires that classes from the iaik.pkcs.pkcs7 package and com.entrust.toolkit.exceptions package be on the class path.

Specified by:

engineGenerateCertificates in class java.security.cert.CertificateFactorySpi

Parameters:

is - the input stream supplying the encoded certificates

Returns:

the collection of X509Certificates parsed from the stream

Throws:

java.security.cert.CertificateException - if an decoding/parsing error occurs

engineGenerateCRL

public java.security.cert.CRL engineGenerateCRL(java.io.InputStream is)
                                         throws java.security.cert.CRLException

Parses a X.509 CRL from the supplied input stream.

Specified by:

engineGenerateCRL in class java.security.cert.CertificateFactorySpi

Parameters:

is - the input stream supplying the encoded CRL

Returns:

the X509CRL parsed from the stream

Throws:

java.security.cert.CRLException - if an decoding/parsing error occurs

engineGenerateCRLs

public java.util.Collection engineGenerateCRLs(java.io.InputStream is)
                                        throws java.security.cert.CRLException

Parses a collection of X.509 CRLs from the supplied input stream. The collection may be supplied in one of the following formats (encoding = DER):

1. PKCS7CRLList
2. Chain of DER encoded X.509 CRLs

This method requires that classes from the iaik.pkcs.pkcs7 package and com.entrust.toolkit.exceptions package be on the class path.

Specified by:

engineGenerateCRLs in class java.security.cert.CertificateFactorySpi

Parameters:

is - the input stream supplying the encoded CRLs

Returns:

the collection of X509CRLs parsed from the stream

Throws:

java.security.cert.CRLException - if an decoding/parsing error occurs

engineGenerateCertPath

public java.security.cert.CertPath engineGenerateCertPath(java.io.InputStream inStream)
                                                   throws java.security.cert.CertificateException

Generates a CertPath object and initializes it with the data read from the InputStream inStream. The data is assumed to be in the default encoding.

IMPORTANT:This API is not supported by this CertificateFactory implementation; it always throws a UnsupportedOperationException.

Overrides:

engineGenerateCertPath in class java.security.cert.CertificateFactorySpi

Parameters:

inStream - an InputStream containing the data

Returns:

a CertPath initialized with the data from the InputStream

Throws:

java.security.cert.CertificateException - if an exception occurs while decoding

java.lang.UnsupportedOperationException - always thrown

Since:

7.2 SP2

engineGenerateCertPath

public java.security.cert.CertPath engineGenerateCertPath(java.io.InputStream inStream,
                                                          java.lang.String encoding)
                                                   throws java.security.cert.CertificateException

Generates a CertPath object and initializes it with the data read from the InputStream inStream. The data is assumed to be in the specified encoding.

IMPORTANT:This API is not supported by this CertificateFactory implementation; it always throws a UnsupportedOperationException.

Overrides:

engineGenerateCertPath in class java.security.cert.CertificateFactorySpi

Parameters:

inStream - an InputStream containing the data

encoding - the encoding used for the data

Returns:

a CertPath initialized with the data from the InputStream

Throws:

java.security.cert.CertificateException - if an exception occurs while decoding or the encoding requested is not supported

java.lang.UnsupportedOperationException - always thrown

Since:

7.2 SP2

engineGenerateCertPath

public java.security.cert.CertPath engineGenerateCertPath(java.util.List<? extends java.security.cert.Certificate> certificates)
                                                   throws java.security.cert.CertificateException

Generates a CertPath object and initializes it with a List of Certificates.

The certificates supplied must be of a type supported by the CertificateFactory. They will be copied out of the supplied List object.

IMPORTANT:This API is not supported by this CertificateFactory implementation; it always throws a UnsupportedOperationException.

Overrides:

engineGenerateCertPath in class java.security.cert.CertificateFactorySpi

Parameters:

certificates - a List of Certificates

Returns:

a CertPath initialized with the supplied list of certificates

Throws:

java.security.cert.CertificateException - if an exception occurs

java.lang.UnsupportedOperationException - always thrown

Since:

7.2 SP2

engineGetCertPathEncodings

public java.util.Iterator<java.lang.String> engineGetCertPathEncodings()

Returns an iteration of the CertPath encodings supported by this certificate factory, with the default encoding first. See Appendix A in the Java Certification Path API Programmer's Guide for information about standard encoding names.

Attempts to modify the returned Iterator via its remove method result in an UnsupportedOperationException.

IMPORTANT:This API is not supported by this CertificateFactory implementation; it always throws a UnsupportedOperationException.

Overrides:

engineGetCertPathEncodings in class java.security.cert.CertificateFactorySpi

Returns:

an Iterator over the names of the supported CertPath encodings (as Strings)

Throws:

java.lang.UnsupportedOperationException - always thrown

Since:

7.2 SP2