Module zertjsse

Package com.ibm.zertjsse

Class ZERTDefaultSSLContextImpl

java.lang.Object

javax.net.ssl.SSLContextSpi

com.ibm.zertjsse.ZERTDefaultSSLContextImpl

public final class ZERTDefaultSSLContextImpl
extends SSLContextSpi

"Default" SSLContext as returned by SSLContext.getDefault(). It comes initialized with default KeyManagers and TrustManagers created using various system properties.

Field Summary

Fields

Modifier and Type	Field	Description
protected static final com.ibm.zertjsse.Debug	debug	Debug - Used innately to trace in each method of this class.

Constructor Summary

Constructors

Constructor	Description
ZERTDefaultSSLContextImpl()

Method Summary

Modifier and Type	Method	Description
protected SSLEngine	engineCreateSSLEngine()	Creates a new SSLEngine using this context.
protected SSLEngine	engineCreateSSLEngine(String host, int port)	Creates a SSLEngine using this context.
protected SSLSessionContext	engineGetClientSessionContext()	Returns a client SSLSessionContext object for this context.
protected SSLParameters	engineGetDefaultSSLParameters()	Returns a copy of the SSLParameters indicating the default settings for this SSL context.
protected SSLSessionContext	engineGetServerSessionContext()	Returns a server SSLSessionContext object for this context.
protected SSLServerSocketFactory	engineGetServerSocketFactory()	Returns a ServerSocketFactory object for this context.
protected SSLSocketFactory	engineGetSocketFactory()	Returns a SocketFactory object for this context.
protected SSLParameters	engineGetSupportedSSLParameters()	Returns a copy of the SSLParameters indicating the maximum supported settings for this SSL context.
protected void	engineInit(KeyManager[] km, TrustManager[] tm, SecureRandom sr)	Initializes this context.

Methods inherited from class java.lang.Object

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

Field Details

debug

protected static final com.ibm.zertjsse.Debug debug

Debug - Used innately to trace in each method of this class.

Constructor Details

ZERTDefaultSSLContextImpl

public ZERTDefaultSSLContextImpl()
                          throws NoSuchAlgorithmException,
NoSuchProviderException

Throws:

NoSuchAlgorithmException

NoSuchProviderException

Method Details

engineInit

protected void engineInit(KeyManager[] km,
 TrustManager[] tm,
 SecureRandom sr)
                   throws KeyManagementException

Initializes this context.

Specified by:

engineInit in class SSLContextSpi

Parameters:

KeyManager - [] km - the sources of authentication keys

TrustManager - [] tm - the sources of peer authentication trust decisions

SecureRandom - [] sr - the source of randomness

Throws:

KeyManagementException - if this operation fails

See Also:

• SSLContextSpi.engineInit(KeyManager[],TrustManager [], SecureRandom)

engineGetSocketFactory

protected SSLSocketFactory engineGetSocketFactory()
                                           throws IllegalStateException

Returns a SocketFactory object for this context.

Specified by:

engineGetSocketFactory in class SSLContextSpi

Returns:

the SocketFactory object

Throws:

IllegalStateException - if the SSLContextImpl requires initialization and the engineInit() has not been called

See Also:

• SSLContextSpi.engineGetSocketFactory()

engineGetServerSocketFactory

protected SSLServerSocketFactory engineGetServerSocketFactory()
                                                       throws IllegalStateException

Returns a ServerSocketFactory object for this context.

Specified by:

engineGetServerSocketFactory in class SSLContextSpi

Returns:

the ServerSocketFactory object

Throws:

IllegalStateException - if the SSLContextImpl requires initialization and the engineInit() has not been called

See Also:

• SSLContextSpi.engineGetSocketFactory()

engineCreateSSLEngine

protected SSLEngine engineCreateSSLEngine()
                                   throws IllegalStateException

Creates a new SSLEngine using this context. Applications using this factory method are providing no hints for an internal session reuse strategy. If hints are desired, engineCreateSSLEngine(String, int) should be used instead. Some cipher suites (such as Kerberos) require remote hostname information, in which case this factory method should not be used.

Specified by:

engineCreateSSLEngine in class SSLContextSpi

Returns:

the SSLEngine Object

Throws:

IllegalStateException - if the SSLContextImpl requires initialization and the engineInit() has not been called

Since:

1.5

See Also:

• SSLContextSpi.engineCreateSSLEngine()

engineCreateSSLEngine

protected SSLEngine engineCreateSSLEngine(String host,
 int port)
                                   throws IllegalStateException

Creates a SSLEngine using this context. Applications using this factory method are providing hints for an internal session reuse strategy. Some cipher suites (such as Kerberos) require remote hostname information, in which case peerHost needs to be specified.

Specified by:

engineCreateSSLEngine in class SSLContextSpi

Parameters:

host - the non-authoritative name of the host

port - the non-authoritative port

Returns:

the SSLEngine Object

Throws:

IllegalStateException - if the SSLContextImpl requires initialization and the engineInit() has not been called

See Also:

• SSLContextSpi.engineCreateSSLEngine(String host, int port)

engineGetServerSessionContext

protected SSLSessionContext engineGetServerSessionContext()

Returns a server SSLSessionContext object for this context.

Specified by:

engineGetServerSessionContext in class SSLContextSpi

Returns:

the SSLSessionContext object

See Also:

• SSLContextSpi.engineGetServerSessionContext()

engineGetClientSessionContext

protected SSLSessionContext engineGetClientSessionContext()

Returns a client SSLSessionContext object for this context.

Specified by:

engineGetClientSessionContext in class SSLContextSpi

Returns:

the SSLSessionContext object

See Also:

• SSLContextSpi.engineGetClientSessionContext()

engineGetDefaultSSLParameters

protected SSLParameters engineGetDefaultSSLParameters()
                                               throws UnsupportedOperationException

Returns a copy of the SSLParameters indicating the default settings for this SSL context. The parameters will always have the ciphersuite and protocols arrays set to non-null values. The default implementation obtains the parameters from an SSLSocket created by calling the SocketFactory.createSocket() method of this context's SocketFactory.

Overrides:

engineGetDefaultSSLParameters in class SSLContextSpi

Returns:

a copy of the SSLParameters object with the default settings

Throws:

UnsupportedOperationException - if the default SSL parameters could not be obtained.

Since:

1.6

See Also:

• SSLContextSpi.engineGetDefaultSSLParameters()

engineGetSupportedSSLParameters

protected SSLParameters engineGetSupportedSSLParameters()
                                                 throws UnsupportedOperationException

Returns a copy of the SSLParameters indicating the maximum supported settings for this SSL context. The parameters will always have the ciphersuite and protocols arrays set to non-null values. The default implementation obtains the parameters from an SSLSocket created by calling the SocketFactory.createSocket() method of this context's SocketFactory.

Overrides:

engineGetSupportedSSLParameters in class SSLContextSpi

Returns:

a copy of the SSLParameters object with the maximum supported settings

Throws:

UnsupportedOperationException - if the supported SSL parameters could not be obtained.

Since:

1.6

See Also:

• SSLContextSpi.engineGetSupportedSSLParameters()