ej.net.dtls.test.util

Class DTLSContextBuilder

java.lang.Object

ej.net.dtls.test.util.DTLSContextBuilder

public class DTLSContextBuilder
extends Object

Helps to create an DTLS context.

Constructor Summary

Constructors

Constructor and Description
DTLSContextBuilder() Creates an DTLS context builder with default protocol TLS 1.2.
DTLSContextBuilder(String protocol) Creates an DTLS context builder.

Method Summary

Modifier and Type	Method and Description
void	addClientKey(byte[] privateKey, InputStream certificate) Adds the given client key and the associated self-signed certificate.
void	addClientKey(byte[] privateKey, InputStream certificate, InputStream... certificationChain) Adds the given client key and the associated certificate and certification chain to the key store.
void	addClientKey(InputStream privateKey, InputStream certificate) Adds the given client key and the associated self-signed certificate.
void	addClientKey(InputStream privateKey, InputStream certificate, InputStream... certificationChain) Adds the given client key and the associated certificate and certification chain to the key store.
void	addClientKey(String privateKeyPath, String certificatePath, String... certificationChainPaths) Adds the given client key and the associated certificate and certification chain to the key store.
void	addServerCertificate(InputStream certificate) Adds the given server certificate to the trust store.
void	addServerCertificate(String certificatePath) Adds the given server certificate to the trust store.
void	addServerCertificates(String[] trustedCertificates)
DTLSContext	build(String keyStorePassword) Creates an DTLS context using the populated trust store and an the populated key store, using the given key store password.

Methods inherited from class java.lang.Object

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

Constructor Detail

DTLSContextBuilder

public DTLSContextBuilder()
                   throws GeneralSecurityException

Creates an DTLS context builder with default protocol TLS 1.2.

Throws:

GeneralSecurityException - if an exception occurs while initializing the trust store or the key store.

DTLSContextBuilder

public DTLSContextBuilder(String protocol)
                   throws GeneralSecurityException

Creates an DTLS context builder.

Parameters:

protocol - DTLS protocol to use.

password - keystore password.

Throws:

GeneralSecurityException - if an exception occurs while initializing the trust store or the key store.

Method Detail

addClientKey

public void addClientKey(byte[] privateKey,
                         InputStream certificate)
                  throws GeneralSecurityException

Adds the given client key and the associated self-signed certificate.

Parameters:

privateKey - the private key to add.

certificate - the associated certificate.

Throws:

GeneralSecurityException - if the certificates could not be loaded or the private key could not be added.

addClientKey

public void addClientKey(byte[] privateKey,
                         InputStream certificate,
                         InputStream... certificationChain)
                  throws GeneralSecurityException

Adds the given client key and the associated certificate and certification chain to the key store.

Parameters:

privateKey - the private key to add.

certificate - the associated certificate.

certificationChain - the certification chain, ordered, the root certificate at the end.

Throws:

GeneralSecurityException - if the certificates could not be loaded or the private key could not be added.

addClientKey

public void addClientKey(InputStream privateKey,
                         InputStream certificate)
                  throws IOException,
                         GeneralSecurityException

Adds the given client key and the associated self-signed certificate.

Parameters:

privateKey - the private key to add.

certificate - the associated certificate.

Throws:

GeneralSecurityException - if the certificate could not be loaded or the private key could not be added.

IOException - if the given privateKey could not be read.

addClientKey

public void addClientKey(InputStream privateKey,
                         InputStream certificate,
                         InputStream... certificationChain)
                  throws IOException,
                         GeneralSecurityException

Adds the given client key and the associated certificate and certification chain to the key store.

Parameters:

privateKey - the private key to add.

certificate - the associated certificate.

certificationChain - the certification chain, ordered, the root certificate at the end.

Throws:

GeneralSecurityException - if the certificate could not be loaded or the private key could not be added.

IOException - if the given privateKey could not be read.

addClientKey

public void addClientKey(String privateKeyPath,
                         String certificatePath,
                         String... certificationChainPaths)
                  throws IOException,
                         GeneralSecurityException

Adds the given client key and the associated certificate and certification chain to the key store. Tries to find the resource in the application's classpath (using Class.getResourceAsStream(String)).

Parameters:

privateKeyPath - the path to the private key to add.

certificatePath - the path to the associated certificate.

certificationChainPaths - the paths to the certification chain, ordered, the root certificate at the end.

Throws:

GeneralSecurityException - if the certificate could not be loaded or the private key could not be added.

IOException - if the given privateKey could not be read.

addServerCertificate

public void addServerCertificate(InputStream certificate)
                          throws GeneralSecurityException

Adds the given server certificate to the trust store.

Parameters:

certificate - the certificate to add.

Throws:

GeneralSecurityException - if the certificate could not be loaded or added.

addServerCertificate

public void addServerCertificate(String certificatePath)
                          throws GeneralSecurityException,
                                 IOException

Adds the given server certificate to the trust store. Tries to find the resource in the application's classpath (using Class.getResourceAsStream(String)).

Parameters:

certificatePath - the path to the certificate to add.

Throws:

GeneralSecurityException - if the certificate could not be loaded or added.

IOException

addServerCertificates

public void addServerCertificates(String[] trustedCertificates)
                           throws GeneralSecurityException,
                                  IOException

Parameters:

trustedCertificates -

Throws:

IOException

GeneralSecurityException

build

public DTLSContext build(String keyStorePassword)
                  throws GeneralSecurityException

Creates an DTLS context using the populated trust store and an the populated key store, using the given key store password.

Parameters:

keyStorePassword - the password of the key store.

Returns:

the created DTLS context.

Throws:

GeneralSecurityException - if an exception occurred while creating the DTLS context.