SSLServerSocket (Java Platform SE 8 )

java.lang.Object
- java.net.ServerSocket
- - javax.net.ssl.SSLServerSocket

All Implemented Interfaces:

Closeable， AutoCloseable
```
public abstract class SSLServerSocket
extends ServerSocket
```
这类扩展 ServerSockets和提供使用协议如安全套接字层（SSL）安全服务器套接字或传输层安全（TLS）协议。
这个类的实例通常使用SSLServerSocketFactory创建。SSLServerSockets的主要功能是通过accepting连接创建SSLSockets。

SSLServerSockets包含状态数据，通过socket创作SSLSocket继承了几块。这些措施包括启用密码套件和协议，无论是客户端认证是必要的，以及是否应该开始创建套接字握手在客户端或服务器模式。被创造出来的SSLSocket继承的状态可以被调用适当的方法。

从以下版本开始：

一点四

另请参见：

ServerSocket， SSLSocket

构造方法摘要

构造方法
Modifier	Constructor and Description
`protected`	`SSLServerSocket()` 仅由子类使用。
`protected`	`SSLServerSocket(int port)` 仅由子类使用。
`protected`	`SSLServerSocket(int port, int backlog)` 仅由子类使用。
`protected`	`SSLServerSocket(int port, int backlog, InetAddress address)` 仅由子类使用。

方法摘要

所有方法接口方法抽象方法具体的方法
Modifier and Type	Method and Description
`abstract String[]`	`getEnabledCipherSuites()` 返回当前启用的密码列表，以供新接受的连接使用。
`abstract String[]`	`getEnabledProtocols()` 返回当前启用的协议的名称，以供新接受的连接使用。
`abstract boolean`	`getEnableSessionCreation()` 如果新的SSL会话可能是由从该服务器套接字创建套接字建立返回true。
`abstract boolean`	`getNeedClientAuth()` 如果客户端身份验证将必修的新 `accept`ed服务器模式 `SSLSocket`s返回true。
`SSLParameters`	`getSSLParameters()` 返回新接受的连接效果的sslparameters。
`abstract String[]`	`getSupportedCipherSuites()` 返回的密码套件可用于SSL连接启用的名字。
`abstract String[]`	`getSupportedProtocols()` 返回可以使用的协议的名称。
`abstract boolean`	`getUseClientMode()` 如果接受连接将SSL客户端模式返回true。
`abstract boolean`	`getWantClientAuth()` 如果客户端身份验证将请求新近接受服务器模式连接返回true。
`abstract void`	`setEnabledCipherSuites(String[] suites)` 设置由已接受的连接启用的密码套件。
`abstract void`	`setEnabledProtocols(String[] protocols)` 通过已接受的连接启用特定的协议的控件。
`abstract void`	`setEnableSessionCreation(boolean flag)` 控制是否可以通过新的SSL会话，从这个服务器套接字创建套接字的建立。
`abstract void`	`setNeedClientAuth(boolean need)` 控制是否 `accept`ed服务器模式 `SSLSockets`最初会被配置为要求客户端认证。
`void`	`setSSLParameters(SSLParameters params)` 适用于sslparameters新接受连接。
`abstract void`	`setUseClientMode(boolean mode)` 控制是否接受连接的SSL服务器模式（默认），或SSL客户机模式。
`abstract void`	`setWantClientAuth(boolean want)` 控制是否 `accept`ed服务器模式 `SSLSockets`最初会被配置为请求客户端认证。

Methods inherited from class java.net.ServerSocket
accept, bind, bind, close, getChannel, getInetAddress, getLocalPort, getLocalSocketAddress, getReceiveBufferSize, getReuseAddress, getSoTimeout, implAccept, isBound, isClosed, setPerformancePreferences, setReceiveBufferSize, setReuseAddress, setSocketFactory, setSoTimeout, toString

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

- Constructor Detail
  - SSLServerSocket
```
protected SSLServerSocket()
                   throws IOException
```
    仅由子类使用。
    创建一个绑定的TCP Socket服务器使用默认的认证上下文。
    
    异常
    
    IOException -如果一个I / O错误创建套接字时
  - SSLServerSocket
```
protected SSLServerSocket(int port)
                   throws IOException
```
    仅由子类使用。
    创建一个端口TCP Socket服务器，使用默认的认证上下文。在系统开始拒绝新的连接请求之前，连接积压默认为五十个连接队列。
    
    对0端口号在任意空闲端口创建套接字。
    
    如果存在安全管理器，它的checkListen方法被调用的port参数以保证运行参数是允许的。这可能导致SecurityException。
    
    参数
    
    port -这听口
    
    异常
    
    IOException -如果一个I / O错误创建套接字时
    
    SecurityException -如果存在一个安全管理及其 checkListen方法不允许操作。
    
    IllegalArgumentException如果端口外部端口的值指定的范围内，这是0和65535之间，包容。
    
    另请参见：
    
    SecurityManager.checkListen(int)
  - SSLServerSocket
```
protected SSLServerSocket(int port,
                          int backlog)
                   throws IOException
```
    仅由子类使用。
    创建一个端口TCP Socket服务器，使用默认的认证上下文指定积压的连接。
    
    对0端口号在任意空闲端口创建套接字。
    
    的backlog参数是请求的最大数量的挂起连接在插座上。它的确切的语义是实现特定的。特别是，一个实现可以处以最大长度或可以选择忽略参数的根。所提供的值应大于0。如果是小于或等于0，然后具体实现将使用默认。
    
    如果存在安全管理器，它的checkListen方法被调用的port参数以保证运行参数是允许的。这可能导致SecurityException。
    
    参数
    
    port -这听口
    
    backlog请求的最大长度的传入连接队列。
    
    异常
    
    IOException -如果一个I / O错误创建套接字时
    
    SecurityException -如果存在一个安全管理及其 checkListen方法不允许操作。
    
    IllegalArgumentException如果端口外部端口的值指定的范围内，这是0和65535之间，包容。
    
    另请参见：
    
    SecurityManager.checkListen(int)
  - SSLServerSocket
```
protected SSLServerSocket(int port,
                          int backlog,
                          InetAddress address)
                   throws IOException
```
    仅由子类使用。
    创建一个端口TCP Socket服务器，使用默认的认证上下文指定积压的连接，以及指定一个特定的网络接口。此构造函数使用多宿主主机，如那些用于防火墙或路由器的控制界面，通过网络提供服务。
    
    如果存在安全管理器，它的checkListen方法被调用的port参数以保证运行参数是允许的。这可能导致SecurityException。
    
    对0端口号在任意空闲端口创建套接字。
    
    的backlog参数是请求的最大数量的挂起连接在插座上。它的确切的语义是实现特定的。特别是，一个实现可以处以最大长度或可以选择忽略参数的根。所提供的值应大于0。如果是小于或等于0，然后具体实现将使用默认。
    
    如果地址是空的，它会默认接受任何/所有本地地址连接。
    
    参数
    
    port -这听口
    
    backlog请求的最大长度的传入连接队列。
    
    address -地址的网络接口通过连接将被接受
    
    异常
    
    IOException -如果一个I / O错误创建套接字时
    
    SecurityException -如果存在一个安全管理及其 checkListen方法不允许操作。
    
    IllegalArgumentException如果端口外部端口的值指定的范围内，这是0和65535之间，包容。
    
    另请参见：
    
    SecurityManager.checkListen(int)
- 方法详细信息
  - getEnabledCipherSuites
```
public abstract String[] getEnabledCipherSuites()
```
    返回当前启用的密码列表，以供新接受的连接使用。
    如果这个列表没有被显式修改，一个系统提供的默认保证了最低质量的服务在所有启用的密码套件。
    
    有几个原因，为什么一个启用的密码套件可能不会被使用。例如：服务器可能没有相应的私钥可以使用或密码套件可能是匿名的，排除客户使用验证，而服务器套接字已被告知需要那种认证。
    
    结果
    
    启用了一个密码套件数组
    
    另请参见：
    
    getSupportedCipherSuites()， setEnabledCipherSuites(String [])
  - setEnabledCipherSuites
```
public abstract void setEnabledCipherSuites(String[] suites)
```
    设置由已接受的连接启用的密码套件。
    密码套件必须被列为支持getsupportedciphersuites()。继成功调用这个方法，只有在suites参数上市套房都能使用。
    
    套房需要认证信息在这个ServerSocket的认证上下文不可用，将不会在任何情况下，即使他们启用。
    
    SSLSockets返回accept()继承此设置。
    
    参数
    
    suites名称的所有密码套件使
    
    异常
    
    IllegalArgumentException -当一个或多个密码的参数命名不支持，或者当参数为空。
    
    另请参见：
    
    getSupportedCipherSuites()， getEnabledCipherSuites()
  - getSupportedCipherSuites
```
public abstract String[] getSupportedCipherSuites()
```
    返回的密码套件可用于SSL连接启用的名字。
    通常情况下，只有一个子集，这些将实际启用默认情况下，因为这个列表可能包括密码套件，不符合质量的服务要求，这些默认。这种密码套件在专门的应用程序中是有用的。
    
    结果
    
    一个数组的密码套件名称
    
    另请参见：
    
    getEnabledCipherSuites()， setEnabledCipherSuites(String [])
  - getSupportedProtocols
```
public abstract String[] getSupportedProtocols()
```
    返回可以使用的协议的名称。
    
    结果
    
    支持的协议名称数组
    
    另请参见：
    
    getEnabledProtocols()， setEnabledProtocols(String [])
  - getEnabledProtocols
```
public abstract String[] getEnabledProtocols()
```
    返回当前启用的协议的名称，以供新接受的连接使用。
    
    结果
    
    一个协议名数组
    
    另请参见：
    
    getSupportedProtocols()， setEnabledProtocols(String [])
  - setEnabledProtocols
```
public abstract void setEnabledProtocols(String[] protocols)
```
    通过已接受的连接启用特定的协议的控件。
    该协议必须被列为支持getsupportedprotocols()。继成功调用这个方法，只有在protocols参数上市协议能使用。
    
    SSLSockets返回accept()继承此设置。
    
    参数
    
    protocols名称的所有协议，使。
    
    异常
    
    IllegalArgumentException -当一个或更多的协议参数的命名是不支持或当协议参数为空。
    
    另请参见：
    
    getEnabledProtocols()， getSupportedProtocols()
  - setNeedClientAuth
```
public abstract void setNeedClientAuth(boolean need)
```
    控制是否 accepted服务器模式 SSLSockets最初会被配置为要求客户端认证。
    套接字的客户端身份验证设置为以下几个：
    - 客户端认证要求
    - 客户端身份验证请求
    - 没有客户端身份验证
    不像setWantClientAuth(boolean)，如果接受的套接字的选项设置和客户端不提供关于本身，认证信息谈判将停止，连接将被删除。
    
    调用此方法重写这个方法或setWantClientAuth(boolean)做出任何以前的设置。
    
    最初继承的设置可以通过调用SSLSocket.setNeedClientAuth(boolean)或SSLSocket.setWantClientAuth(boolean)重写。
    参数
    
    need -设置为true，如果客户需要身份验证，或假如果没有客户端认证要求。
    
    另请参见：
    
    getNeedClientAuth()， setWantClientAuth(boolean)， getWantClientAuth()， setUseClientMode(boolean)
  - getNeedClientAuth
```
public abstract boolean getNeedClientAuth()
```
    如果客户端身份验证将必修的新 accepted服务器模式 SSLSockets返回true。
    最初继承的设置可以通过调用SSLSocket.setNeedClientAuth(boolean)或SSLSocket.setWantClientAuth(boolean)重写。
    
    结果
    
    如果需要客户端身份验证，或不需要客户端验证的情况下，则为假。
    
    另请参见：
    
    setNeedClientAuth(boolean)， setWantClientAuth(boolean)， getWantClientAuth()， setUseClientMode(boolean)
  - setWantClientAuth
```
public abstract void setWantClientAuth(boolean want)
```
    控制是否 accepted服务器模式 SSLSockets最初会被配置为请求客户端认证。
    套接字的客户端身份验证设置为以下几个：
    - 客户端认证要求
    - 客户端身份验证请求
    - 没有客户端身份验证
    不像setNeedClientAuth(boolean)，如果接受的套接字的选项设置和客户端不提供自己的认证信息，谈判将继续。
    
    调用此方法重写这个方法或setNeedClientAuth(boolean)做出任何以前的设置。
    
    最初继承的设置可以通过调用SSLSocket.setNeedClientAuth(boolean)或SSLSocket.setWantClientAuth(boolean)重写。
    参数
    
    want -设置为true，如果要求客户端身份验证，或假如果没有客户端认证要求。
    
    另请参见：
    
    getWantClientAuth()， setNeedClientAuth(boolean)， getNeedClientAuth()， setUseClientMode(boolean)
  - getWantClientAuth
```
public abstract boolean getWantClientAuth()
```
    如果客户端身份验证将请求新近接受服务器模式连接返回true。
    最初继承的设置可以通过调用SSLSocket.setNeedClientAuth(boolean)或SSLSocket.setWantClientAuth(boolean)重写。
    
    结果
    
    如果要请求客户端身份验证，或如果没有希望客户端身份验证的话，则为。
    
    另请参见：
    
    setWantClientAuth(boolean)， setNeedClientAuth(boolean)， getNeedClientAuth()， setUseClientMode(boolean)
  - setUseClientMode
```
public abstract void setUseClientMode(boolean mode)
```
    控制是否接受连接的SSL服务器模式（默认），或SSL客户机模式。
    服务器通常对自己进行身份验证，而客户端不需要这样做。
    
    在罕见的情况下，TCP服务器需要在SSL客户端模式对新接受的连接。例如，FTP客户端获得服务器套接字和听有反向连接从服务器。一个FTP客户端将使用一个sslserversocket“客户端”模式接受反向连接，FTP服务器使用SSLSocket“客户端”的发起连接的失效模式。由此产生的握手过程中，现有的SSL会话可以重复使用。
    
    SSLSockets返回accept()继承此设置。
    
    参数
    
    mode -如果新接受的连接应该使用SSL客户端模式。
    
    另请参见：
    
    getUseClientMode()
  - getUseClientMode
```
public abstract boolean getUseClientMode()
```
    如果接受连接将SSL客户端模式返回true。
    
    结果
    
    如果连接应该使用SSL客户端模式。
    
    另请参见：
    
    setUseClientMode(boolean)
  - setEnableSessionCreation
```
public abstract void setEnableSessionCreation(boolean flag)
```
    控制是否可以通过新的SSL会话，从这个服务器套接字创建套接字的建立。
    SSLSockets返回accept()继承此设置。
    
    参数
    
    flag真表明会话可能被创造；这是默认的。错误表示必须恢复现有会话。
    
    另请参见：
    
    getEnableSessionCreation()
  - getEnableSessionCreation
```
public abstract boolean getEnableSessionCreation()
```
    如果新的SSL会话可能是由从该服务器套接字创建套接字建立返回true。
    
    结果
    
    真的表明会话可能被创建，这是默认的。错误表示必须恢复现有会话
    
    另请参见：
    
    setEnableSessionCreation(boolean)
  - getSSLParameters
```
public SSLParameters getSSLParameters()
```
    返回新接受的连接效果的sslparameters。密码组和返回的sslparameters协议总是非空。
    
    结果
    
    对于新接受的连接效果的sslparameters
    
    从以下版本开始：
    
    一点七
    
    另请参见：
    
    setSSLParameters(SSLParameters)
  - setSSLParameters
```
public void setSSLParameters(SSLParameters params)
```
    适用于sslparameters新接受连接。
    这意味着：
    - 如果params.getCipherSuites()非空，setEnabledCipherSuites()叫做价值。
    - 如果params.getProtocols()非空，setEnabledProtocols()叫做价值。
    - 如果params.getNeedClientAuth()或params.getWantClientAuth()返回true，setNeedClientAuth(true)和setWantClientAuth(true)称，分别称为；否则setWantClientAuth(false)。
    - 如果params.getServerNames()是非空的，插座与价值配置的服务器名称。
    - 如果params.getSNIMatchers()是非空的，插座与价值配置SNI的匹配。
    参数
    
    params -参数
    
    异常
    
    IllegalArgumentException -如果setenabledciphersuites()或setenabledprotocols()调用失败
    
    从以下版本开始：
    
    一点七
    
    另请参见：
    
    getSSLParameters()

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 SSLServerSocket

构造方法摘要

方法摘要

Methods inherited from class java.net.ServerSocket

Methods inherited from class java.lang.Object

Constructor Detail

SSLServerSocket

SSLServerSocket

SSLServerSocket

SSLServerSocket

方法详细信息

getEnabledCipherSuites

setEnabledCipherSuites

getSupportedCipherSuites

getSupportedProtocols

getEnabledProtocols

setEnabledProtocols

setNeedClientAuth

getNeedClientAuth

setWantClientAuth

getWantClientAuth

setUseClientMode

getUseClientMode

setEnableSessionCreation

getEnableSessionCreation

getSSLParameters

setSSLParameters