com.prosysopc.ua.stack.transport.security

Class Cert

java.lang.Object

com.prosysopc.ua.stack.transport.security.Cert

public class Cert
extends Object

Cert is a X509 certificate that contains a public key. The instance is valid and encodedable. Wrapper to Certificate. Subclasses of Cert can potentially represent a certificate chain, however, it should be noted that in this case the majority of the methods of this class still only affect the 'leaf certificate', such as saving and loading, unless explicitly mentioned to support chains.

To Create a new certificate See CertificateUtils

Field Summary

Fields

Modifier and Type	Field and Description
X509Certificate	certificate
byte[]	encodedCertificate
byte[]	encodedCertificateThumbprint

Constructor Summary

Constructors

Constructor and Description
Cert(byte[] data) Create Certificate from encoded data, if the data contains more than one certificate, only the first one is read.
Cert(X509Certificate certificate) Create Certificate from a X509Certificate certificate.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object obj)
static Cert	fromEncoded(byte[] encodedCertChain) Create Cert from encoded data.
static Cert	fromx509Certificates(X509Certificate... certChain) Create Cert from given one ore more X509Certificate certificates.
X509Certificate	getCertificate() Getter for the field certificate.
byte[]	getEncoded() getEncoded.
byte[]	getEncodedChain() If a certificate chain is represented by this object, returns encoded chain with the leaf certificate appearing first and then each chain element towards root direction.
byte[]	getEncodedThumbprint() getEncodedThumbprint.
int	getKeySize() getKeySize.
int	hashCode()
static Cert	load(File file) Load X.509 Certificate from a file
static Cert	load(URL url) Load X.509 Certificate from an url
void	save(File file) save.
void	saveToPem(File file) saveToPem.
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

certificate

public final X509Certificate certificate

encodedCertificate

public final byte[] encodedCertificate

encodedCertificateThumbprint

public final byte[] encodedCertificateThumbprint

Constructor Detail

Cert

public Cert(byte[] data)
     throws ServiceResultException

Create Certificate from encoded data, if the data contains more than one certificate, only the first one is read.

Parameters:

data - encoded Certificate

Throws:

ServiceResultException - if any.

Cert

public Cert(X509Certificate certificate)
     throws CertificateEncodingException

Create Certificate from a X509Certificate certificate.

Parameters:

certificate - a X509Certificate certificate

Throws:

CertificateEncodingException - if any.

Method Detail

fromEncoded

public static Cert fromEncoded(byte[] encodedCertChain)
                        throws ServiceResultException

Create Cert from encoded data. If the data contains more than one certificate, the 'leaf certificate' shall be the first entry and is used to represent Cert. The rest of the data is not validated, but will be returned by getEncodedChain(). Throws ServiceResultException if data is not valid.

Throws:

ServiceResultException

fromx509Certificates

public static Cert fromx509Certificates(X509Certificate... certChain)
                                 throws ServiceResultException

Create Cert from given one ore more X509Certificate certificates. If given more than one certificate, the 'leaf certificate' shall be the first entry and is used to represent Cert. All given certificates are used to represent getEncodedChain(). Throws ServiceResultException if data is not valid.

Throws:

ServiceResultException

load

public static Cert load(File file)
                 throws IOException,
                        CertificateException

Load X.509 Certificate from a file

Parameters:

file - a File object.

Returns:

Certificate

Throws:

IOException - if any.

CertificateException - In case the certificate is not valid

load

public static Cert load(URL url)
                 throws IOException,
                        CertificateException

Load X.509 Certificate from an url

Parameters:

url - a URL object.

Returns:

Certificate

Throws:

IOException - if any.

CertificateException - In case the certificate is not valid

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

getCertificate

public X509Certificate getCertificate()

Getter for the field certificate.

Returns:

a X509Certificate object.

getEncoded

public byte[] getEncoded()

getEncoded.

Returns:

an array of byte.

getEncodedChain

public byte[] getEncodedChain()

If a certificate chain is represented by this object, returns encoded chain with the leaf certificate appearing first and then each chain element towards root direction. Note that the chain can be incomplete. The implementation of Cert returns just the same as getEncoded(), but a subclass can override this method to return a chain.

getEncodedThumbprint

public byte[] getEncodedThumbprint()

getEncodedThumbprint.

Returns:

an array of byte.

getKeySize

public int getKeySize()

getKeySize.

Returns:

a int.

hashCode

public int hashCode()

Overrides:

hashCode in class Object

save

public void save(File file)
          throws IOException

save.

Parameters:

file - a File object.

Throws:

IOException - if any.

saveToPem

public void saveToPem(File file)
               throws IOException

saveToPem.

Parameters:

file - a File object.

Throws:

IOException - if any.

toString

public String toString()

Overrides:

toString in class Object