API java : SSLContextSpi

javax.net.ssl
Class SSLContextSpi

java.lang.Object
  javax.net.ssl.SSLContextSpi

public abstract class SSLContextSpi
extends Object

This class defines the Service Provider Interface (SPI) for the SSLContext class.

All the abstract methods in this class must be implemented by each cryptographic service provider who wishes to supply the implementation of a particular SSL context.

Since:

1.4

See Also:

SSLContext

Constructor Summary
SSLContextSpi()

 

Method Summary
protected abstract  SSLEngine	engineCreateSSLEngine()           Creates a new SSLEngine using this context.
protected abstract  SSLEngine	engineCreateSSLEngine(String host, int port)           Creates a SSLEngine using this context.
protected abstract  SSLSessionContext	engineGetClientSessionContext()           Returns a client SSLSessionContext object for this context.
protected abstract  SSLSessionContext	engineGetServerSessionContext()           Returns a server SSLSessionContext object for this context.
protected abstract  SSLServerSocketFactory	engineGetServerSocketFactory()           Returns a ServerSocketFactory object for this context.
protected abstract  SSLSocketFactory	engineGetSocketFactory()           Returns a SocketFactory object for this context.
protected abstract  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

 

Constructor Detail

SSLContextSpi

public SSLContextSpi()

engineInit

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

Initializes this context.

Parameters:

km - the sources of authentication keys

tm - the sources of peer authentication trust decisions

sr - the source of randomness

Throws:

KeyManagementException - if this operation fails

See Also:

SSLContext.init(KeyManager [], TrustManager [], SecureRandom)

engineGetSocketFactory

protected abstract SSLSocketFactory engineGetSocketFactory()

Returns a SocketFactory object for this context.

Returns:

the SocketFactory object

See Also:

SSLContext.getSocketFactory()

engineGetServerSocketFactory

protected abstract SSLServerSocketFactory engineGetServerSocketFactory()

Returns a ServerSocketFactory object for this context.

Returns:

the ServerSocketFactory object

See Also:

SSLContext.getServerSocketFactory()

engineCreateSSLEngine

protected abstract SSLEngine engineCreateSSLEngine()

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.

Returns:

the SSLEngine Object

Since:

1.5

See Also:

SSLContext.createSSLEngine()

engineCreateSSLEngine

protected abstract SSLEngine engineCreateSSLEngine(String host,
                                                   int port)

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.

Parameters:

host - the non-authoritative name of the host

port - the non-authoritative port

Returns:

the SSLEngine Object

Since:

1.5

See Also:

SSLContext.createSSLEngine(String, int)

engineGetServerSessionContext

protected abstract SSLSessionContext engineGetServerSessionContext()

Returns a server SSLSessionContext object for this context.

Returns:

the SSLSessionContext object

See Also:

SSLContext.getServerSessionContext()

engineGetClientSessionContext

protected abstract SSLSessionContext engineGetClientSessionContext()

Returns a client SSLSessionContext object for this context.

Returns:

the SSLSessionContext object

See Also:

SSLContext.getClientSessionContext()