Package org.aoju.bus.core.net.tls

Class SSLContextBuilder

java.lang.Object

org.aoju.bus.core.net.tls.SSLContextBuilder

All Implemented Interfaces:

Serializable, Builder<SSLContext>

public class SSLContextBuilder
extends Object
implements Builder<SSLContext>

SSLContext构建器，可以自定义：

• 协议（protocol），默认TLS
• KeyManager，默认空
• TrustManager，默认DefaultTrustManager，即信任全部
• SecureRandom

构建后可获得SSLContext，通过调用SSLContext.getSocketFactory()获取SSLSocketFactory

Since:

Java 17+

Author:

Kimi Liu

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface org.aoju.bus.core.builder.Builder

Builder.HashKey

Constructor Summary

Constructors

Constructor	Description
SSLContextBuilder()

Method Summary

Modifier and Type	Method	Description
SSLContext	build()	构建SSLContext
SSLContext	buildChecked()	构建SSLContext需要处理异常
SSLContext	buildQuietly()	构建SSLContext
static SSLContext	createSSLContext(String protocol)	创建SSLContext，默认新人全部
static SSLContext	createSSLContext(String protocol, KeyManager[] keyManagers, TrustManager[] trustManagers)	创建和初始化SSLContext
static SSLContext	createSSLContext(String protocol, KeyManager keyManager, TrustManager trustManager)	创建SSLContext
static SSLContext	getSSLContext()
static SSLSocketFactory	newSslSocketFactory(X509TrustManager x509TrustManager)	创建SSL证书
static X509TrustManager	newTrustManager()
static SSLContextBuilder	of()	创建 SSLContextBuilder
SSLContextBuilder	setKeyManagers(KeyManager... keyManagers)	设置 JSSE key managers
SSLContextBuilder	setProtocol(String protocol)	设置协议。
SSLContextBuilder	setSecureRandom(SecureRandom secureRandom)	设置 SecureRandom
SSLContextBuilder	setTrustManagers(TrustManager... trustManagers)	设置信任信息

Methods inherited from class java.lang.Object

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

Constructor Details

SSLContextBuilder

public SSLContextBuilder()

Method Details

of

public static SSLContextBuilder of()

创建 SSLContextBuilder

Returns:

SSLContextBuilder

createSSLContext

public static SSLContext createSSLContext(String protocol)
                                   throws InternalException

创建SSLContext，默认新人全部

Parameters:

protocol - SSL协议，例如TLS等

Returns:

SSLContext

Throws:

InternalException - 包装 GeneralSecurityException异常

createSSLContext

public static SSLContext createSSLContext(String protocol,
 KeyManager keyManager,
 TrustManager trustManager)
                                   throws InternalException

创建SSLContext

Parameters:

protocol - SSL协议，例如TLS等

keyManager - 密钥管理器,null表示无

trustManager - 信任管理器, null表示无

Returns:

SSLContext

Throws:

InternalException - 包装 GeneralSecurityException异常

createSSLContext

public static SSLContext createSSLContext(String protocol,
 KeyManager[] keyManagers,
 TrustManager[] trustManagers)
                                   throws InternalException

创建和初始化SSLContext

Parameters:

protocol - SSL协议，例如TLS等

keyManagers - 密钥管理器,null表示无

trustManagers - 信任管理器, null表示无

Returns:

SSLContext

Throws:

InternalException - 包装 GeneralSecurityException异常

newSslSocketFactory

public static SSLSocketFactory newSslSocketFactory(X509TrustManager x509TrustManager)

创建SSL证书

Parameters:

x509TrustManager - 证书信息

Returns:

SSLSocketFactory ssl socket工厂

getSSLContext

public static SSLContext getSSLContext()

newTrustManager

public static X509TrustManager newTrustManager()

setProtocol

public SSLContextBuilder setProtocol(String protocol)

设置协议。例如TLS等

Parameters:

protocol - 协议

Returns:

自身

setTrustManagers

public SSLContextBuilder setTrustManagers(TrustManager... trustManagers)

设置信任信息

Parameters:

trustManagers - TrustManager列表

Returns:

自身

setKeyManagers

public SSLContextBuilder setKeyManagers(KeyManager... keyManagers)

设置 JSSE key managers

Parameters:

keyManagers - JSSE key managers

Returns:

自身

setSecureRandom

public SSLContextBuilder setSecureRandom(SecureRandom secureRandom)

设置 SecureRandom

Parameters:

secureRandom - SecureRandom

Returns:

自己

build

public SSLContext build()

构建SSLContext

Specified by:

build in interface Builder<SSLContext>

Returns:

SSLContext

buildChecked

public SSLContext buildChecked()
                        throws NoSuchAlgorithmException,
KeyManagementException

构建SSLContext需要处理异常

Returns:

SSLContext

Throws:

NoSuchAlgorithmException - 无此算法异常

KeyManagementException - 密钥管理异常

buildQuietly

public SSLContext buildQuietly()
                        throws InternalException

构建SSLContext

Returns:

SSLContext

Throws:

InternalException - 包装 GeneralSecurityException异常