Класс 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. Если обработчик сгенерирует необработанное исключение, оно будет распространено вверх по стеку через этот метод.

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

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

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

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

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

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