Package io.netty.handler.ssl.util

Class BouncyCastleUtil

java.lang.Object

io.netty.handler.ssl.util.BouncyCastleUtil

public final class BouncyCastleUtil
extends Object

Contains methods that can be used to detect if BouncyCastle is available.

Field Summary

Fields

Modifier and Type	Field	Description
private static boolean	attemptedLoading
private static final String	BC_FIPS_PROVIDER
private static final String	BC_FIPS_PROVIDER_NAME
private static final String	BC_JSSE_ALPN_SELECTOR
private static final String	BC_JSSE_PROVIDER
private static final String	BC_JSSE_PROVIDER_NAME
private static final String	BC_JSSE_SSLENGINE
private static final String	BC_PEMPARSER
private static final String	BC_PROVIDER
private static final String	BC_PROVIDER_NAME
private static Provider	bcProviderJce
private static Provider	bcProviderJsse
private static Class<? extends SSLEngine>	bcSSLEngineClass
private static final InternalLogger	logger
private static Throwable	unavailabilityCauseBcPkix
private static Throwable	unavailabilityCauseBcProv
private static Throwable	unavailabilityCauseBcTls

Constructor Summary

Constructors

Modifier	Constructor	Description
private	BouncyCastleUtil()

Method Summary

Modifier and Type	Method	Description
private static void	ensureLoaded()
static Provider	getBcProviderJce()	Get the BouncyCastle Java Crypto Extensions provider, or throw an exception if it is unavailable.
static Provider	getBcProviderJsse()	Get the BouncyCastle Java Secure Socket Extensions provider, or throw an exception if it is unavailable.
static Class<? extends SSLEngine>	getBcSSLEngineClass()	Returns the public SSLEngine sub-class that is used by bouncy-castle or null if it can't be loaded.
static boolean	isBcJsseInUse(SSLEngine engine)	Indicates whether the given SSLEngine is implemented by BouncyCastle.
static boolean	isBcPkixAvailable()	Indicate whether the BouncyCastle Public-Key Infrastructure utilities are available.
static boolean	isBcProvAvailable()	Indicate whether the BouncyCastle Java Crypto Extensions provider is available.
static boolean	isBcTlsAvailable()	Indicate whether the BouncyCastle Java Secure Socket Extensions provider is available.
(package private) static void	reset()	Reset the loaded providers.
private static void	tryLoading()
static Throwable	unavailabilityCauseBcPkix()
static Throwable	unavailabilityCauseBcProv()
static Throwable	unavailabilityCauseBcTls()

Methods inherited from class java.lang.Object

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

Field Details

logger

private static final InternalLogger logger

BC_PROVIDER_NAME

private static final String BC_PROVIDER_NAME

See Also:

• Constant Field Values

BC_PROVIDER

private static final String BC_PROVIDER

See Also:

• Constant Field Values

BC_FIPS_PROVIDER_NAME

private static final String BC_FIPS_PROVIDER_NAME

See Also:

• Constant Field Values

BC_FIPS_PROVIDER

private static final String BC_FIPS_PROVIDER

See Also:

• Constant Field Values

BC_JSSE_PROVIDER_NAME

private static final String BC_JSSE_PROVIDER_NAME

See Also:

• Constant Field Values

BC_JSSE_PROVIDER

private static final String BC_JSSE_PROVIDER

See Also:

• Constant Field Values

BC_PEMPARSER

private static final String BC_PEMPARSER

See Also:

• Constant Field Values

BC_JSSE_SSLENGINE

private static final String BC_JSSE_SSLENGINE

See Also:

• Constant Field Values

BC_JSSE_ALPN_SELECTOR

private static final String BC_JSSE_ALPN_SELECTOR

See Also:

• Constant Field Values

unavailabilityCauseBcProv

private static volatile Throwable unavailabilityCauseBcProv

unavailabilityCauseBcPkix

private static volatile Throwable unavailabilityCauseBcPkix

unavailabilityCauseBcTls

private static volatile Throwable unavailabilityCauseBcTls

bcProviderJce

private static volatile Provider bcProviderJce

bcProviderJsse

private static volatile Provider bcProviderJsse

bcSSLEngineClass

private static volatile Class<? extends SSLEngine> bcSSLEngineClass

attemptedLoading

private static volatile boolean attemptedLoading

Constructor Details

BouncyCastleUtil

private BouncyCastleUtil()

Method Details

isBcProvAvailable

public static boolean isBcProvAvailable()

Indicate whether the BouncyCastle Java Crypto Extensions provider is available.

isBcPkixAvailable

public static boolean isBcPkixAvailable()

Indicate whether the BouncyCastle Public-Key Infrastructure utilities are available.

isBcTlsAvailable

public static boolean isBcTlsAvailable()

Indicate whether the BouncyCastle Java Secure Socket Extensions provider is available.

unavailabilityCauseBcProv

public static Throwable unavailabilityCauseBcProv()

Returns:

the cause if unavailable. null if available.

unavailabilityCauseBcPkix

public static Throwable unavailabilityCauseBcPkix()

Returns:

the cause if unavailable. null if available.

unavailabilityCauseBcTls

public static Throwable unavailabilityCauseBcTls()

Returns:

the cause if unavailable. null if available.

isBcJsseInUse

public static boolean isBcJsseInUse(SSLEngine engine)

Indicates whether the given SSLEngine is implemented by BouncyCastle.

getBcProviderJce

public static Provider getBcProviderJce()

Get the BouncyCastle Java Crypto Extensions provider, or throw an exception if it is unavailable.

getBcProviderJsse

public static Provider getBcProviderJsse()

Get the BouncyCastle Java Secure Socket Extensions provider, or throw an exception if it is unavailable.

getBcSSLEngineClass

public static Class<? extends SSLEngine> getBcSSLEngineClass()

Returns the public SSLEngine sub-class that is used by bouncy-castle or null if it can't be loaded.

Returns:

engine class.

reset

static void reset()

Reset the loaded providers. Useful for testing, to redo the loading under different conditions.

ensureLoaded

private static void ensureLoaded()

tryLoading

private static void tryLoading()