org.apache.hc.core5.ssl

Class SSLContexts

java.lang.Object

org.apache.hc.core5.ssl.SSLContexts

public final class SSLContexts
extends Object

SSLContext factory methods.

Please note: the default Oracle JSSE implementation of SSLContext#init(KeyManager[], TrustManager[], SecureRandom) accepts multiple key and trust managers, however only only first matching type is ever used. See for example: SSLContext.html#init

Since:

4.4

Method Summary

Modifier and Type	Method and Description
static SSLContext	createDefault() Creates default factory based on the standard JSSE trust material (cacerts file in the security properties directory).
static SSLContext	createSystemDefault() Creates default SSL context based on system properties.
static SSLContextBuilder	custom() Creates custom SSL context.

Methods inherited from class java.lang.Object

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

Method Detail

createDefault

public static SSLContext createDefault()
                                throws SSLInitializationException

Creates default factory based on the standard JSSE trust material (cacerts file in the security properties directory). System properties are not taken into consideration.

Returns:

the default SSL socket factory

Throws:

SSLInitializationException - if NoSuchAlgorithmException or KeyManagementException are thrown when invoking SSLContext.getInstance(String)

createSystemDefault

public static SSLContext createSystemDefault()
                                      throws SSLInitializationException

Creates default SSL context based on system properties. This method obtains default SSL context by calling SSLContext.getInstance("Default"). Please note that Default algorithm is supported as of Java 6. This method will fall back onto createDefault() when Default algorithm is not available.

Returns:

default system SSL context

Throws:

SSLInitializationException - if createDefault() throws it

custom

public static SSLContextBuilder custom()

Creates custom SSL context.

Returns:

default system SSL context