Класс SctpMultiChannel

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

В возвращаемый набор ассоциаций включаются только те ассоциации, для которых было получено событие изменения ассоциации COMM_UP. Ассоциации, для которых было получено событие изменения ассоциации COMM_LOST или SHUTDOWN, удаляются из набора ассоциаций.

Возвращаемый набор ассоциаций представляет собой снимок открытых ассоциаций на момент вызова этого метода.

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

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

Параметр backlog задает максимальное количество ожидающих соединений на сокете. Его точная семантика зависит от реализации. Реализация может установить собственное максимальное значение или проигнорировать этот параметр. Если значение параметра backlog равно 0 или отрицательно, используется значение по умолчанию, определяемое реализацией.

Этот метод работает так, как если бы его вызов был эквивалентен вычислению выражения:

bind(local, 0);

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

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

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

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

Начальный адрес, к которому привязан сокет канала с помощью bind, можно удалить из числа адресов, привязанных к сокету канала.

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

Обратите внимание: некоторые параметры считываются для сокета канала, поэтому параметр association неприменим и будет проигнорирован, если он задан. Однако, если параметр относится к конкретной ассоциации, ассоциацию необходимо указать.

Обратите внимание: некоторые параметры считываются для сокета канала, поэтому параметр association неприменим и будет проигнорирован, если он задан. Однако, если параметр относится к конкретной ассоциации, ассоциацию необходимо указать.

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

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

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

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

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

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

Если этот канал не привязан, перед отправкой данных этот метод вызовет bind(null, 0).

Если между сокетом этого канала и предполагаемым получателем, определяемым адресом в указанном messageInfo, еще не существует ассоциации, она будет автоматически установлена с предполагаемым получателем. Это называется неявным установлением ассоциации. После успешного установления ассоциации в стек SCTP будет помещено уведомление association changed с параметром event, установленным в значение COMM_UP. Это уведомление можно получить, вызвав receive.

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

Если этот канал работает в неблокирующем режиме, в базовом выходном буфере достаточно места и требуется неявное установление ассоциации, оставшиеся байты указанного байтового буфера передаются как одно сообщение с учетом параметра SCTP_EXPLICIT_COMPLETE. Если по какой-либо причине сообщение не может быть доставлено, в стек SCTP помещается уведомление association changed с параметром event, установленным в значение CANT_START.

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

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

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

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