Класс 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.

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