class Akenti::CertificateFactoryImpl

This abstract class provides applications with an interface for X509 certificate generation, encoding and decodingThe actual implemenation of this class is done by a provider class, for example OpenSSLCertificateFactoryImpl.

Inheritance:


Public Methods

[more]virtual ~CertificateFactoryImpl ()
Deletes this object
[more]virtual Certificate initCertificateFromFile (const string& type, const string& fileName) const
Returns the Certificate from a file containing a PEM encoded X509 certificate.
[more]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 X509 certificates.
[more]virtual Certificate initCertificate (const string& type, const string& encoding) const
Returns a Certificate class given an encoded string containing the certificate.
[more]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.
[more]virtual CertificateChain initCertificateChainFromFile (const string& type, const string& fname) const
Returns a CertificateChain from a file containing a PEM encoded certificate chain.
[more]virtual CertificateChain initCertificateChain (const string& type, const string& encoding) const
Returns a CertificateChain from a string containing a PEM encoded certificate chain.
[more]virtual string getCertificateEncoded (const string& type, const Certificate& certificate) const
Encodes the Certificate using the encoding type specified by type.
[more]virtual CertificateGenerator getCertificateGenerator (const string& type) const
Return an instance of CertificateGenerator using a type specified by type
[more]virtual CertificateRequest initCertificateRequest (const string& type, const string& encoding) const
Returns a CertificateRequest.
[more]virtual string getCertificateRequestEncoded (const string& type, const CertificateRequest& request) const
Encodes the CertificateRequst using the encoding type specified by type.
[more]virtual CertificateRequestGenerator getCertificateRequestGenerator (const string& type) const
Return an instance of CertificateRequestGenerator using a type specified by type
[more]virtual CertificateRevocationList initCRL (const string& crl, const string& type) const
Return an instance of CertificateRevocationList using the type specified.
[more]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 decodingThe 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.

ovirtual ~CertificateFactoryImpl()
Deletes this object

ovirtual Certificate initCertificateFromFile(const string& type, const string& fileName) const = 0
Returns the Certificate from a file containing a PEM encoded X509 certificate.

Parameters:
type - the encoding type of Certificate, e.g. "PEM"
fileName - name of file from which to initialize the Certificate
Returns:
collection of Certificates

ovirtual vector<Certificate> initCertificatesFromFile(const string& type, const string& fileName) const = 0
Returns a collection Certificates from a file containing a one or more PEM encoded X509 certificates.

Parameters:
type - the encoding type of Certificate, e.g. "PEM
fileName - name of file from which to initialize the Certificate
Returns:
Certificate

ovirtual Certificate initCertificate(const string& type, const string& encoding) const = 0
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
Parameters:
type - the Certificate's type of encoding
encoding - a string of bytes
Returns:
a Certificate
See Also:
CertificateFactory
CertificateFactoryImpl

ovirtual vector<Certificate> initCertificates(const string& type, const string& encoding) const = 0
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

ovirtual CertificateChain initCertificateChainFromFile(const string& type, const string& fname) const = 0
Returns a CertificateChain from a file containing a PEM encoded certificate chain.

Parameters:
type - the encoding type of Certificate, e.g. "PEM
fileName - name of file from which to initialize the Certificate chain
Returns:
CertificateChain

ovirtual CertificateChain initCertificateChain(const string& type, const string& encoding) const = 0
Returns a CertificateChain from a string containing a PEM encoded certificate chain.

Parameters:
type - the encoding type of Certificate, e.g. "PEM
encoding - a string of bytes
Returns:
CertificateChain

ovirtual string getCertificateEncoded(const string& type, const Certificate& certificate) const = 0
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
Parameters:
type - string specifies the encoding type to be used
certificate - Certificate to be encoded
Returns:
encoding a string of bytes
See Also:
Certificate
CertificateImpl

ovirtual CertificateGenerator getCertificateGenerator(const string& type) const = 0
Return an instance of CertificateGenerator using a type specified by type

Parameters:
type - string specifies the type to be used
See Also:
CertificateGenerator
CertificateGeneratorImpl

ovirtual CertificateRequest initCertificateRequest(const string& type, const string& encoding) const = 0
Returns a CertificateRequest. The type specifies the kind of CertificateRequest we are decoding.

Throws:
SecurityException if type is unsupported or if decoding fails
Parameters:
type - the CertificateRequest's type
encoding - a string of bytes representing a CertificateRequest.
Returns:
a CertificateRequest
See Also:
CertificateRequest
CertificateRequestImpl

ovirtual string getCertificateRequestEncoded(const string& type, const CertificateRequest& request) const = 0
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
Parameters:
type - string specifies the type to be used
request - CertificateRequest to be encoded
Returns:
encoding a string of bytes representating the certificateRequest that could be sent to a CA for signing.
See Also:
CertificateRequest
CertificateRequestImpl

ovirtual CertificateRequestGenerator getCertificateRequestGenerator(const string& type) const = 0
Return an instance of CertificateRequestGenerator using a type specified by type

Parameters:
type - string specifies the type to be used
See Also:
CertificateRequestGenerator
CertificateRequestGeneratorImpl

ovirtual CertificateRevocationList initCRL(const string& crl, const string& type) const = 0
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

ovirtual CertificateRevocationList initCRLFromFile(const string& crlfile, const string& type) const = 0
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 HTML hierarchy of classes or Java



This page was generated with the help of DOC++.