com.ausregistry.jtoolkit2.session

Class TLSContext

java.lang.Object

com.ausregistry.jtoolkit2.session.TLSContext

public class TLSContext
extends java.lang.Object

This defines the operations or actions for establishing a TLS Version 1 based context.

Uses the maintenance, debug, support and user level loggers.

Constructor Summary

Constructors

Constructor and Description
TLSContext(java.lang.String truststore, java.lang.String trustpass) Instantiates a new TLS context.
TLSContext(java.lang.String keystore, java.lang.String keypass, java.lang.String truststore, java.lang.String trustpass, java.lang.String type, java.lang.String algorithm, java.lang.String protocol) Instantiates a new TLS context.

Method Summary

Modifier and Type	Method and Description
javax.net.ssl.HttpsURLConnection	createHttpsUrlConnection(java.lang.String url, java.lang.Integer connectionTimeout) Creates a Https connection to the specified URL connection.
javax.net.ssl.SSLSocket	createSocket(java.lang.String host, int port, int soTimeout) Creates an SSL Socket to be used in a session.
java.lang.String	getCertificateCommonName()

Methods inherited from class java.lang.Object

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

Constructor Detail

TLSContext

public TLSContext(java.lang.String keystore,
                  java.lang.String keypass,
                  java.lang.String truststore,
                  java.lang.String trustpass,
                  java.lang.String type,
                  java.lang.String algorithm,
                  java.lang.String protocol)
           throws KeyStoreNotFoundException,
                  KeyStoreReadException,
                  java.security.KeyStoreException,
                  java.security.cert.CertificateException,
                  java.security.UnrecoverableKeyException,
                  java.security.NoSuchAlgorithmException,
                  java.security.KeyManagementException

Instantiates a new TLS context.

Parameters:

keystore - the filename of the key store to be used for the context

keypass - the password applied to the key store

truststore - the filename of the trust store that is to be used for the key store

trustpass - the password used in the trust store

type - the key store type

algorithm - the algorithm

Throws:

KeyStoreNotFoundException - the key store not found exception

KeyStoreReadException - the key store read exception

java.security.KeyStoreException - the key store exception

java.security.cert.CertificateException - the certificate exception

java.security.UnrecoverableKeyException - the unrecoverable key exception

java.security.NoSuchAlgorithmException - the no such algorithm exception

java.security.KeyManagementException - the key management exception

TLSContext

public TLSContext(java.lang.String truststore,
                  java.lang.String trustpass)
           throws java.security.cert.CertificateException,
                  java.security.UnrecoverableKeyException,
                  java.security.NoSuchAlgorithmException,
                  java.security.KeyStoreException,
                  java.security.KeyManagementException,
                  KeyStoreReadException,
                  KeyStoreNotFoundException

Instantiates a new TLS context.

Parameters:

truststore - the filename of the trust store that is to be used for the key store

trustpass - the password used in the trust store

Throws:

KeyStoreNotFoundException - the key store not found exception

KeyStoreReadException - the key store read exception

java.security.KeyStoreException - the key store exception

java.security.cert.CertificateException - the certificate exception

java.security.UnrecoverableKeyException - the unrecoverable key exception

java.security.NoSuchAlgorithmException - the no such algorithm exception

java.security.KeyManagementException - the key management exception

Method Detail

getCertificateCommonName

public java.lang.String getCertificateCommonName()

createSocket

public javax.net.ssl.SSLSocket createSocket(java.lang.String host,
                                            int port,
                                            int soTimeout)
                                     throws java.io.IOException,
                                            javax.net.ssl.SSLHandshakeException

Creates an SSL Socket to be used in a session.

Parameters:

host - the host

port - the port

soTimeout - the socket timeout

Returns:

the SSL enabled socket

Throws:

java.io.IOException - Signals that an I/O exception has occurred.

javax.net.ssl.SSLHandshakeException - the SSL handshake exception

createHttpsUrlConnection

public javax.net.ssl.HttpsURLConnection createHttpsUrlConnection(java.lang.String url,
                                                                 java.lang.Integer connectionTimeout)
                                                          throws java.io.IOException

Creates a Https connection to the specified URL connection.

Parameters:

url - the URL to establish a HTTPS connection to

connectionTimeout - connection timeout value to be used in milliseconds

Returns:

HTTPS URL connection

Throws:

java.io.IOException - in case of a malformed URL or an IO exception occurring while trying to open a connection