SSLParameters (Java Platform SE 8 )

java.lang.Object
- javax.net.ssl.SSLParameters

```
public class SSLParameters
extends Object
```
封装SSL / TLS连接的参数。参数是SSL / TLS握手中要接受的密码列表，要允许的协议列表，SSL / TLS握手期间的端点识别算法，服务器名称指示（SNI），算法约束以及SSL / TLS服务器应请求或要求客户端认证等。
SSLParameters可以通过此类中的构造函数创建。也可以使用SSLSocket和SSLServerSocket和SSLEngine中的getSSLParameters()方法或SSLContext中的getDefaultSSLParameters()和getSupportedSSLParameters()方法获得SSLContext 。

SSLParameters可以通过方法SSLSocket.setSSLParameters()和SSLServerSocket.setSSLParameters()和SSLEngine.setSSLParameters()应用于连接。

从以下版本开始：

1.6

另请参见：

SSLSocket ， SSLEngine ， SSLContext

构造方法摘要

构造方法
Constructor and Description
`SSLParameters()` 构造SSLParameters。
`SSLParameters(String[] cipherSuites)` 从指定的密码子数组构造SSLParameters。
`SSLParameters(String[] cipherSuites, String[] protocols)` 从指定的密码和协议数组构造SSLParameters。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`AlgorithmConstraints`	`getAlgorithmConstraints()` 返回加密算法约束。
`String[]`	`getCipherSuites()` 返回密码组数组的副本，如果没有设置则返回null。
`String`	`getEndpointIdentificationAlgorithm()` 获取端点识别算法。
`boolean`	`getNeedClientAuth()` 返回是否需要客户端身份验证。
`String[]`	`getProtocols()` 返回协议数组的副本，如果没有设置，则返回null。
`List<SNIServerName>`	`getServerNames()` 返回`List`包含所有`SNIServerName` •服务器名称指示的（SNI）的参数，如果没有则为null已设置。
`Collection<SNIMatcher>`	`getSNIMatchers()` 返回`Collection`包含所有`SNIMatcher` •服务器名称指示的（SNI）的参数，如果没有则为null已设置。
`boolean`	`getUseCipherSuitesOrder()` 返回是否应该遵守本地密码套件的偏好。
`boolean`	`getWantClientAuth()` 返回是否应请求客户端身份验证。
`void`	`setAlgorithmConstraints(AlgorithmConstraints constraints)` 设置加密算法约束，除了由运行时环境配置的任何约束之外，它将被使用。
`void`	`setCipherSuites(String[] cipherSuites)` 设置密码组数组。
`void`	`setEndpointIdentificationAlgorithm(String algorithm)` 设置端点识别算法。
`void`	`setNeedClientAuth(boolean needClientAuth)` 设置是否需要客户端身份验证。
`void`	`setProtocols(String[] protocols)` 设置协议数组。
`void`	`setServerNames(List<SNIServerName> serverNames)` 设置所需`SNIServerName`个 S中的服务器名称指示（SNI）参数。
`void`	`setSNIMatchers(Collection<SNIMatcher> matchers)` 设置`SNIMatcher`个 S中的服务器名称指示（SNI）参数。
`void`	`setUseCipherSuitesOrder(boolean honorOrder)` 设置本地密码套件的优先级是否应该被兑现。
`void`	`setWantClientAuth(boolean wantClientAuth)` 设置是否请求客户端身份验证。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造方法详细信息
  - SSLParameters
```
public SSLParameters()
```
    构造SSLParameters。
    密码套件，协议，加密算法约束，端点识别算法，服务器名称和服务器名称匹配器的值设置为null ，useCipherSuitesOrder，wantClientAuth和needClientAuth设置为false 。
  - SSLParameters
```
public SSLParameters(String[] cipherSuites)
```
    从指定的密码子数组构造SSLParameters。
    调用此构造函数等效于调用no-args构造函数，后跟setCipherSuites(cipherSuites); 。
    
    参数
    
    cipherSuites - 密码队列（或null）
  - SSLParameters
```
public SSLParameters(String[] cipherSuites,
                     String[] protocols)
```
    从指定的密码和协议数组构造SSLParameters。
    调用此构造函数相当于调用no-args构造函数，后跟setCipherSuites(cipherSuites); setProtocols(protocols); 。
    
    参数
    
    cipherSuites - 密码队列（或null）
    
    protocols - 协议数组（或null）
- 方法详细信息
  - getCipherSuites
```
public String[] getCipherSuites()
```
    返回密码组数组的副本，如果没有设置则返回null。
    
    结果
    
    密码组数组的副本，如果没有设置则为null。
  - setCipherSuites
```
public void setCipherSuites(String[] cipherSuites)
```
    设置密码组数组。
    
    参数
    
    cipherSuites - 密码队列（或null）
  - getProtocols
```
public String[] getProtocols()
```
    返回协议数组的副本，如果没有设置，则返回null。
    
    结果
    
    协议数组的副本，如果没有设置，则为null。
  - setProtocols
```
public void setProtocols(String[] protocols)
```
    设置协议数组。
    
    参数
    
    protocols - 协议数组（或null）
  - getWantClientAuth
```
public boolean getWantClientAuth()
```
    返回是否应请求客户端身份验证。
    
    结果
    
    是否应请求客户端认证。
  - setWantClientAuth
```
public void setWantClientAuth(boolean wantClientAuth)
```
    设置是否请求客户端身份验证。调用此方法可清除needClientAuth标志。
    
    参数
    
    wantClientAuth - 是否应请求客户端认证
  - getNeedClientAuth
```
public boolean getNeedClientAuth()
```
    返回是否需要客户端身份验证。
    
    结果
    
    是否需要客户端认证。
  - setNeedClientAuth
```
public void setNeedClientAuth(boolean needClientAuth)
```
    设置是否需要客户端身份验证。调用此方法将清除wantClientAuth标志。
    
    参数
    
    needClientAuth - 是否需要客户端认证
  - getAlgorithmConstraints
```
public AlgorithmConstraints getAlgorithmConstraints()
```
    返回加密算法约束。
    
    结果
    
    加密算法约束，如果还没有设置约束，则为null
    
    从以下版本开始：
    
    1.7
    
    另请参见：
    
    setAlgorithmConstraints(AlgorithmConstraints)
  - setAlgorithmConstraints
```
public void setAlgorithmConstraints(AlgorithmConstraints constraints)
```
    设置加密算法约束，除了由运行时环境配置的任何约束之外，它将被使用。
    如果constraints参数为非空值，那么SSL / TLS握手中使用的每个加密算法，密钥和算法参数都必须被约束所允许。
    
    参数
    
    constraints - 算法约束（或null）
    
    从以下版本开始：
    
    1.7
  - getEndpointIdentificationAlgorithm
```
public String getEndpointIdentificationAlgorithm()
```
    获取端点识别算法。
    
    结果
    
    端点识别算法，如果没有设置，则为null。
    
    从以下版本开始：
    
    1.7
    
    另请参见：
    
    X509ExtendedTrustManager ， setEndpointIdentificationAlgorithm(String)
  - setEndpointIdentificationAlgorithm
```
public void setEndpointIdentificationAlgorithm(String algorithm)
```
    设置端点识别算法。
    如果algorithm参数为非空或非空，则必须在SSL / TLS握手期间处理端点标识/验证过程。这是为了防止中间人的袭击。
    
    参数
    
    algorithm - 端点标识算法的标准字符串名称（或null）。有关标准算法名称的信息，请参阅Java Cryptography Architecture API Specification & Reference中的附录A.
    
    从以下版本开始：
    
    1.7
    
    另请参见：
    
    X509ExtendedTrustManager
  - setServerNames
```
public final void setServerNames(List<SNIServerName> serverNames)
```
    设置所需SNIServerName个 S中的服务器名称指示（SNI）参数。
    此方法仅对客户端模式下运行的SSLSocket s或SSLEngine有用。
    
    请注意， serverNames列表被克隆以防止后续修改。
    
    参数
    
    serverNames - 所需的SNIServerName的列表（或null）
    
    异常
    
    NullPointerException - 如果 serverNames包含 null元素
    
    IllegalArgumentException - 如果 serverNames包含多个名称相同的名称类型
    
    从以下版本开始：
    
    1.8
    
    另请参见：
    
    SNIServerName ， getServerNames()
  - getServerNames
```
public final List<SNIServerName> getServerNames()
```
    返回List包含所有SNIServerName •服务器名称指示的（SNI）的参数，如果没有则为null已设置。
    此方法仅对客户端模式下运行的SSLSocket s或SSLEngine有用。
    
    对于SSL / TLS连接，底层SSL / TLS提供程序可能会为某个服务器名称类型指定默认值。在客户端模式下，建议默认情况下，每当服务器可以通过受支持的服务器名称类型定位时，提供程序应包括服务器名称指示。
    
    建议供应商创建初始化时默认的服务器名称主治SSLSocket / SSLEngine秒。在以下实施例中，服务器名称可以通过的一个实例被表示SNIHostName已初始化主机名“www.example.com”和类型StandardConstants.SNI_HOST_NAME 。
```
  Socket socket =
         sslSocketFactory.createSocket("www.example.com", 443); 
```
    要么
```
  SSLEngine engine =
         sslContext.createSSLEngine("www.example.com", 443); 
```
    结果
    
    null或不可变的非空值列表SNIServerName s
    
    从以下版本开始：
    
    1.8
    
    另请参见：
    
    List ， setServerNames(List)
  - setSNIMatchers
```
public final void setSNIMatchers(Collection<SNIMatcher> matchers)
```
    设置SNIMatcher个 S中的服务器名称指示（SNI）参数。
    此方法只对有用SSLSocket个 S或SSLEngine个 S IN服务器模式下工作。
    
    请注意， matchers集合被克隆以防止后续修改。
    
    参数
    
    matchers - 收集SNIMatcher s（或null）
    
    异常
    
    NullPointerException - 如果 matchers包含 null元素
    
    IllegalArgumentException - 如果 matchers包含多个名称相同的名称类型
    
    从以下版本开始：
    
    1.8
    
    另请参见：
    
    Collection ， SNIMatcher ， getSNIMatchers()
  - getSNIMatchers
```
public final Collection<SNIMatcher> getSNIMatchers()
```
    返回Collection包含所有SNIMatcher •服务器名称指示的（SNI）的参数，如果没有则为null已设置。
    此方法只对有用SSLSocket个 S或SSLEngine个 S IN服务器模式下工作。
    
    为了更好的互操作性，提供商通常不会定义默认的匹配器，因此默认情况下，服务器将忽略SNI扩展并继续握手。
    
    结果
    
    null或不可变的非空值集合SNIMatcher s
    
    从以下版本开始：
    
    1.8
    
    另请参见：
    
    SNIMatcher ， setSNIMatchers(Collection)
  - setUseCipherSuitesOrder
```
public final void setUseCipherSuitesOrder(boolean honorOrder)
```
    设置本地密码套件的优先级是否应该被兑现。
    
    参数
    
    honorOrder - 在SSL / TLS握手期间是否应该遵守 #getCipherSuites本地密码套餐订单。
    
    从以下版本开始：
    
    1.8
    
    另请参见：
    
    getUseCipherSuitesOrder()
  - getUseCipherSuitesOrder
```
public final boolean getUseCipherSuitesOrder()
```
    返回是否应该遵守本地密码套件的偏好。
    
    结果
    
    本地密码套件在 #getCipherSuites中的 #getCipherSuites应在SSL / TLS握手期间得到兑现。
    
    从以下版本开始：
    
    1.8
    
    另请参见：
    
    setUseCipherSuitesOrder(boolean)

Class SSLParameters

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

构造方法详细信息

SSLParameters

SSLParameters

SSLParameters

方法详细信息

getCipherSuites

setCipherSuites

getProtocols

setProtocols

getWantClientAuth

setWantClientAuth

getNeedClientAuth

setNeedClientAuth

getAlgorithmConstraints

setAlgorithmConstraints

getEndpointIdentificationAlgorithm

setEndpointIdentificationAlgorithm

setServerNames

getServerNames

setSNIMatchers

getSNIMatchers

setUseCipherSuitesOrder

getUseCipherSuitesOrder