org.openoces.ooapi.cert
Class OcesCertificateFactory

java.lang.Object
  org.openoces.ooapi.cert.OcesCertificateFactory

public class OcesCertificateFactory
extends java.lang.Object

This is a singleton class used to construct OCES certificates. Use this class to instantiate high-level { @link OcesCertificate ] objects from a raw X.509 OCES certificate.

Author:

Carsten Raskgaard

Field Summary

protected java.security.cert.CertificateFactory

cf the X.509 cerficate factory used to instantiate X.509 certificate objects

Method Summary

OcesCertificate	generate(java.lang.String pemEncodedCertificate) Constructs an OcesCertificate object from a raw PEM encoded X.509 OCES certificate.
OcesCertificate	generate(java.security.cert.X509Certificate certObj) Constructs an OcesCertificate object from X509Certificate object.
protected OcesCertificate	generateFromObject(java.security.cert.X509Certificate crt)
static OcesCertificateFactory	getInstance() Returns the singleton factory object

Methods inherited from class java.lang.Object

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

Field Detail

cf

protected java.security.cert.CertificateFactory cf

the X.509 cerficate factory used to instantiate X.509 certificate objects

Method Detail

getInstance

public static OcesCertificateFactory getInstance()

Returns the singleton factory object

Returns:

the singleton

generate

public OcesCertificate generate(java.lang.String pemEncodedCertificate)
                         throws InternalException,
                                NonOcesCertificateException,
                                SignatureVerificationException

Constructs an OcesCertificate object from a raw PEM encoded X.509 OCES certificate. The method will verify that the passed X.509 certificate has been signed by the OCES root certificate and throw an exception if this is not the case. No other processing of the certificate is being done. Before trusting the certificate, you should use the RevocationChecker class to verify the validity of the certificate.

Parameters:

pemEncodedCertificate - a PEM encoded X.509 certificate

Returns:

an object representing the specified certificate

Throws:

InternalException - if an internal error occurred. Please report this

NonOcesCertificateException - if the specified certificate is not recognized as an OCES certificate

SignatureVerificationException - if the key is incorrect

See Also:

OcesCertificate, RevocationChecker

generate

public OcesCertificate generate(java.security.cert.X509Certificate certObj)
                         throws InternalException,
                                NonOcesCertificateException,
                                SignatureVerificationException

Constructs an OcesCertificate object from X509Certificate object. The method will verify that the passed X.509 certificate has been signed by the OCES root certificate and throw an exception if this is not the case. No other processing of the certificate is being done. Before trusting the certificate, you should use the RevocationChecker class to verify the validity of the certificate.

Parameters:

certObj - a X.509 object

Returns:

an object representing the specified certificate

Throws:

InternalException - if an internal error occurred. Please report this

NonOcesCertificateException - if the specified certificate is not recognized as an OCES certificate

SignatureVerificationException - if the key is incorrect

See Also:

OcesCertificate, RevocationChecker

generateFromObject

protected OcesCertificate generateFromObject(java.security.cert.X509Certificate crt)
                                      throws InternalException,
                                             SignatureVerificationException,
                                             NonOcesCertificateException

Throws:

InternalException

SignatureVerificationException

NonOcesCertificateException