java.nio.channels

Класс ServerSocketChannel

java.lang. Объект

java.nio.channels.spi.AbstractInterruptibleChannel

java.nio.channels. SelectableChannel

java.nio.channels.spi.AbstractSelectableChannel

java.nio.channels. ServerSocketChannel

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

Closeable, AutoCloseable, Канал, InterruptibleChannel, NetworkChannel

public abstract class ServerSocketChannel
extends AbstractSelectableChannel
implements NetworkChannel

Выбираемый канал для потоковых сокетов слушания.

Канал сокета сервера создается, вызывая open метод этого класса. Не возможно создать канал для произвольного, существуя ранее ServerSocket. Недавно создаваемый канал сокета сервера открыт, но еще связан. Попытка вызвать accept метод несвязанного канала сокета сервера вызовет a NotYetBoundException быть брошенным. Канал сокета сервера может быть связан, вызывая один из bind методы определяются этим классом.

Опции сокета конфигурируются, используя setOption метод. Каналы сокета сервера поддерживают следующие опции:

Имя опции	Описание
SO_RCVBUF	Размер сокета получает буфер
SO_REUSEADDR	Адрес повторного использования

Дополнительный (определенная реализация) опции могут также поддерживаться.

Каналы сокета сервера безопасны для использования многократными параллельными потоками.

С тех пор:

1.4

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

Конструкторы

Модификатор	Конструктор и Описание
protected	ServerSocketChannel(SelectorProvider provider) Инициализирует новый экземпляр этого класса.

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

Методы

Модификатор и Тип	Метод и Описание
abstract SocketChannel	accept() Принимает соединение, сделанное к сокету этого канала.
ServerSocketChannel	bind(SocketAddress local) Связывает сокет канала с локальным адресом и конфигурирует сокет, чтобы прислушаться к соединениям.
abstract ServerSocketChannel	bind(SocketAddress local, int backlog) Связывает сокет канала с локальным адресом и конфигурирует сокет, чтобы прислушаться к соединениям.
static ServerSocketChannel	open() Открывает канал сокета сервера.
abstract <T> ServerSocketChannel	setOption(SocketOption<T> name, T value) Устанавливает значение опции сокета.
abstract ServerSocket	socket() Получает сокет сервера, связанный с этим каналом.
int	validOps() Возвращает набор работы, идентифицирующий поддерживаемые операции этого канала.

Методы, унаследованные от класса java.nio.channels.spi.AbstractSelectableChannel

blockingLock, configureBlocking, implCloseChannel, implCloseSelectableChannel, implConfigureBlocking, isBlocking, isRegistered, keyFor, provider, register

Методы java.nio.channels унаследованный от класса. SelectableChannel

регистр

Методы, унаследованные от класса java.nio.channels.spi.AbstractInterruptibleChannel

begin, close, end, isOpen

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Методы, наследованные от интерфейса java.nio.channels. NetworkChannel

getLocalAddress, getOption, supportedOptions

Методы, наследованные от интерфейса java.nio.channels. Канал

close, isOpen

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

ServerSocketChannel

protected ServerSocketChannel(SelectorProvider provider)

Инициализирует новый экземпляр этого класса.

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

открытый

public static ServerSocketChannel open()
                                throws IOException

Открывает канал сокета сервера.

Новый канал создается, вызывая openServerSocketChannel метод значения по умолчанию в масштабе всей системы SelectorProvider объект.

Сокет нового канала является первоначально несвязанным; это должно быть связано с определенным адресом через один из его сокета bind методы перед соединениями могут быть приняты.

Возвраты:

Новый канал сокета

Броски:

IOException - Если ошибка ввода-вывода происходит

validOps

public final int validOps()

Возвращает набор работы, идентифицирующий поддерживаемые операции этого канала.

Каналы сокета сервера только поддерживают принятие новых соединений, таким образом, этот метод возвращается SelectionKey.OP_ACCEPT.

Определенный:

validOps в классе SelectableChannel

Возвраты:

Допустимая работа устанавливается

связать

public final ServerSocketChannel bind(SocketAddress local)
                               throws IOException

Связывает сокет канала с локальным адресом и конфигурирует сокет, чтобы прислушаться к соединениям.

Вызов этого метода эквивалентен следующему:

 bind(local, 0);
 

Определенный:

bind в интерфейсе NetworkChannel

Параметры:

local - Локальный адрес, чтобы связать сокет, или null связывать с автоматически присвоенным адресом сокета

Возвраты:

Этот канал

Броски:

AlreadyBoundException - Если сокет уже связывается

UnsupportedAddressTypeException - Если тип данного адреса не поддерживается

ClosedChannelException - Если канал закрывается

IOException - Если некоторая другая ошибка ввода-вывода происходит

SecurityException - Если менеджер безопасности был установлен и checkListen метод отрицает работу

С тех пор:

1.7

См. Также:

NetworkChannel.getLocalAddress()

связать

public abstract ServerSocketChannel bind(SocketAddress local,
                       int backlog)
                                  throws IOException

Связывает сокет канала с локальным адресом и конфигурирует сокет, чтобы прислушаться к соединениям.

Этот метод используется, чтобы установить ассоциацию между сокетом и локальным адресом. Как только ассоциация устанавливается тогда, сокет остается связанным, пока канал не закрывается.

backlog параметр является максимальным количеством соединений на ожидании на сокете. Его точная семантика является определенной реализацией. В частности реализация может наложить максимальную длину или может хотеть игнорировать параметр altogther. Если backlog у параметра есть значение 0, или отрицательная величина, затем реализация определенное значение по умолчанию используется.

Параметры:

local - Адрес, чтобы связать сокет, или null связывать с автоматически присвоенным адресом сокета

backlog - Максимальное количество соединений на ожидании

Возвраты:

Этот канал

Броски:

AlreadyBoundException - Если сокет уже связывается

UnsupportedAddressTypeException - Если тип данного адреса не поддерживается

ClosedChannelException - Если этот канал закрывается

IOException - Если некоторая другая ошибка ввода-вывода происходит

SecurityException - Если менеджер безопасности был установлен и checkListen метод отрицает работу

С тех пор:

1.7

setOption

public abstract <T> ServerSocketChannel setOption(SocketOption<T> name,
                                T value)
                                       throws IOException

Описание скопировало с интерфейса: NetworkChannel

Устанавливает значение опции сокета.

Определенный:

setOption в интерфейсе NetworkChannel

Параметры:

name - Опция сокета

value - Значение опции сокета. Значение null может быть допустимое значение для некоторых опций сокета.

Возвраты:

Этот канал

Броски:

UnsupportedOperationException - Если опция сокета не поддерживается этим каналом

IllegalArgumentException - Если значение не является допустимым значением для этой опции сокета

ClosedChannelException - Если этот канал закрывается

IOException - Если ошибка ввода-вывода происходит

С тех пор:

1.7

См. Также:

StandardSocketOptions

сокет

public abstract ServerSocket socket()

Получает сокет сервера, связанный с этим каналом.

Возвращенный объект не будет объявлять открытых методов, которые не объявляются в ServerSocket класс.

Возвраты:

Сокет сервера связался с этим каналом

принять

public abstract SocketChannel accept()
                              throws IOException

Принимает соединение, сделанное к сокету этого канала.

Если этот канал будет в неблокировании режима тогда, то этот метод сразу возвратит null, если не будет никаких соединений на ожидании. Иначе это блокирует неопределенно, пока новое соединение не доступно, или ошибка ввода-вывода происходит.

Канал сокета, возвращенный этим методом, если таковые вообще имеются, будет в блокировании режима независимо от режима блокирования этого канала.

Этот метод выполняет точно те же самые проверки безопасности как accept метод ServerSocket класс. Таким образом, если менеджер безопасности был установлен тогда для каждого нового соединения, этот метод проверяет, что адрес и номер порта удаленной конечной точки соединения разрешаются менеджером безопасности checkAccept метод.

Возвраты:

Канал сокета для нового соединения, или null, если этот канал находится в неблокировании режима и никакого соединения, доступен, чтобы быть принятым

Броски:

ClosedChannelException - Если этот канал закрывается

AsynchronousCloseException - Если другой поток закрывает этот канал, в то время как принять работа происходит

ClosedByInterruptException - Если другой поток прерывает текущий поток, в то время как принять работа происходит, таким образом закрывая канал и устанавливая состояние прерывания текущего потока

NotYetBoundException - Если сокет этого канала еще не был связан

SecurityException - Если менеджер безопасности был установлен, и он не разрешает доступ к удаленной конечной точке нового соединения

IOException - Если некоторая другая ошибка ввода-вывода происходит