javax.net.ssl

Class SSLContext

java.lang.Object
|
+--javax.net.ssl.SSLContext

public class SSLContext

extends java.lang.Object

A "meta-factory" for protocol-specific socket and server socket factories. This class serves as a clearinghouse for socket factories and cached session contexts for a particular protocol, such as SSLv3.

Author:

Casey Marshall (rsdio@metastatic.org)

Constructor Summary

SSLContext(javax.net.ssl.SSLContextSpi ctxSpi, Provider provider, String protocol)

Create a new SSL context.

Method Summary

`javax.net.ssl.SSLSessionContext`	`getClientSessionContext()` Returns the set of SSL contexts available for client connections.
`static javax.net.ssl.SSLContext`	`getInstance(String protocol)` Get an instance of a context for the specified protocol from the first provider that implements it.
`static javax.net.ssl.SSLContext`	`getInstance(String protocol, String provider)` Get an instance of a context for the specified protocol from the named provider.
`static javax.net.ssl.SSLContext`	`getInstance(String protocol, Provider provider)` Get an instance of a context for the specified protocol from the specified provider.
`String`	`getProtocol()` Returns the protocol name of this context.
`Provider`	`getProvider()` Returns the provider of this implementation.
`javax.net.ssl.SSLSessionContext`	`getServerSessionContext()` Returns the set of SSL contexts available for server connections.
`javax.net.ssl.SSLServerSocketFactory`	`getServerSocketFactory()` Returns the factory for server SSL sockets.
`javax.net.ssl.SSLSocketFactory`	`getSocketFactory()` Returns the factory for client SSL sockets.
`void`	`init(javax.net.ssl.KeyManager keyManagers, javax.net.ssl.TrustManager trustManagers, SecureRandom random)` Initializes this context and prepares it for producing socket factories.

Constructor Details

SSLContext

protected SSLContext(javax.net.ssl.SSLContextSpi ctxSpi, Provider provider, String protocol)

Create a new SSL context.

Parameters:

ctxSpi - The context engine.
provider - The provider of the implementation.
protocol - The name of the SSL protocol.

Method Details

getClientSessionContext

public final SSLSessionContext getClientSessionContext()

Returns the set of SSL contexts available for client connections.

Returns:

The set of SSL contexts available for client connections.

getInstance

public static final SSLContext getInstance(String protocol)

Get an instance of a context for the specified protocol from the first provider that implements it.

Parameters:

protocol - The name of the protocol to get a context for.

Returns:

The new context.

Throws:

- If no provider implements the given protocol.

getInstance

public static final SSLContext getInstance(String protocol, Provider provider)

Get an instance of a context for the specified protocol from the specified provider.

Parameters:

protocol - The name of the protocol to get a context for.
provider - The name of the provider to get the implementation from.

Returns:

The new context.

Throws:

- If the provider does not implement the given protocol.
- If provider is null.

getInstance

public static final SSLContext getInstance(String protocol, String provider)

Get an instance of a context for the specified protocol from the named provider.

Parameters:

protocol - The name of the protocol to get a context for.
provider - The name of the provider to get the implementation from.

Returns:

The new context.

Throws:

- If the provider does not implement the given protocol.
- If the named provider does not exist.
- If provider is null.

getProtocol

public final String getProtocol()

Returns the protocol name of this context.

Returns:

The protocol name of this context.

getProvider

public final Provider getProvider()

Returns the provider of this implementation.

Returns:

The provider of this implementation.

getServerSessionContext

public final SSLSessionContext getServerSessionContext()

Returns the set of SSL contexts available for server connections.

Returns:

The set of SSL contexts available for server connections.

getServerSocketFactory

public final SSLServerSocketFactory getServerSocketFactory()

Returns the factory for server SSL sockets.

Returns:

The factory for server SSL sockets.

getSocketFactory

public final SSLSocketFactory getSocketFactory()

Returns the factory for client SSL sockets.

Returns:

The factory for client SSL sockets.

init

public final void init(javax.net.ssl.KeyManager keyManagers, javax.net.ssl.TrustManager trustManagers, SecureRandom random)

Initializes this context and prepares it for producing socket factories. All of the parameters are optional; default values are used if left unspecified.

Parameters:

keyManagers - The set of key managers to use.
trustManagers - The set of trust managers to use.
random - A source of random bits to use.

Throws:

- If initialization fails.