Класс SctpChannel

Новый канал не привязан и не подключен.

Этот метод является методом удобства и эквивалентен оценке следующего выражения:

 open().connect(remote, maxOutStreams, maxInStreams);
 

Этот метод используется для установления связи между сокетом и локальными адресами. После установления связи сокет остается привязанным до тех пор, пока канал не будет закрыт. Эта связь необязательно должна быть с адресом local поскольку она может быть удалена с помощью unbindAddress, но всегда будет по крайней мере один локальный адрес привязанный к сокету канала после успешного выполнения вызова этого метода.

После того, как сокет канала успешно привязан к определенному адресу, который не назначается автоматически, к нему могут быть привязаны дополнительные адреса с помощью bindAddress, или удалены с помощью unbindAddress.

Указанный адрес не должен быть адресом wildcard. Канал должен быть сначала привязан с помощью bind перед вызовом этого метода, в противном случае будет брошено исключение NotYetBoundException. Метод bind принимает SocketAddress в качестве аргумента, который обычно содержит номер порта и адрес. Адреса, добавленные позже с помощью этого метода, являются просто адресами, так как номер порта SCTP остается неизменным на протяжении всего жизненного цикла канала.

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

Указанный адрес не должен быть адресом wildcard. Канал должен быть сначала привязан с помощью bind перед вызовом этого метода, в противном случае будет брошено исключение NotYetBoundException. Если этот метод вызывается для канала, у которого address не является одним из привязанных адресов, или у которого привязан только один локальный адрес, то этот метод генерирует исключение IllegalUnbindException. Изначальный адрес, к которому привязан сокет канала с помощью bind, может быть удалён из привязанных адресов для сокета канала.

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

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

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

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

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

Это вспомогательный метод, эквивалентный следующему выражению:

 setOption(SctpStandardSocketOptions.SCTP_INIT_MAXSTREAMS, SctpStandardSocketOption.InitMaxStreams.create(maxInStreams, maxOutStreams))
  .connect(remote);
 

Параметры maxOutStreams и maxInStreams представляют максимальное количество потоков, которое приложение хочет иметь возможность отправлять и получать. Они согласовываются с удалённым узлом и могут быть ограничены операционной системой.

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

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

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

Если канал подключён к удалённому узлу, который привязан к нескольким адресам, то именно эти адреса и подключены к сокету канала.

Отправляет команду закрытия удалённому узлу, фактически предотвращая отправку новых данных ни одному из узлов в сокет. Дальнейшие отправки выбросят исключение ClosedChannelException. Канал остаётся открытым, чтобы позволить получение любых данных (и уведомлений), которые могли быть отправлены узлом до того, как он получил команду закрытия. Если канал уже закрыт, вызов этого метода не оказывает никакого эффекта.

Этот метод будет продолжать возвращать набор параметров даже после закрытия канала.

Каналы SCTP поддерживают подключение, чтение и запись, поэтому этот метод возвращает (SelectionKey.OP_CONNECT | SelectionKey.OP_READ | SelectionKey.OP_WRITE).

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

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

Если этот метод получает уведомление, то вызывается соответствующий метод заданного обработчика, если он есть. Если обработчик возвращает CONTINUE, то этот метод попытается получить другое сообщение/уведомление, в противном случае, если возвращается RETURN, этот метод вернет null. Если обработчиком будет брошено необработанное исключение, оно будет передано вверх по стеку через этот метод.

Этот метод может быть вызван в любое время. Если другая нить уже инициировала операцию получения на этом канале, то вызов этого метода будет заблокирован до завершения первой операции. Заданный обработчик вызывается без удержания каких-либо блокировок, используемых для обеспечения указанной политики синхронизации, таким образом, обработчики не будут блокировать другие нити от получения. Обработчик не должен вызывать метод receive этого канала, в противном случае будет брошено IllegalReceiveException.

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

Сообщение передается из байтового буфера, как при обычной операции write.

Байты будут записаны в номер потока, указанный в streamNumber в данном messageInfo.

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