class CertificateFactoryImpl

This abstract class provides applications with an interface for X509 certificate generation, encoding and decoding

Inheritance:


Public Methods

virtual ~CertificateFactoryImpl ()
Deletes this object
virtual Certificate initCertificateFromFile (const string& type, const string& fileName) const
Returns the Certificate from a file containing a PEM encoded X
virtual vector <Certificate> initCertificatesFromFile (const string& type, const string& fileName) const
Returns a collection Certificates from a file containing a one or more PEM encoded X
virtual Certificate initCertificate (const string& type, const string& encoding) const
Returns a Certificate class given an encoded string containing the certificate
virtual vector <Certificate> initCertificates (const string& type, const string& encoding) const
Returns collection of Certificates from a a string containing one or more PEM encoded certificates
virtual CertificateChain initCertificateChainFromFile (const string& type, const string& fname) const
Returns a CertificateChain from a file containing a PEM encoded certificate chain
virtual CertificateChain initCertificateChain (const string& type, const string& encoding) const
Returns a CertificateChain from a string containing a PEM encoded certificate chain
virtual string getCertificateEncoded (const string& type, const Certificate& certificate) const
Encodes the Certificate using the encoding type specified by type
virtual CertificateGenerator getCertificateGenerator (const string& type) const
Return an instance of CertificateGenerator using a type specified by type
virtual CertificateRequest initCertificateRequest (const string& type, const string& encoding) const
Returns a CertificateRequest
virtual string getCertificateRequestEncoded (const string& type, const CertificateRequest& request) const
Encodes the CertificateRequst using the encoding type specified by type
virtual CertificateRequestGenerator getCertificateRequestGenerator (const string& type) const
Return an instance of CertificateRequestGenerator using a type specified by type
virtual CertificateRevocationList initCRL (const string& crl, const string& type) const
Return an instance of CertificateRevocationList using the type specified
virtual CertificateRevocationList initCRLFromFile (const string& crlfile, const string& type) const
Return an instance of CertificateRevocationList from the given filename and the encoding type

Documentation

This abstract class provides applications with an interface for X509 certificate generation, encoding and decoding.The actual implemenation of this class is done by a provider class, for example OpenSSLCertificateFactoryImpl. Akenti certificates are handled by the AkentiCertificateFactory class, rather than this class. Typically, an instance of this class is instantiated and wrapped in a CertificateFactory object which is merely a reference-count pointer. Applications should never have to instantiate a subclass of this class. Instead, the CertificateFactory#getCertificateFactory() should be used.
virtual ~CertificateFactoryImpl()
Deletes this object

virtual Certificate initCertificateFromFile(const string& type, const string& fileName) const
Returns the Certificate from a file containing a PEM encoded X.509 certificate.
Returns:
collection of Certificates
Parameters:
type - the encoding type of Certificate, e.g. "PEM"
fileName - name of file from which to initialize the Certificate

virtual vector <Certificate> initCertificatesFromFile(const string& type, const string& fileName) const
Returns a collection Certificates from a file containing a one or more PEM encoded X.509 certificates.
Returns:
Certificate
Parameters:
type - the encoding type of Certificate, e.g. "PEM
fileName - name of file from which to initialize the Certificate

virtual Certificate initCertificate(const string& type, const string& encoding) const
Returns a Certificate class given an encoded string containing the certificate. The type specifies the way the Certificate string is encoded, e.g. PEM, DER
Throws:
SecurityException if either type is unsupported or if decoding fails
Returns:
a Certificate
Parameters:
type - the Certificate's type of encoding
encoding - a string of bytes
See Also:
CertificateFactory
CertificateFactoryImpl

virtual vector <Certificate> initCertificates(const string& type, const string& encoding) const
Returns collection of Certificates from a a string containing one or more PEM encoded certificates.
Throws:
Error if out of memory
SecurityException if type is unsupported
Parameters:
type - string specifies the encoding type. Only PEM is currently supported
encoding - a string of bytes
See Also:
Error
SecurityException

virtual CertificateChain initCertificateChainFromFile(const string& type, const string& fname) const
Returns a CertificateChain from a file containing a PEM encoded certificate chain.
Returns:
CertificateChain
Parameters:
type - the encoding type of Certificate, e.g. "PEM
fileName - name of file from which to initialize the Certificate chain

virtual CertificateChain initCertificateChain(const string& type, const string& encoding) const
Returns a CertificateChain from a string containing a PEM encoded certificate chain.
Returns:
CertificateChain
Parameters:
type - the encoding type of Certificate, e.g. "PEM
encoding - a string of bytes

virtual string getCertificateEncoded(const string& type, const Certificate& certificate) const
Encodes the Certificate using the encoding type specified by type.
Throws:
Error if certificate is unitialized or unrecognized
SecurityException if type is unsupported or if the encoding fails
Returns:
encoding a string of bytes
Parameters:
type - string specifies the encoding type to be used
certificate - Certificate to be encoded
See Also:
Certificate
CertificateImpl

virtual CertificateGenerator getCertificateGenerator(const string& type) const
Return an instance of CertificateGenerator using a type specified by type
Parameters:
type - string specifies the type to be used
See Also:
CertificateGenerator
CertificateGeneratorImpl

virtual CertificateRequest initCertificateRequest(const string& type, const string& encoding) const
Returns a CertificateRequest. The type specifies the kind of CertificateRequest we are decoding.
Throws:
SecurityException if type is unsupported or if decoding fails
Returns:
a CertificateRequest
Parameters:
type - the CertificateRequest's type
encoding - a string of bytes representing a CertificateRequest.
See Also:
CertificateRequest
CertificateRequestImpl

virtual string getCertificateRequestEncoded(const string& type, const CertificateRequest& request) const
Encodes the CertificateRequst using the encoding type specified by type.
Throws:
Error if request is unitialized or unrecognized
SecurityException if type is unsupported or if the encoding fails
Returns:
encoding a string of bytes representating the certificateRequest that could be sent to a CA for signing.
Parameters:
type - string specifies the type to be used
request - CertificateRequest to be encoded
See Also:
CertificateRequest
CertificateRequestImpl

virtual CertificateRequestGenerator getCertificateRequestGenerator(const string& type) const
Return an instance of CertificateRequestGenerator using a type specified by type
Parameters:
type - string specifies the type to be used
See Also:
CertificateRequestGenerator
CertificateRequestGeneratorImpl

virtual CertificateRevocationList initCRL(const string& crl, const string& type) const
Return an instance of CertificateRevocationList using the type specified.
Parameters:
crl - string that refers to the crl encoding
type - string that refers to the type of crl encoding
See Also:
CertificateRevocationList

virtual CertificateRevocationList initCRLFromFile(const string& crlfile, const string& type) const
Return an instance of CertificateRevocationList from the given filename and the encoding type
Parameters:
crlfile - string that refers to the crl filename
type - string that refers to the type of crl encoding
See Also:
CertificateRevocationList


Direct child classes:
OpenSSLCertificateFactoryImpl
Author:
Srilekha Mudumbai Abdelilah Essiari
Version:
1.1 00/05/01
See Also:
CertificateFactory
Provider
ProviderImpl
Certificate
CertificateGenerator
CertificateRequestGenerator
CertificateRequest

alphabetic index hierarchy of classes


this page has been generated automatically by doc++

(c)opyright by Malte Zöckler, Roland Wunderling
contact: doc++@zib.de