Класс AsynchronousSocketChannel

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

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

    open((AsynchronousChannelGroup)null);

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

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

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

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

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

Этот метод инициирует операцию подключения этого канала. Этот метод ведет себя точно так же, как метод 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.