Package org.miaixz.bus.core.net.tls

Class SSLContextBuilder

java.lang.Object

org.miaixz.bus.core.net.tls.SSLContextBuilder

All Implemented Interfaces:

Serializable, Builder<SSLContext>

public class SSLContextBuilder
extends Object
implements Builder<SSLContext>

SSLContext构建器，可以自定义：

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

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

Since:

Java 17+

Author:

Kimi Liu

See Also:

• Serialized Form

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, KeyManager[] keyManagers, TrustManager[] trustManagers)	创建和初始化SSLContext
static SSLContext	createSSLContext(String protocol, KeyManager keyManager, TrustManager trustManager)	创建SSLContext
static SSLContext	createTrustAnySSLContext()	创建SSLContext，信任全部，协议为TLS
static SSLContext	createTrustAnySSLContext(String protocol)	创建SSLContext，信任全部
static SSLContext	getDefault()	获取默认的SSLContext
static SSLContext	getSSLContext()
static SSLSocketFactory	newSslSocketFactory(X509TrustManager x509TrustManager)	创建SSL证书
static X509TrustManager	newTrustManager()
static SSLContextBuilder	of()	创建 SSLContextBuilder
SSLContextBuilder	setKeyManagers(KeyManager... keyManagers)	设置 JSSE data managers
SSLContextBuilder	setProtocol(String protocol)	设置协议。例如TLS等
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

getDefault

public static SSLContext getDefault()

获取默认的SSLContext

Returns:

SSLContext

createTrustAnySSLContext

public static SSLContext createTrustAnySSLContext()
                                           throws InternalException

创建SSLContext，信任全部，协议为TLS

Returns:

SSLContext

Throws:

InternalException - 包装 GeneralSecurityException异常

createTrustAnySSLContext

public static SSLContext createTrustAnySSLContext(String protocol)
                                           throws InternalException

创建SSLContext，信任全部

Parameters:

protocol - SSL协议，例如TLS等，null表示默认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工厂

newTrustManager

public static X509TrustManager newTrustManager()

getSSLContext

public static SSLContext getSSLContext()

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 data managers

Parameters:

keyManagers - JSSE data 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异常