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