Класс 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, нет установленного соединения, то оно будет автоматически установлено с предполагаемым получателем. Это считается неявным установлением соединения. После успешного установления соединения уведомление association changed будет помещено в стек SCTP с параметром event, установленным на COMM_UP. Это уведомление можно получить, вызвав receive.

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

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

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

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

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

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