Класс AsynchronousSocketChannel

Новый канал создаётся путём вызова метода openAsynchronousSocketChannel у AsynchronousChannelProvider, который создал группу. Если параметр group равен null, то результирующий канал создаётся системным поставщиком по умолчанию и привязывается к группе по умолчанию.

Этот метод возвращает асинхронный сокет-канал, привязанный к группе по умолчанию. Этот метод эквивалентен выражению:

    open((AsynchronousChannelGroup)null);

Этот метод используется для установления связи между сокетом и локальным адресом. После установления связи сокет остаётся привязанным до закрытия канала. Если параметр local имеет значение null, то сокет будет привязан к автоматически назначенному адресу.

После закрытия для чтения все последующие чтения из канала вернут -1, индикатор конца потока. Если сторона входа подключения уже закрыта, вызов этого метода не оказывает никакого влияния. Влияние на незавершенную операцию чтения зависит от системы и поэтому не определено. Влияние, если таковое имеется, при наличии данных в буфере приема сокета, которые ещё не прочитаны, или данные приходят позже, также зависит от системы.

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

Если канал привязан и подключён к адресу сокета интернет-протокола, то возвращаемое значение этого метода имеет тип InetSocketAddress.

Этот метод инициирует операцию подключения этого канала. Параметр handler — обработчик завершения, который вызывается при успешном подключении или невозможности подключения. Если подключение невозможно, канал закрывается.

Этот метод выполняет точно те же проверки безопасности, что и класс Socket. То есть, если установлен менеджер безопасности, этот метод проверяет, разрешает ли его метод checkConnect подключение к адресу и номеру порта указанного удалённого конечного пункта.

Этот метод инициирует операцию подключения этого канала. Этот метод работает точно так же, как метод connect(SocketAddress, Object, CompletionHandler), за исключением того, что вместо указания обработчика завершения этот метод возвращает Future, представляющий ожидаемый результат. Метод get объекта Future возвращает null при успешном выполнении.

Этот метод инициирует асинхронную операцию чтения, чтобы прочитать последовательность байтов из этого канала в заданный буфер. Параметр handler — это обработчик завершения, который вызывается при завершении (или ошибке) операции чтения. Результат, передаваемый обработчику завершения, — это количество считанных байтов или -1, если байты не были прочитаны, потому что канал достиг конца потока.

Если задан таймаут, и таймаут истечёт до завершения операции, то операция завершается с исключением InterruptedByTimeoutException. В случае таймаута, если реализация не может гарантировать, что байты не были прочитаны или не будут прочитаны из канала в заданный буфер, то дальнейшие попытки чтения из канала приведут к генерации неопределённого исключения времени выполнения.

В противном случае этот метод работает аналогично методу AsynchronousByteChannel.read(ByteBuffer,Object,CompletionHandler).

Этот метод инициирует асинхронную операцию чтения, чтобы прочитать последовательность байтов из этого канала в заданный буфер. Параметр handler — это обработчик завершения, который вызывается при завершении (или ошибке) операции чтения. Результат, передаваемый обработчику завершения, — это количество считанных байтов или -1, если байты не были прочитаны, потому что канал достиг конца потока.

Операция чтения может прочитать до r байтов из канала, где r — количество оставшихся байтов в буфере, то есть dst.remaining() в момент попытки чтения. Если r равно 0, операция чтения завершается немедленно с результатом 0 без запуска операции ввода-вывода.

Предположим, что прочитана последовательность байтов длиной n, где 0 < n <= r. Эта последовательность байтов будет перенесена в буфер таким образом, что первый байт в последовательности будет находиться по индексу p, а последний байт — по индексу p + n - 1, где p — позиция буфера в момент выполнения чтения. После завершения позиция буфера будет равна p + n; его предел не изменится.

Буферы не являются потокобезопасными, поэтому следует быть осторожным, чтобы не обращаться к буферу до завершения операции.

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

Этот метод инициирует асинхронную операцию чтения, чтобы прочитать последовательность байтов из этого канала в заданный буфер. Метод работает точно так же, как метод read(ByteBuffer,Object,CompletionHandler), за исключением того, что вместо указания обработчика завершения этот метод возвращает Future , представляющий ожидаемый результат. Метод get Future возвращает количество прочитанных байтов или -1 , если байты не были прочитаны, потому что канал достиг конца потока.

Этот метод инициирует чтение до r байтов из этого канала, где r — общее количество оставшихся байтов в заданной подпоследовательности массива буферов, то есть

    dsts[offset].remaining()
        + dsts[offset+1].remaining()
        + ... + dsts[offset+length-1].remaining()

Предположим, что прочитана последовательность байтов длиной n, где 0 < n <= r. До первых dsts[offset].remaining() байтов этой последовательности переносятся в буфер dsts[offset], до следующих dsts[offset+1].remaining() байтов — в буфер dsts[offset+1], и так далее, пока вся последовательность байтов не будет перенесена в заданные буферы. В каждый буфер переносится как можно больше байтов, поэтому конечная позиция каждого обновлённого буфера, кроме последнего обновлённого буфера, гарантированно равна пределу этого буфера. Подлежащая операционная система может наложить ограничение на количество буферов, которые могут быть использованы в операции ввода-вывода. Если количество буферов (с оставшимися байтами) превышает это ограничение, то операция ввода-вывода выполняется с максимальным количеством буферов, разрешённым операционной системой.

Если задан таймаут, и таймаут истечёт до завершения операции, то она завершится с исключением InterruptedByTimeoutException. В случае таймаута, если реализация не может гарантировать, что байты не были прочитаны или не будут прочитаны из канала в заданные буферы, то дальнейшие попытки чтения из канала приведут к генерации неопределённого исключения времени выполнения.

Этот метод инициирует асинхронную операцию записи, чтобы записать последовательность байтов в этот канал из заданного буфера. Параметр handler — это обработчик завершения, который вызывается при завершении (или ошибке) операции записи. Результат, передаваемый обработчику завершения, — это количество записанных байтов.

Если задан таймаут и он истекает до завершения операции, то она завершается с исключением InterruptedByTimeoutException. В случае таймаута, когда реализация не может гарантировать, что байты не были записаны или не будут записаны в канал из заданного буфера, дальнейшие попытки записи в канал приведут к сбою со неопределённым исключением времени выполнения.

В противном случае этот метод работает так же, как и метод AsynchronousByteChannel.write(ByteBuffer,Object,CompletionHandler).

Этот метод инициирует асинхронную операцию записи, чтобы записать последовательность байтов в этот канал из заданного буфера. Параметр handler — это обработчик завершения, который вызывается при завершении (или ошибке) операции записи. Результат, передаваемый обработчику завершения, — это количество записанных байтов.

Операция записи может записать до r байтов в канал, где r — количество оставшихся байтов в буфере, то есть, src.remaining() в момент попытки записи. Если r равно 0, операция записи завершается немедленно с результатом 0 без инициирования операции ввода-вывода.

Предположим, что записана последовательность байтов длиной n, где 0 < n <= r. Эта последовательность байтов будет перенесена из буфера, начиная с индекса p, где p — позиция буфера в момент выполнения записи; индекс последнего записанного байта будет p + n - 1. После завершения позиция буфера будет равна p + n; его предел не изменится.

Буферы не безопасны для использования несколькими потоками одновременно, поэтому следует быть осторожными, чтобы не обращаться к буферу, пока операция не будет завершена.

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

Этот метод инициирует асинхронную операцию записи, чтобы записать последовательность байтов в этот канал из заданного буфера. Метод ведет себя точно так же, как метод write(ByteBuffer,Object,CompletionHandler) за исключением того, что вместо указания обработчика завершения этот метод возвращает Future представляющий ожидаемый результат. Метод get Future возвращает количество записанных байтов.

Этот метод инициирует запись до r байтов в этот канал, где r — общее количество оставшихся байтов в указанной подпоследовательности заданного массива буферов, то есть,

    srcs[offset].remaining()
        + srcs[offset+1].remaining()
        + ... + srcs[offset+length-1].remaining()

Предположим, что записана последовательность байтов длиной n, где 0 < n <= r. До первых srcs[offset].remaining() байтов этой последовательности записываются из буфера srcs[offset], до следующих srcs[offset+1].remaining() байтов записываются из буфера srcs[offset+1], и так далее, пока вся последовательность байтов не будет записана. Из каждого буфера записывается как можно больше байтов, поэтому окончательная позиция каждого обновленного буфера, за исключением последнего обновленного буфера, гарантированно равна пределу этого буфера. Подлежащая операционная система может наложить ограничение на количество буферов, которые могут использоваться в операции ввода-вывода. Если число буферов (с оставшимися байтами) превышает это ограничение, то операция ввода-вывода выполняется с максимальным количеством буферов, разрешенных операционной системой.

Если задан таймаут и он истекает до завершения операции, то она завершается с исключением InterruptedByTimeoutException. В случае таймаута, когда реализация не может гарантировать, что байты не были записаны или не будут записаны в канал из заданных буферов, дальнейшие попытки записи в канал приведут к сбою со неопределённым исключением времени выполнения.

Если канал bound к адресу сокета Интернет-протокола, то возвращаемое значение этого метода имеет тип InetSocketAddress.

Если установлен менеджер безопасности, его метод checkConnect вызывается с локальным адресом и -1 в качестве аргументов, чтобы проверить, разрешена ли операция. Если операция не разрешена, возвращается SocketAddress представляющий loopback адрес и локальный порт сокета канала.