ServerSocket (Платформа Java SE 7)

java.lang. Объект
- java.net. ServerSocket

Все Реализованные Интерфейсы:

Closeable, AutoCloseable

Прямые Известные Подклассы:

SSLServerSocket
```
public class ServerSocket
extends Object
implements Closeable
```
Этот класс реализует сокеты сервера. Сокет сервера ожидает запросов, чтобы войти по сети. Это выполняет некоторую работу, основанную на том запросе, и затем возможно возвращает результат запрашивающей стороне.
Фактическая работа сокета сервера выполняется экземпляром SocketImpl класс. Приложение может изменить фабрику сокета, которая создает реализацию сокета, чтобы сконфигурировать себя, чтобы создать сокеты, соответствующие локальному брандмауэру.

С тех пор:

JDK1.0

См. Также:
SocketImpl, setSocketFactory(java.net.SocketImplFactory), ServerSocketChannel

Сводка конструктора

Конструкторы
Конструктор и Описание
`ServerSocket()` Создает несвязанный сокет сервера.
`ServerSocket(int port)` Создает сокет сервера, связанный с указанным портом.
`ServerSocket(int port, int backlog)` Создает сокет сервера и связывает это с указанным локальным номером порта, с указанным отставанием.
`ServerSocket(int port, int backlog, InetAddress bindAddr)` Создайте сервер с указанным портом, слушайте отставание, и локальный IP-адрес, чтобы связать с.

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`Сокет`	`accept()` Прислушивается к соединению, которое будет сделано к этому сокету, и принимает это.
`void`	`bind(SocketAddress endpoint)` Связывает `ServerSocket` к определенному адресу (IP-адрес и номер порта).
`void`	`bind(SocketAddress endpoint, int backlog)` Связывает `ServerSocket` к определенному адресу (IP-адрес и номер порта).
`void`	`close()` Завершения этот сокет.
`ServerSocketChannel`	`getChannel()` Возвращает уникальное `ServerSocketChannel` объект, связанный с этим сокетом, если любой.
`InetAddress`	`getInetAddress()` Возвращает локальный адрес этого сокета сервера.
`int`	`getLocalPort()` Возвращает номер порта, на котором слушает этот сокет.
`SocketAddress`	`getLocalSocketAddress()` Возвращает адрес конечной точки, этот сокет связывается с, или `null` если это еще не связывается.
`int`	`getReceiveBufferSize()` Получает значение опции SO_RCVBUF для этого `ServerSocket`, который является предложенным размером буфера, который будет использоваться для Сокетов, принятых от этого `ServerSocket`.
`boolean`	`getReuseAddress()` Тесты, если SO_REUSEADDR включается.
`int`	`getSoTimeout()` Получите установку для SO_TIMEOUT.
`protected void`	`implAccept(Socket s)` Подклассы ServerSocket используют этот метод, чтобы переопределить, принимают (), чтобы возвратить их собственный подкласс сокета.
`boolean`	`isBound()` Возвращает обязательное состояние ServerSocket.
`boolean`	`isClosed()` Возвращает закрытое состояние ServerSocket.
`void`	`setPerformancePreferences(int connectionTime, int latency, int bandwidth)` Предпочтение производительности наборов этому ServerSocket.
`void`	`setReceiveBufferSize(int size)` Устанавливает значение по умолчанию предложенное значение для опции SO_RCVBUF для сокетов, принятых от этого `ServerSocket`.
`void`	`setReuseAddress(boolean on)` Позвольте/отключите опции сокета SO_REUSEADDR.
`static void`	`setSocketFactory(SocketImplFactory fac)` Устанавливает фабрику реализации сокета сервера для приложения.
`void`	`setSoTimeout(int timeout)` Позвольте/отключите SO_TIMEOUT с указанным тайм-аутом в миллисекундах.
`Строка`	`toString()` Возвращает адрес реализации и порт реализации этого сокета как a `String`.

Методы java.lang унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Деталь конструктора
  - ServerSocket
```
public ServerSocket()
             throws IOException
```
    Создает несвязанный сокет сервера.
    
    Броски:
    
    IOException - Ошибка IO, открывая сокет.
  - ServerSocket
```
public ServerSocket(int port)
             throws IOException
```
    Создает сокет сервера, связанный с указанным портом. Номер порта 0 средства, что номер порта автоматически выделяется, обычно от эфемерного диапазона порта. Этот номер порта может тогда быть получен, вызывая getLocalPort.
    Максимальная длина очереди для входящих индикаций соединения (запрос, чтобы соединиться) устанавливается в 50. Если индикация соединения прибывает, когда очередь полна, соединению отказывают.
    Если приложение определило, что сервер снабжает фабрику сокетом, что фабрика createSocketImpl метод вызывают, чтобы создать фактическую реализацию сокета. Иначе "простой" сокет создается.
    Если есть менеджер безопасности, checkListen метод вызывают с port параметр как его параметр, чтобы гарантировать работу позволяется. Это могло привести к SecurityException.
    
    Параметры:
    port - номер порта, или 0 использовать номер порта, который автоматически выделяется.
    
    Броски:
    
    IOException - если ошибка ввода-вывода происходит, открывая сокет.
    
    SecurityException - если менеджер безопасности существует и checkListen метод не позволяет работу.
    
    IllegalArgumentException - если параметр порта вне указанного диапазона допустимых значений порта, который является между 0 и 65535, включительно.
    См. Также:
    SocketImpl, SocketImplFactory.createSocketImpl(), setSocketFactory(java.net.SocketImplFactory), SecurityManager.checkListen(int)
  - ServerSocket
```
public ServerSocket(int port,
            int backlog)
             throws IOException
```
    Создает сокет сервера и связывает это с указанным локальным номером порта, с указанным отставанием. Номер порта 0 средства, что номер порта автоматически выделяется, обычно от эфемерного диапазона порта. Этот номер порта может тогда быть получен, вызывая getLocalPort.
    Максимальная длина очереди для входящих индикаций соединения (запрос, чтобы соединиться) устанавливается в backlog параметр. Если индикация соединения прибывает, когда очередь полна, соединению отказывают.
    Если приложение определило, что сервер снабжает фабрику сокетом, что фабрика createSocketImpl метод вызывают, чтобы создать фактическую реализацию сокета. Иначе "простой" сокет создается.
    Если есть менеджер безопасности, checkListen метод вызывают с port параметр как его параметр, чтобы гарантировать работу позволяется. Это могло привести к SecurityException. backlog параметром является требуемое максимальное количество соединений на ожидании на сокете. Его точная семантика является определенной реализацией. В частности реализация может наложить максимальную длину или может хотеть игнорировать параметр altogther. Обеспеченное значение должно быть больше чем 0. Если это меньше чем или равно 0, тогда реализация определенное значение по умолчанию будет использоваться.
    
    Параметры:
    port - номер порта, или 0 использовать номер порта, который автоматически выделяется.
    backlog - требуемая максимальная длина очереди входящих соединений.
    
    Броски:
    
    IOException - если ошибка ввода-вывода происходит, открывая сокет.
    
    SecurityException - если менеджер безопасности существует и checkListen метод не позволяет работу.
    
    IllegalArgumentException - если параметр порта вне указанного диапазона допустимых значений порта, который является между 0 и 65535, включительно.
    См. Также:
    SocketImpl, SocketImplFactory.createSocketImpl(), setSocketFactory(java.net.SocketImplFactory), SecurityManager.checkListen(int)
  - ServerSocket
```
public ServerSocket(int port,
            int backlog,
            InetAddress bindAddr)
             throws IOException
```
    Создайте сервер с указанным портом, слушайте отставание, и локальный IP-адрес, чтобы связать с. bindAddr параметр может использоваться на многосетевом узле к ServerSocket, который только примет запросы подключения к одному из его адресов. Если bindAddr будет нулем, то он примет значение по умолчанию, принимая соединения на любых/всех локальных адресах. Порт должен быть между 0 и 65535, включительно. Номер порта 0 средства, что номер порта автоматически выделяется, обычно от эфемерного диапазона порта. Этот номер порта может тогда быть получен, вызывая getLocalPort.
    Если есть менеджер безопасности, это вызовы метода checkListen метод с port параметр как его параметр, чтобы гарантировать работу позволяется. Это могло привести к SecurityException. backlog параметром является требуемое максимальное количество соединений на ожидании на сокете. Его точная семантика является определенной реализацией. В частности реализация может наложить максимальную длину или может хотеть игнорировать параметр altogther. Обеспеченное значение должно быть больше чем 0. Если это меньше чем или равно 0, тогда реализация определенное значение по умолчанию будет использоваться.
    
    Параметры:
    port - номер порта, или 0 использовать номер порта, который автоматически выделяется.
    backlog - требуемая максимальная длина очереди входящих соединений.
    bindAddr - локальный InetAddress сервер свяжет с
    
    Броски:
    
    SecurityException - если менеджер безопасности существует и checkListen метод не позволяет работу.
    
    IOException - если ошибка ввода-вывода происходит, открывая сокет.
    
    IllegalArgumentException - если параметр порта вне указанного диапазона допустимых значений порта, который является между 0 и 65535, включительно.
    С тех пор:
    
    JDK1.1
    
    См. Также:
    SocketOptions, SocketImpl, SecurityManager.checkListen(int)
- Деталь метода
  - связать
```
public void bind(SocketAddress endpoint)
          throws IOException
```
    Связывает ServerSocket к определенному адресу (IP-адрес и номер порта).
    Если адрес null, тогда система поднимет эфемерный порт и допустимый локальный адрес, чтобы связать сокет.
    
    Параметры:
    endpoint - IP-адрес & номер порта, чтобы связать с.
    
    Броски:
    
    IOException - если связывать работа перестала работать, или если сокет уже связывается.
    
    SecurityException - если a SecurityManager присутствует и checkListen метод не позволяет работу.
    
    IllegalArgumentException - если конечная точка является подклассом SocketAddress, не поддерживаемым этим сокетом
    С тех пор:
    
    1.4
  - связать
```
public void bind(SocketAddress endpoint,
        int backlog)
          throws IOException
```
    Связывает ServerSocket к определенному адресу (IP-адрес и номер порта).
    Если адрес null, тогда система поднимет эфемерный порт и допустимый локальный адрес, чтобы связать сокет.
    backlog параметром является требуемое максимальное количество соединений на ожидании на сокете. Его точная семантика является определенной реализацией. В частности реализация может наложить максимальную длину или может хотеть игнорировать параметр altogther. Обеспеченное значение должно быть больше чем 0. Если это меньше чем или равно 0, тогда реализация определенное значение по умолчанию будет использоваться.
    
    Параметры:
    endpoint - IP-адрес & номер порта, чтобы связать с.
    backlog - требуемая максимальная длина очереди входящих соединений.
    
    Броски:
    
    IOException - если связывать работа перестала работать, или если сокет уже связывается.
    
    SecurityException - если a SecurityManager присутствует и checkListen метод не позволяет работу.
    
    IllegalArgumentException - если конечная точка является подклассом SocketAddress, не поддерживаемым этим сокетом
    С тех пор:
    
    1.4
  - getInetAddress
```
public InetAddress getInetAddress()
```
    Возвращает локальный адрес этого сокета сервера.
    Если сокет был связан до того, чтобы быть closed, тогда этот метод будет продолжать возвращать локальный адрес после того, как сокет будет закрыт.
    
    Возвраты:
    адрес, с которым этот сокет связывается, или null если сокет является несвязанным.
  - getLocalPort
```
public int getLocalPort()
```
    Возвращает номер порта, на котором слушает этот сокет.
    Если сокет был связан до того, чтобы быть closed, тогда этот метод будет продолжать возвращать номер порта после того, как сокет будет закрыт.
    
    Возвраты:
    номер порта, который этот сокет слушает или-1, если сокет еще не связывается.
  - getLocalSocketAddress
```
public SocketAddress getLocalSocketAddress()
```
    Возвращает адрес конечной точки, этот сокет связывается с, или null если это еще не связывается.
    Если сокет был связан до того, чтобы быть closed, тогда этот метод будет продолжать возвращать адрес конечной точки после того, как сокет будет закрыт.
    
    Возвраты:
    a SocketAddress представление локальной конечной точки этого сокета, или null если это еще не связывается.
    С тех пор:
    
    1.4
    
    См. Также:
    getInetAddress(), getLocalPort(), bind(SocketAddress)
  - принять
```
public Socket accept()
              throws IOException
```
    Прислушивается к соединению, которое будет сделано к этому сокету, и принимает это. Блоки метода до соединения делаются.
    Новый Сокет s создается и, если есть менеджер безопасности, менеджер безопасности checkAccept с методом вызывают s.getInetAddress().getHostAddress() и s.getPort() как его параметры, чтобы гарантировать работу позволяется. Это могло привести к SecurityException.
    
    Возвраты:
    новый Сокет
    
    Броски:
    
    IOException - если ошибка ввода-вывода происходит, ожидая соединения.
    
    SecurityException - если менеджер безопасности существует и checkAccept метод не позволяет работу.
    
    SocketTimeoutException - если тайм-аут был ранее установлен с setSoTimeout, и тайм-аут был достигнут.
    
    IllegalBlockingModeException - если у этого сокета есть связанный канал, канал находится в неблокировании режима, и нет никакого соединения, готового быть принятым
    См. Также:
    SecurityManager.checkAccept(java.lang.String, int)
  - implAccept
```
protected final void implAccept(Socket s)
                         throws IOException
```
    Подклассы ServerSocket используют этот метод, чтобы переопределить, принимают (), чтобы возвратить их собственный подкласс сокета. Таким образом, FooServerSocket будет обычно вручать этому методу пустой FooSocket. По возврату из implAccept FooSocket будет соединен с клиентом.
    
    Параметры:
    s - Сокет
    
    Броски:
    
    IllegalBlockingModeException - если у этого сокета есть связанный канал, и канал находится в неблокировании режима
    
    IOException - если ошибка ввода-вывода происходит, ожидая соединения.
    С тех пор:
    
    JDK1.1
  - близко
```
public void close()
           throws IOException
```
    Завершения этот сокет. Любой поток, в настоящий момент блокированный в accept() бросит a SocketException.
    Если у этого сокета есть связанный канал тогда, канал закрывается также.
    
    Определенный:
    
    close в интерфейсе Closeable
    
    Определенный:
    
    close в интерфейсе AutoCloseable
    
    Броски:
    
    IOException - если ошибка ввода-вывода происходит, закрывая сокет.
  - getChannel
```
public ServerSocketChannel getChannel()
```
    Возвращает уникальное ServerSocketChannel объект, связанный с этим сокетом, если любой.
    У сокета сервера будет канал, если, и только если, сам канал создавался через ServerSocketChannel.open метод.
    
    Возвраты:
    канал сокета сервера, связанный с этим сокетом, или null, если этот сокет не создавался для канала
    С тех пор:
    
    1.4
  - isBound
```
public boolean isBound()
```
    Возвращает обязательное состояние ServerSocket.
    
    Возвраты:
    истина, если ServerSocket succesfuly связанный с адресом
    С тех пор:
    
    1.4
  - isClosed
```
public boolean isClosed()
```
    Возвращает закрытое состояние ServerSocket.
    
    Возвраты:
    истина, если сокет был закрыт
    С тех пор:
    
    1.4
  - setSoTimeout
```
public void setSoTimeout(int timeout)
                  throws SocketException
```
    Позвольте/отключите SO_TIMEOUT с указанным тайм-аутом в миллисекундах. С этим набором опции к ненулевому тайм-ауту вызов, чтобы принять () для этого ServerSocket блокирует для только этого количества времени. Если тайм-аут истекает, java.net. SocketTimeoutException повышается, хотя ServerSocket все еще допустим. Опция должна быть включена до ввода работы блокирования, чтобы иметь эффект. Тайм-аут должен быть> 0. Тайм-аут нуля интерпретируется как бесконечный тайм-аут.
    
    Параметры:
    timeout - указанный тайм-аут, в миллисекундах
    
    Броски:
    
    SocketException - если есть ошибка в базовом протоколе, таком как ошибка TCP.
    С тех пор:
    
    JDK1.1
    
    См. Также:
    getSoTimeout()
  - getSoTimeout
```
public int getSoTimeout()
                 throws IOException
```
    Получите установку для SO_TIMEOUT. 0 возвратов подразумевают, что опция отключается (то есть, тайм-аут бесконечности).
    
    Возвраты:
    значение SO_TIMEOUT
    
    Броски:
    
    IOException - если ошибка ввода-вывода происходит
    С тех пор:
    
    JDK1.1
    
    См. Также:
    setSoTimeout(int)
  - setReuseAddress
```
public void setReuseAddress(boolean on)
                     throws SocketException
```
    Позвольте/отключите опции сокета SO_REUSEADDR.
    Когда соединение TCP закрывается, соединение может остаться в состоянии тайм-аута сроком на время после того, как соединение закрывается (обычно известный как состояние TIME_WAIT или состояние ожидания 2MSL). Для приложений, используя известный адрес сокета или порт, возможно, не возможно связать сокет с необходимым SocketAddress, если есть соединение в состоянии тайм-аута, включающем адрес сокета или порт.
    Включение SO_REUSEADDR до привязки использования сокета bind(SocketAddress) позволяет сокету быть связанным даже при том, что предыдущее соединение находится в состоянии тайм-аута.
    Когда ServerSocket создается, начальная установка SO_REUSEADDR не определяется. Приложения могут использовать getReuseAddress() определить начальную установку SO_REUSEADDR.
    Поведение, когда SO_REUSEADDR включается или отключается после сокета, связывается (См. isBound()) не определяется.
    
    Параметры:
    on - включить ли или отключить опцию сокета
    
    Броски:
    
    SocketException - если ошибка происходит, включая или отключая опцию сокета SO_RESUEADDR, или сокет закрывается.
    С тех пор:
    
    1.4
    
    См. Также:
    getReuseAddress(), bind(SocketAddress), isBound(), isClosed()
  - getReuseAddress
```
public boolean getReuseAddress()
                        throws SocketException
```
    Тесты, если SO_REUSEADDR включается.
    
    Возвраты:
    a boolean указание, включается ли SO_REUSEADDR.
    
    Броски:
    
    SocketException - если есть ошибка в базовом протоколе, таком как ошибка TCP.
    С тех пор:
    
    1.4
    
    См. Также:
    setReuseAddress(boolean)
  - toString
```
public String toString()
```
    Возвращает адрес реализации и порт реализации этого сокета как a String.
    
    Переопределения:
    
    toString в классе Object
    
    Возвраты:
    строковое представление этого сокета.
  - setSocketFactory
```
public static void setSocketFactory(SocketImplFactory fac)
                             throws IOException
```
    Устанавливает фабрику реализации сокета сервера для приложения. Фабрика может быть определена только однажды.
    Когда приложение создает новый сокет сервера, фабрика реализации сокета createSocketImpl метод вызывают, чтобы создать фактическую реализацию сокета.
    Передача null к методу не, если фабрика не была уже установлена.
    Если есть менеджер безопасности, этот метод первые вызовы менеджер безопасности checkSetFactory метод, чтобы гарантировать работу позволяется. Это могло привести к SecurityException.
    
    Параметры:
    fac - требуемая фабрика.
    
    Броски:
    
    IOException - если ошибка ввода-вывода происходит, устанавливая фабрику сокета.
    
    SocketException - если фабрика была уже определена.
    
    SecurityException - если менеджер безопасности существует и checkSetFactory метод не позволяет работу.
    См. Также:
    SocketImplFactory.createSocketImpl(), SecurityManager.checkSetFactory()
  - setReceiveBufferSize
```
public void setReceiveBufferSize(int size)
                          throws SocketException
```
    Устанавливает значение по умолчанию предложенное значение для опции SO_RCVBUF для сокетов, принятых от этого ServerSocket. Значение, фактически установленное в принятом сокете, должно быть определено, вызывая Socket.getReceiveBufferSize() после того, как сокет возвращается accept().
    Значение SO_RCVBUF используется и чтобы установить размер внутреннего сокета, получают буфер, и установить размер TCP получают окно, которое рекламируется к удаленной коллеге.
    Возможно изменить значение впоследствии, вызывая Socket.setReceiveBufferSize(int). Однако, если приложение хочет позволить получить окно, больше чем 64 K байтов, как определено RFC1323 тогда, предложенное значение должно быть установлено в ServerSocket прежде, чем это будет связано с локальным адресом. Это подразумевает, что ServerSocket должен быть создан с конструктором без параметров, тогда setReceiveBufferSize () должен быть вызван, и наконец ServerSocket связывается с адресом вызовом, связывают ().
    Отказ сделать это не будет вызывать ошибку, и размер буфера может быть установлен в требуемое значение, но TCP получают окно в сокетах, принятых от этого ServerSocket, будет не больше чем 64 K байтов.
    
    Параметры:
    size - размер, в который можно установить получить размер буфера. Это значение должно быть больше чем 0.
    
    Броски:
    
    SocketException - если есть ошибка в базовом протоколе, таком как ошибка TCP.
    
    IllegalArgumentException - если значение 0 или отрицательно.
    С тех пор:
    
    1.4
    
    См. Также:
    getReceiveBufferSize()
  - getReceiveBufferSize
```
public int getReceiveBufferSize()
                         throws SocketException
```
    Получает значение опции SO_RCVBUF для этого ServerSocket, который является предложенным размером буфера, который будет использоваться для Сокетов, принятых от этого ServerSocket.
    Отметьте, значение, фактически установленное в принятом сокете, определяется, вызывая Socket.getReceiveBufferSize().
    
    Возвраты:
    значение опции SO_RCVBUF для этого Socket.
    
    Броски:
    
    SocketException - если есть ошибка в базовом протоколе, таком как ошибка TCP.
    С тех пор:
    
    1.4
    
    См. Также:
    setReceiveBufferSize(int)
  - setPerformancePreferences
```
public void setPerformancePreferences(int connectionTime,
                             int latency,
                             int bandwidth)
```
    Предпочтение производительности наборов этому ServerSocket.
    Сокеты используют протокол TCP/IP по умолчанию. Некоторые реализации могут предложить альтернативные протоколы, у которых есть различные показатели производительности чем TCP/IP. Этот метод позволяет приложению выражать свое собственное предпочтение относительно того, как эти компромиссы должны быть сделаны, когда реализация выбирает из доступных протоколов.
    Предпочтение производительности описывается тремя целыми числами, значения которых указывают на относительную важность короткого времени соединения, низкой задержки, и высокой пропускной способности. Абсолютные значения целых чисел не важны; чтобы выбрать протокол, значения просто сравниваются с большими значениями, указывающими на более сильное предпочтение. Если приложение предпочитает короткое время соединения и по низкой задержке и по высокой пропускной способности, например, то это могло вызвать этот метод со значениями (1, 0, 0). Если приложение предпочитает высокую пропускную способность выше низкой задержки, и низкой задержки выше короткого времени соединения, то это могло вызвать этот метод со значениями (0, 1, 2).
    Вызывая этот метод после того, как этот сокет был связан, не будет иметь никакого эффекта. Это подразумевает, что, чтобы использовать эту возможность, требует, чтобы сокет был создан с конструктором без параметров.
    
    Параметры:
    connectionTime - int, выражающий относительную важность короткого времени соединения
    latency - int, выражающий относительную важность низкой задержки
    bandwidth - int, выражающий относительную важность высокой пропускной способности
    С тех пор:
    
    1.5

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс ServerSocket

Сводка конструктора

Сводка метода

Методы java.lang унаследованный от класса. Объект

Деталь конструктора

ServerSocket

ServerSocket

ServerSocket

ServerSocket

Деталь метода

связать

связать

getInetAddress

getLocalPort

getLocalSocketAddress

принять

implAccept

близко

getChannel

isBound

isClosed

setSoTimeout

getSoTimeout

setReuseAddress

getReuseAddress

toString

setSocketFactory

setReceiveBufferSize

getReceiveBufferSize

setPerformancePreferences