com.tencent.kona.sun.security.provider

Class X509Factory

java.lang.Object

java.security.cert.CertificateFactorySpi

com.tencent.kona.sun.security.provider.X509Factory

public class X509Factory
extends java.security.cert.CertificateFactorySpi

This class defines a certificate factory for X.509 v3 certificates & certification paths, and X.509 v2 certificate revocation lists (CRLs).

See Also:

CertificateFactorySpi, Certificate, CertPath, CRL, X509Certificate, X509CRL, X509CertImpl, X509CRLImpl

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	BEGIN_CERT
static java.lang.String	END_CERT

Constructor Summary

Constructors

Constructor and Description
X509Factory()

Method Summary

Modifier and Type	Method and Description
static X509CertImpl	cachedGetX509Cert(byte[] encoding)
java.security.cert.Certificate	engineGenerateCertificate(java.io.InputStream is) Generates an X.509 certificate object and initializes it with the data read from the input stream is.
java.util.Collection<? extends java.security.cert.Certificate>	engineGenerateCertificates(java.io.InputStream is) Returns a (possibly empty) collection view of X.509 certificates read from the given input stream is.
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) Generates an X.509 certificate revocation list (CRL) object and initializes it with the data read from the given input stream is.
java.util.Collection<? extends java.security.cert.CRL>	engineGenerateCRLs(java.io.InputStream is) Returns a (possibly empty) collection view of X.509 CRLs read from the given input stream is.
java.util.Iterator<java.lang.String>	engineGetCertPathEncodings() Returns an iteration of the CertPath encodings supported by this certificate factory, with the default encoding first.
static X509CertImpl	intern(java.security.cert.X509Certificate c) Return an interned X509CertImpl for the given certificate.
static X509CRLImpl	intern(java.security.cert.X509CRL c) Return an interned X509CRLImpl for the given certificate.

Methods inherited from class java.lang.Object

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

Field Detail

BEGIN_CERT

public static final java.lang.String BEGIN_CERT

See Also:

Constant Field Values

END_CERT

public static final java.lang.String END_CERT

See Also:

Constant Field Values

Constructor Detail

X509Factory

public X509Factory()

Method Detail

engineGenerateCertificate

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

Generates an X.509 certificate object and initializes it with the data read from the input stream is.

Specified by:

engineGenerateCertificate in class java.security.cert.CertificateFactorySpi

Parameters:

is - an input stream with the certificate data.

Returns:

an X.509 certificate object initialized with the data from the input stream.

Throws:

java.security.cert.CertificateException - on parsing errors.

cachedGetX509Cert

public static X509CertImpl cachedGetX509Cert(byte[] encoding)
                                      throws java.security.cert.CertificateException

Throws:

java.security.cert.CertificateException

intern

public static X509CertImpl intern(java.security.cert.X509Certificate c)
                           throws java.security.cert.CertificateException

Return an interned X509CertImpl for the given certificate. If the given X509Certificate or X509CertImpl is already present in the cert cache, the cached object is returned. Otherwise, if it is a X509Certificate, it is first converted to a X509CertImpl. Then the X509CertImpl is added to the cache and returned. Note that all certificates created via generateCertificate(InputStream) are already interned and this method does not need to be called. It is useful for certificates that cannot be created via generateCertificate() and for converting other X509Certificate implementations to an X509CertImpl.

Parameters:

c - The source X509Certificate

Returns:

An X509CertImpl object that is either a cached certificate or a newly built X509CertImpl from the provided X509Certificate

Throws:

java.security.cert.CertificateException - if failures occur while obtaining the DER encoding for certificate data.

intern

public static X509CRLImpl intern(java.security.cert.X509CRL c)
                          throws java.security.cert.CRLException

Return an interned X509CRLImpl for the given certificate. For more information, see intern(X509Certificate).

Parameters:

c - The source X509CRL

Returns:

An X509CRLImpl object that is either a cached CRL or a newly built X509CRLImpl from the provided X509CRL

Throws:

java.security.cert.CRLException - if failures occur while obtaining the DER encoding for CRL data.

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.

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

Since:

1.4

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.

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

Since:

1.4

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.

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

Since:

1.4

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.

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

Overrides:

engineGetCertPathEncodings in class java.security.cert.CertificateFactorySpi

Returns:

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

Since:

1.4

engineGenerateCertificates

public java.util.Collection<? extends java.security.cert.Certificate> engineGenerateCertificates(java.io.InputStream is)
                                                                                          throws java.security.cert.CertificateException

Returns a (possibly empty) collection view of X.509 certificates read from the given input stream is.

Specified by:

engineGenerateCertificates in class java.security.cert.CertificateFactorySpi

Parameters:

is - the input stream with the certificates.

Returns:

a (possibly empty) collection view of X.509 certificate objects initialized with the data from the input stream.

Throws:

java.security.cert.CertificateException - on parsing errors.

engineGenerateCRL

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

Generates an X.509 certificate revocation list (CRL) object and initializes it with the data read from the given input stream is.

Specified by:

engineGenerateCRL in class java.security.cert.CertificateFactorySpi

Parameters:

is - an input stream with the CRL data.

Returns:

an X.509 CRL object initialized with the data from the input stream.

Throws:

java.security.cert.CRLException - on parsing errors.

engineGenerateCRLs

public java.util.Collection<? extends java.security.cert.CRL> engineGenerateCRLs(java.io.InputStream is)
                                                                          throws java.security.cert.CRLException

Returns a (possibly empty) collection view of X.509 CRLs read from the given input stream is.

Specified by:

engineGenerateCRLs in class java.security.cert.CertificateFactorySpi

Parameters:

is - the input stream with the CRLs.

Returns:

a (possibly empty) collection view of X.509 CRL objects initialized with the data from the input stream.

Throws:

java.security.cert.CRLException - on parsing errors.