Класс AsynchronousSocketChannel

Новый канал создается путем вызова метода openAsynchronousSocketChannel у AsynchronousChannelProvider, создавшего группу. Если параметр группы равен 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 к адресу сокета Internet Protocol, возвращаемое этим методом значение имеет тип InetSocketAddress.