gnu.java.security.provider

Class X509CertificateFactory


public class X509CertificateFactory
extends CertificateFactorySpi

Field Summary

static String
BEGIN_CERTIFICATE
static String
BEGIN_X509_CRL
static String
END_CERTIFICATE
static String
END_X509_CRL

Constructor Summary

X509CertificateFactory()
Constructs a new CertificateFactorySpi

Method Summary

CRL
engineGenerateCRL(InputStream inStream)
Generates a CRL based on the encoded data read from the InputStream.
Collection
engineGenerateCRLs(InputStream inStream)
Generates CRLs based on the encoded data read from the InputStream.
CertPath
engineGenerateCertPath(InputStream in)
Generate a CertPath and initialize it with data parsed from the input stream.
CertPath
engineGenerateCertPath(InputStream in, String encoding)
Generate a CertPath and initialize it with data parsed from the input stream, using the specified encoding.
CertPath
engineGenerateCertPath(List certs)
Generate a CertPath and initialize it with the certificates in the List argument.
Certificate
engineGenerateCertificate(InputStream inStream)
Generates a Certificate based on the encoded data read from the InputStream.
Collection
engineGenerateCertificates(InputStream inStream)
Returns a collection of certificates that were read from the input stream.
Iterator
engineGetCertPathEncodings()
Returns an Iterator of CertPath encodings supported by this factory, with the default encoding first.

Methods inherited from class java.security.cert.CertificateFactorySpi

engineGenerateCRL, engineGenerateCRLs, engineGenerateCertPath, engineGenerateCertPath, engineGenerateCertPath, engineGenerateCertificate, engineGenerateCertificates, engineGetCertPathEncodings

Methods inherited from class java.lang.Object

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

Field Details

BEGIN_CERTIFICATE

public static final String BEGIN_CERTIFICATE
Field Value:
"-----BEGIN CERTIFICATE-----"

BEGIN_X509_CRL

public static final String BEGIN_X509_CRL
Field Value:
"-----BEGIN X509 CRL-----"

END_CERTIFICATE

public static final String END_CERTIFICATE
Field Value:
"-----END CERTIFICATE-----"

END_X509_CRL

public static final String END_X509_CRL
Field Value:
"-----END X509 CRL-----"

Constructor Details

X509CertificateFactory

public X509CertificateFactory()
Constructs a new CertificateFactorySpi

Method Details

engineGenerateCRL

public CRL engineGenerateCRL(InputStream inStream)
            throws CRLException
Generates a CRL based on the encoded data read from the InputStream. The input stream must contain only one CRL. If there exists a specialized CRL class for the CRL format handled by the certificate factory then the return CRL should be a typecast of it. Ex: A X.509 CertificateFactory should return X509CRL.
Overrides:
engineGenerateCRL in interface CertificateFactorySpi
Parameters:
inStream - an input stream containing the CRL data
Returns:
a CRL initialized with InputStream data.
Throws:
CRLException - CRL parsing error

engineGenerateCRLs

public Collection engineGenerateCRLs(InputStream inStream)
            throws CRLException
Generates CRLs based on the encoded data read from the InputStream. For a X.509 certificate factory, the stream may contain a single DER encoded CRL or a PKCS#7 CRL set. This is a PKCS#7 SignedData object with the most significant field being crls. If no CRLs are present, then an empty collection is returned.
Overrides:
engineGenerateCRLs in interface CertificateFactorySpi
Parameters:
inStream - an input stream containing the CRLs
Returns:
a collection of CRLs initialized with the InputStream data.
Throws:
CRLException - CRL parsing error

engineGenerateCertPath

public CertPath engineGenerateCertPath(InputStream in)
            throws CertificateEncodingException
Generate a CertPath and initialize it with data parsed from the input stream. The default encoding of this factory is used.
Overrides:
engineGenerateCertPath in interface CertificateFactorySpi
Parameters:
Returns:
A CertPath initialized from the input stream data.

engineGenerateCertPath

public CertPath engineGenerateCertPath(InputStream in,
                                       String encoding)
            throws CertificateEncodingException
Generate a CertPath and initialize it with data parsed from the input stream, using the specified encoding.
Overrides:
engineGenerateCertPath in interface CertificateFactorySpi
Parameters:
encoding - The encoding of the InputStream data.
Returns:
A CertPath initialized from the input stream data.

engineGenerateCertPath

public CertPath engineGenerateCertPath(List certs)
Generate a CertPath and initialize it with the certificates in the List argument.
Overrides:
engineGenerateCertPath in interface CertificateFactorySpi
Parameters:
Returns:
A CertPath initialized from the certificates.

engineGenerateCertificate

public Certificate engineGenerateCertificate(InputStream inStream)
            throws CertificateException
Generates a Certificate based on the encoded data read from the InputStream. The input stream must contain only one certificate. If there exists a specialized certificate class for the certificate format handled by the certificate factory then the return Ceritificate should be a typecast of it. Ex: A X.509 CertificateFactory should return X509Certificate. For X.509 certificates, the certificate in inStream must be DER encoded and supplied in binary or printable (Base64) encoding. If the certificate is in Base64 encoding, it must be bounded by -----BEGIN CERTIFICATE-----, and -----END CERTIFICATE-----.
Overrides:
engineGenerateCertificate in interface CertificateFactorySpi
Parameters:
inStream - an input stream containing the certificate data
Returns:
a certificate initialized with InputStream data.
Throws:
CertificateException - Certificate parsing error

engineGenerateCertificates

public Collection engineGenerateCertificates(InputStream inStream)
            throws CertificateException
Returns a collection of certificates that were read from the input stream. It may be empty, have only one, or have multiple certificates. For a X.509 certificate factory, the stream may contain a single DER encoded certificate or a PKCS#7 certificate chain. This is a PKCS#7 SignedData object with the most significant field being certificates. If no CRLs are present, then an empty collection is returned.
Overrides:
engineGenerateCertificates in interface CertificateFactorySpi
Parameters:
inStream - an input stream containing the certificates
Returns:
a collection of certificates initialized with the InputStream data.
Throws:
CertificateException - Certificate parsing error

engineGetCertPathEncodings

public Iterator engineGetCertPathEncodings()
Returns an Iterator of CertPath encodings supported by this factory, with the default encoding first. The returned Iterator cannot be modified.
Overrides:
engineGetCertPathEncodings in interface CertificateFactorySpi
Returns:
The Iterator of supported encodings.

X509CertificateFactory.java -- generates X.509 certificates. Copyright (C) 2003 Free Software Foundation, Inc. This file is part of GNU Classpath. GNU Classpath is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version. GNU Classpath is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with GNU Classpath; see the file COPYING. If not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. Linking this library statically or dynamically with other modules is making a combined work based on this library. Thus, the terms and conditions of the GNU General Public License cover the whole combination. As a special exception, the copyright holders of this library give you permission to link this library with independent modules to produce an executable, regardless of the license terms of these independent modules, and to copy and distribute the resulting executable under terms of your choice, provided that you also meet, for each linked independent module, the terms and conditions of the license of that module. An independent module is a module which is not derived from or based on this library. If you modify this library, you may extend this exception to your version of the library, but you are not obligated to do so. If you do not wish to do so, delete this exception statement from your version.