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或SSLContext的getDefaultSSLParameters()和getSupportedSSLParameters()方法采用getSSLParameters()方法获得。

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

从以下版本开始：

一点六

另请参见：

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()` 返回一个拷贝的密码套件或空数组如果没有设置。
`String`	`getEndpointIdentificationAlgorithm()` 获取端点识别算法。
`boolean`	`getNeedClientAuth()` 返回客户端身份验证是否应该被要求。
`String[]`	`getProtocols()` 返回一个协议或空数组的副本，如果没有被设置。
`List<SNIServerName>`	`getServerNames()` 返回一个包含所有 `SNIServerName`s `List`的服务器名称指示（SNI）的参数，如果没有设置或空。
`Collection<SNIMatcher>`	`getSNIMatchers()` 返回一个包含所有 `SNIMatcher`s `Collection`的服务器名称指示（SNI）的参数，如果没有设置或空。
`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

- Constructor Detail
  - SSLParameters
```
public SSLParameters()
```
    构建sslparameters。
    的密码套件，价值协议，加密算法的限制，端点识别算法，服务器名称和服务器名称匹配器将null，useciphersuitesorder，wantclientauth和needclientauth将false。
  - SSLParameters
```
public SSLParameters(String[] cipherSuites)
```
    构建sslparameters从指定数组的密码套件。
    调用此构造函数相当于调用无参构造函数依次setCipherSuites(cipherSuites);。
    
    参数
    
    cipherSuites -密码组阵列（或零）
  - SSLParameters
```
public SSLParameters(String[] cipherSuites,
                     String[] protocols)
```
    构建sslparameters从指定数组密码套件和协议。
    调用此构造函数相当于调用无参构造函数依次setCipherSuites(cipherSuites); setProtocols(protocols);。
    
    参数
    
    cipherSuites -密码组阵列（或零）
    
    protocols -协议的阵列（或零）
- 方法详细信息
  - getCipherSuites
```
public String[] getCipherSuites()
```
    返回一个拷贝的密码套件或空数组如果没有设置。
    
    结果
    
    复制的密码套件或空数组，如果没有一套。
  - setCipherSuites
```
public void setCipherSuites(String[] cipherSuites)
```
    设置密码组阵列。
    
    参数
    
    cipherSuites -密码组阵列（或零）
  - getProtocols
```
public String[] getProtocols()
```
    返回一个协议或空数组的副本，如果没有被设置。
    
    结果
    
    如果没有设置的协议或空的数组的副本。
  - setProtocols
```
public void setProtocols(String[] protocols)
```
    设置协议数组。
    
    参数
    
    protocols -协议的阵列（或零）
  - 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()
```
    返回密码算法约束。
    
    结果
    
    的加密算法的约束，或空，如果没有被设置的约束
    
    从以下版本开始：
    
    一点七
    
    另请参见：
    
    setAlgorithmConstraints(AlgorithmConstraints)
  - setAlgorithmConstraints
```
public void setAlgorithmConstraints(AlgorithmConstraints constraints)
```
    设置的加密算法的约束，这将被用于除了任何配置的运行时环境。
    如果constraints参数非空，每一个加密算法，使用SSL / TLS握手密钥和算法参数必须由约束允许的。
    
    参数
    
    constraints算法的约束（或零）
    
    从以下版本开始：
    
    一点七
  - getEndpointIdentificationAlgorithm
```
public String getEndpointIdentificationAlgorithm()
```
    获取端点识别算法。
    
    结果
    
    端点识别算法，或无效，如果没有被设置。
    
    从以下版本开始：
    
    一点七
    
    另请参见：
    
    X509ExtendedTrustManager， setEndpointIdentificationAlgorithm(String)
  - setEndpointIdentificationAlgorithm
```
public void setEndpointIdentificationAlgorithm(String algorithm)
```
    设置端点识别算法。
    如果algorithm参数非空或非空，端点识别/验证程序必须处理在SSL / TLS握手。这是为了防止人在中间的攻击。
    
    参数
    
    algorithm的端点识别算法标准字符串名称（或零）。见附录A中的 Java Cryptography Architecture API Specification & Reference 有关标准算法名称信息。
    
    从以下版本开始：
    
    一点七
    
    另请参见：
    
    X509ExtendedTrustManager
  - setServerNames
```
public final void setServerNames(List<SNIServerName> serverNames)
```
    设置服务器名称指示所需的 SNIServerNames（SNI）参数。
    此方法仅用于SSLSockets或SSLEngines在客户端模式操作。
    
    需要注意的是，克隆以防止后续修改的serverNames列表。
    
    参数
    
    serverNames -所需的 SNIServerNames列表（或零）
    
    异常
    
    NullPointerException -如果 serverNames包含 null元
    
    IllegalArgumentException -如果 serverNames包含多个名称相同的名称类型
    
    从以下版本开始：
    
    一点八
    
    另请参见：
    
    SNIServerName， getServerNames()
  - getServerNames
```
public final List<SNIServerName> getServerNames()
```
    返回一个包含所有 SNIServerNames List的服务器名称指示（SNI）的参数，如果没有设置或空。
    此方法仅用于SSLSockets或SSLEngines在客户端模式操作。
    
    SSL / TLS连接，底层SSL / TLS的提供者可以指定某个服务器名称类型的默认值。在客户端模式中，建议默认情况下，当服务器可以位于受支持的服务器名称类型时，应包括服务器名称指示。
    
    建议供应商初始化默认的服务器名称指示创建SSLSocket / SSLEngines时。在下面的例子中，服务器名称，可以通过SNIHostName已与主机名”www.example初始化的实例表示。com”型StandardConstants.SNI_HOST_NAME。
```
插座插座=createsocket SSLSocketFactory。（“www.example .com”，443）；
```
    或
```
sslengine发动机=createsslengine SSLContext。（“www.example .com”，443）；
```
    结果
    
    空或不可变的非空 SNIServerNames列表
    
    从以下版本开始：
    
    一点八
    
    另请参见：
    
    List， setServerNames(List)
  - setSNIMatchers
```
public final void setSNIMatchers(Collection<SNIMatcher> matchers)
```
    设置服务器名称指示的 SNIMatchers（SNI）参数。
    此方法仅用于SSLSockets或SSLEngines服务器模式运行。
    
    需要注意的是，克隆以防止后续修改的matchers收集。
    
    参数
    
    matchers - SNIMatchers收集（或零）
    
    异常
    
    NullPointerException -如果 matchers包含 null元
    
    IllegalArgumentException -如果 matchers包含多个名称相同的名称类型
    
    从以下版本开始：
    
    一点八
    
    另请参见：
    
    Collection， SNIMatcher， getSNIMatchers()
  - getSNIMatchers
```
public final Collection<SNIMatcher> getSNIMatchers()
```
    返回一个包含所有 SNIMatchers Collection的服务器名称指示（SNI）的参数，如果没有设置或空。
    此方法仅用于SSLSockets或SSLEngines服务器模式运行。
    
    为更好的互操作性，供应商一般不会定义默认的匹配，默认情况下，服务器会忽略SNI的延伸和继续的握手。
    
    结果
    
    空或不可变集合非空 SNIMatchers
    
    从以下版本开始：
    
    一点八
    
    另请参见：
    
    SNIMatcher， setSNIMatchers(Collection)
  - setUseCipherSuitesOrder
```
public final void setUseCipherSuitesOrder(boolean honorOrder)
```
    设置本地密码套件是否应该被授予优先。
    
    参数
    
    honorOrder -无论是本地密码套件订单 #getCipherSuites应该荣幸在SSL / TLS握手。
    
    从以下版本开始：
    
    一点八
    
    另请参见：
    
    getUseCipherSuitesOrder()
  - getUseCipherSuitesOrder
```
public final boolean getUseCipherSuitesOrder()
```
    返回本地密码是否应该被授予本地密码。
    
    结果
    
    无论是本地密码套件订单 #getCipherSuites应该荣幸在SSL / TLS握手。
    
    从以下版本开始：
    
    一点八
    
    另请参见：
    
    setUseCipherSuitesOrder(boolean)

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class SSLParameters

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Constructor Detail

SSLParameters

SSLParameters

SSLParameters

方法详细信息

getCipherSuites

setCipherSuites

getProtocols

setProtocols

getWantClientAuth

setWantClientAuth

getNeedClientAuth

setNeedClientAuth

getAlgorithmConstraints

setAlgorithmConstraints

getEndpointIdentificationAlgorithm

setEndpointIdentificationAlgorithm

setServerNames

getServerNames

setSNIMatchers

getSNIMatchers

setUseCipherSuitesOrder

getUseCipherSuitesOrder