Класс AsynchronousServerSocketChannel

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

Асинхронный серверный сокет-канал создаётся путём вызова метода open этого класса. Новый асинхронный серверный сокет-канал открыт, но ещё не привязан. Он может быть привязан к локальному адресу и настроен на прослушивание подключений путём вызова метода bind. После привязки метод accept используется для инициирования процесса принятия подключений к сокету канала. Попытка вызвать метод accept на несвязанном канале приведёт к исключению NotYetBoundException.

Каналы этого типа безопасны для использования в нескольких потоках, хотя одновременно может быть не более одного запроса на принятие подключения. Если поток инициирует операцию принятия подключения до завершения предыдущей операции принятия подключения, будет брошено исключение AcceptPendingException.

Параметры сокета настраиваются с помощью метода setOption. Каналы этого типа поддерживают следующие параметры:

Пример использования:

final AsynchronousServerSocketChannel listener =
      AsynchronousServerSocketChannel.open().bind(new InetSocketAddress(5000));

  listener.accept(null, new CompletionHandler<AsynchronousSocketChannel,Void>() {
      public void completed(AsynchronousSocketChannel ch, Void att) {
          // accept the next connection
          listener.accept(null, this);

          // handle this connection
          handle(ch);
      }
      public void failed(Throwable exc, Void att) {
          ...
      }
  });

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

AsynchronousServerSocketChannel

protected AsynchronousServerSocketChannel(AsynchronousChannelProvider provider)

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

Параметры:

provider - Предоставщик, который создал этот канал

Методы

provider

public final AsynchronousChannelProvider provider()

Возвращает предоставителя, который создал этот канал.

Возвращает:

Предоставщик, который создал этот канал

open

public static AsynchronousServerSocketChannel open(AsynchronousChannelGroup group)
                                            throws IOException

Параметры:

group - Группа, к которой должен быть привязан вновь созданный канал, или null для группы по умолчанию

Возвращает:

Новый асинхронный серверный сокет-канал

Исключения:

ShutdownChannelGroupException - Если группа каналов закрыта

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

open

public static AsynchronousServerSocketChannel open()
                                            throws IOException

open((AsynchronousChannelGroup)null);

Возвращает:

Новый асинхронный серверный сокет-канал

Исключения:

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

bind

public final AsynchronousServerSocketChannel bind(SocketAddress local)
                                           throws IOException

bind(local, 0);

Указано в:

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

Параметры:

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

Возвращает:

Этот канал

Исключения:

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

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

SecurityException - Если установлен менеджер безопасности и он отклоняет неопределённое разрешение. Реализация этого интерфейса должна указать все необходимые разрешения.

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

IOException - Если произошла другая ошибка ввода-вывода

См. также:

NetworkChannel.getLocalAddress()

bind

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

Параметры:

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

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

Возвращает:

Этот канал

Исключения:

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

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

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

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

IOException - Если произошла другая ошибка ввода-вывода

setOption

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

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

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

Указано в:

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

Параметры типа:

T - Тип значения параметра сокета

Параметры:

name - Параметр сокета

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

Возвращает:

Этот канал

Исключения:

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

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

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

См. также:

StandardSocketOptions

accept

public abstract <A> void accept(A attachment,
                                CompletionHandler<AsynchronousSocketChannel,? super A> handler)

Параметры типа:

A - Тип прикрепления

Параметры:

attachment - Объект для прикрепления к операции ввода-вывода; может быть null

handler - Обработчик для обработки результата

Исключения:

AcceptPendingException - Если на этом канале уже происходит операция accept

NotYetBoundException - Если сокет этого канала ещё не привязан

ShutdownChannelGroupException - Если группа каналов закрыта

accept

public abstract Future<AsynchronousSocketChannel> accept()

Возвращает:

объект Future , представляющий ожидаемый результат

Исключения:

AcceptPendingException - Если на этом канале уже происходит операция accept

NotYetBoundException - Если сокет этого канала ещё не привязан

getLocalAddress

public abstract SocketAddress getLocalAddress()
                                       throws IOException

Указано в:

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

Возвращает:

SocketAddress , к которому привязан сокет, или SocketAddress , представляющий обратный адрес, если доступ запрещён менеджером безопасности, или null , если сокет канала не привязан

Исключения:

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

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