Класс SctpChannel

com.sun.nio.sctp.SctpChannel

Все реализуемые интерфейсы:: Closeable, AutoCloseable, Channel, InterruptibleChannel

public abstract class SctpChannel extends AbstractSelectableChannel

Выбираемый канал для сокетов SCTP, ориентированных на сообщения и подключенные.

Канал SCTP может контролировать только одну ассоциацию SCTP. SCTPChannel создается путем вызова одного из методов open этого класса. Недавно созданный канал открыт, но еще не подключен, то есть нет настройки ассоциации с удаленным узлом. Попытка вызвать операцию ввода-вывода на отключенном канале приведет к тому, что будет брошен NotYetConnectedException. Установку ассоциации можно выполнить, подключив канал с помощью одного из его методов connect. После подключения канал остается подключенным до тех пор, пока он не будет закрыт. Подключен ли канал или нет, можно определить, вызвав getRemoteAddresses.

Каналы SCTP поддерживают неблокирующее подключение: Канал может быть создан, и процесс установления связи с удаленным сокетом может быть инициирован с помощью метода connect для последующего завершения методом finishConnect. Процесс подключения в данный момент можно определить, вызвав метод isConnectionPending.

Параметры сокета настраиваются с помощью метода setOption. Канал SCTP поддерживает следующие параметры:

Параметры сокета

Имя параметра Описание

SCTP_DISABLE_FRAGMENTS Включает или отключает фрагментацию сообщений

SCTP_EXPLICIT_COMPLETE Включает или отключает явное завершение сообщений

SCTP_FRAGMENT_INTERLEAVE Управляет тем, как происходит представление сообщений для получателя сообщений

SCTP_INIT_MAXSTREAMS Максимальное количество потоков, запрошенное локальным конечным устройством во время инициализации ассоциации

SCTP_NODELAY Включает или отключает алгоритм, похожий на Nagle

SCTP_PRIMARY_ADDR Запрашивает, чтобы локальный стек SCTP использовал указанный адрес узла в качестве первичного для ассоциации

SCTP_SET_PEER_PRIMARY_ADDR Запрашивает, чтобы узел пометил заключенный адрес как первичный для ассоциации

SO_SNDBUF Размер буфера отправки сокета

SO_RCVBUF Размер буфера приема сокета

SO_LINGER Задержка при закрытии, если данные присутствуют (только при настройке в режиме блокировки)

Параметры сокета
Имя параметра	Описание
`SCTP_DISABLE_FRAGMENTS`	Включает или отключает фрагментацию сообщений
`SCTP_EXPLICIT_COMPLETE`	Включает или отключает явное завершение сообщений
`SCTP_FRAGMENT_INTERLEAVE`	Управляет тем, как происходит представление сообщений для получателя сообщений
`SCTP_INIT_MAXSTREAMS`	Максимальное количество потоков, запрошенное локальным конечным устройством во время инициализации ассоциации
`SCTP_NODELAY`	Включает или отключает алгоритм, похожий на Nagle
`SCTP_PRIMARY_ADDR`	Запрашивает, чтобы локальный стек SCTP использовал указанный адрес узла в качестве первичного для ассоциации
`SCTP_SET_PEER_PRIMARY_ADDR`	Запрашивает, чтобы узел пометил заключенный адрес как первичный для ассоциации
`SO_SNDBUF`	Размер буфера отправки сокета
`SO_RCVBUF`	Размер буфера приема сокета
`SO_LINGER`	Задержка при закрытии, если данные присутствуют (только при настройке в режиме блокировки)

Дополнительные (специфичные для реализации) параметры также могут быть поддерживаемы. Список поддерживаемых параметров можно получить, вызвав метод supportedOptions.

Каналы SCTP безопасны для использования несколькими потоками одновременно. Они поддерживают одновременный чтение и запись, хотя в любой момент времени может быть только один поток на чтение и один поток на запись. Методы connect и finishConnect взаимно синхронизированы, и попытка инициировать операцию отправки или приема в то время, когда один из этих методов выполняется, приведет к блокировке, пока этот вызов не будет завершен.

С тех пор как:: 1.7

Краткое описание конструкторов

SctpChannel(SelectorProvider provider)

Модификатор	Конструктор	Описание
`protected`	Инициализирует новый экземпляр этого класса.

Краткое описание методов

Модификатор и тип	Метод	Описание
`abstract Association`	`association()`	Возвращает ассоциацию на сокете этого канала.
`abstract SctpChannel`	`bind(SocketAddress local)`	Связывает сокет канала с локальным адресом.
`abstract SctpChannel`	`bindAddress(InetAddress address)`	Добавляет указанный адрес к связанным адресам для сокета канала.
`abstract boolean`	`connect(SocketAddress remote)`	Подключает сокет этого канала.
`abstract boolean`	`connect(SocketAddress remote, int maxOutStreams, int maxInStreams)`	Подключает сокет этого канала.
`abstract boolean`	`finishConnect()`	Завершает процесс подключения канала SCTP.
`abstract Set<SocketAddress>`	`getAllLocalAddresses()`	Возвращает все адреса сокета, к которым подключен сокет этого канала.
`abstract <T> T`	`getOption(SctpSocketOption<T> name)`	Возвращает значение параметра сокета.
`abstract Set<SocketAddress>`	`getRemoteAddresses()`	Возвращает все удаленные адреса, к которым подключен сокет этого канала.
`abstract boolean`	`isConnectionPending()`	Указывает, идет ли в настоящее время операция подключения на этом канале.
`static SctpChannel`	`open()`	Открывает канал SCTP.
`static SctpChannel`	`open(SocketAddress remote, int maxOutStreams, int maxInStreams)`	Открывает канал SCTP и подключает его к удаленному адресу.
`abstract <T> MessageInfo`	`receive(ByteBuffer dst, T attachment, NotificationHandler<T> handler)`	Принимает сообщение в указанный буфер и/или обрабатывает уведомление.
`abstract int`	`send(ByteBuffer src, MessageInfo messageInfo)`	Отправляет сообщение через этот канал.
`abstract <T> SctpChannel`	`setOption(SctpSocketOption<T> name, T value)`	Устанавливает значение параметра сокета.
`abstract SctpChannel`	`shutdown()`	Закрывает подключение без закрытия канала.
`abstract Set<SctpSocketOption<?>>`	`supportedOptions()`	Возвращает набор параметров сокета, поддерживаемых этим каналом.
`abstract SctpChannel`	`unbindAddress(InetAddress address)`	Удаляет указанный адрес из связанных адресов для сокета канала.
`final int`	`validOps()`	Возвращает набор операций, идентифицирующий поддерживаемые операции этого канала.

Методы, объявленные в классе java.nio.channels.spi.AbstractSelectableChannel

blockingLock, configureBlocking, implCloseChannel, implCloseSelectableChannel, implConfigureBlocking, isBlocking, isRegistered, keyFor, provider, register

Методы, объявленные в классе java.nio.channels.SelectableChannel

register

Методы, объявленные в классе java.nio.channels.spi.AbstractInterruptibleChannel

begin, close, end, isOpen

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Методы, объявленные в интерфейсе java.nio.channels.Channel

isOpen

Подробное описание конструкторов

SctpChannel

protected SctpChannel(SelectorProvider provider)

Инициализирует новый экземпляр этого класса.

Параметры:: provider - поставщик селектора для этого канала

Подробное описание методов

open

public static SctpChannel open() throws IOException

Открывает SCTP канал.

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

Возвращает:: Новый SCTP канал
Исключения:: UnsupportedOperationException - Если протокол SCTP не поддерживается; IOException - Если произошла ошибка ввода-вывода

open

public static SctpChannel open(SocketAddress remote, int maxOutStreams, int maxInStreams) throws IOException

Открывает SCTP канал и подключает его к удалённому адресу.

Это удобный метод, эквивалентный следующему выражению:

 open().connect(remote, maxOutStreams, maxInStreams);

Параметры:: remote - удалённый адрес, к которому должен быть подключен новый канал; maxOutStreams - количество потоков, которые приложение хочет отправлять. Должно быть неотрицательным и не больше 65536. 0 для использования значения по умолчанию конечной точки.; maxInStreams - максимальное количество входящих потоков, которые приложение готово поддерживать. Должно быть неотрицательным и не больше 65536. 0 для использования значения по умолчанию конечной точки.
Возвращает:: Новый SCTP канал, подключенный к заданному адресу
Исключения:: AsynchronousCloseException - Если другой поток закрывает этот канал во время операции подключения; ClosedByInterruptException - Если другой поток прерывает текущий поток во время операции подключения, тем самым закрывая канал и устанавливая статус прерывания текущего потока; UnresolvedAddressException - Если заданный удалённый адрес не полностью разрешен; UnsupportedAddressTypeException - Если тип заданного удалённого адреса не поддерживается; UnsupportedOperationException - Если протокол SCTP не поддерживается; IOException - Если произошла другая ошибка ввода-вывода

association

public abstract Association association() throws IOException

Возвращает ассоциацию для сокета этого канала.

Возвращает:: ассоциацию или null, если сокет канала не подключён.
Исключения:: ClosedChannelException - Если канал закрыт; IOException - Если произошла другая ошибка ввода-вывода

bind

public abstract SctpChannel bind(SocketAddress local) throws IOException

Привязывает сокет канала к локальному адресу.

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

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

Параметры:: local - локальный адрес для привязки сокета или null для привязки сокета к автоматически назначенному адресу сокета
Возвращает:: Этот канал
Исключения:: AlreadyConnectedException - Если этот канал уже подключён; ClosedChannelException - Если этот канал закрыт; ConnectionPendingException - Если в этом канале уже выполняется операция подключения в неблокирующем режиме; AlreadyBoundException - Если этот канал уже привязан; UnsupportedAddressTypeException - Если тип заданного адреса не поддерживается; IOException - Если произошла другая ошибка ввода-вывода

bindAddress

public abstract SctpChannel bindAddress(InetAddress address) throws IOException

Добавляет указанный адрес к привязанным адресам для сокета канала.

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

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

Параметры:: address - адрес для добавления к привязанным адресам сокета
Возвращает:: Этот канал
Исключения:: ClosedChannelException - Если этот канал закрыт; ConnectionPendingException - Если в этом канале уже выполняется операция подключения в неблокирующем режиме; NotYetBoundException - Если этот канал ещё не привязан; AlreadyBoundException - Если этот канал уже привязан к указанному адресу; IllegalArgumentException - Если адрес является null или адресом wildcard; IOException - Если произошла другая ошибка ввода-вывода

unbindAddress

public abstract SctpChannel unbindAddress(InetAddress address) throws IOException

Удаляет заданный адрес из привязанных адресов для сокета канала.

Заданный адрес не должен быть адресом wildcard. Канал должен быть сначала привязан с помощью bind перед вызовом этого метода, в противном случае выбрасывается NotYetBoundException. Если этот метод вызван для канала, у которого address не является одним из привязанных адресов, или у которого привязан только один локальный адрес, то этот метод выбрасывает IllegalUnbindException. Изначальный адрес, к которому привязан сокет канала с помощью bind, может быть удалён из привязанных адресов сокета канала.

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

Параметры:: address - адрес для удаления из привязанных адресов сокета
Возвращает:: Этот канал
Исключения:: ClosedChannelException - Если этот канал закрыт; ConnectionPendingException - Если в этом канале уже выполняется операция подключения в неблокирующем режиме; NotYetBoundException - Если этот канал ещё не привязан; IllegalArgumentException - Если адрес является null или адресом wildcard; IllegalUnbindException - Если address не привязан к сокету канала или канал имеет только один привязанный адрес; IOException - Если произошла другая ошибка ввода-вывода

connect

public abstract boolean connect(SocketAddress remote) throws IOException

Подключает сокет этого канала.

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

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

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

Parameters:: remote - Удаленный узел, к которому должен быть подключен этот канал
Returns:: true, если подключение было установлено, false, если этот канал находится в режиме без ожидания, и операция подключения находится в процессе выполнения
Throws:: AlreadyConnectedException - Если этот канал уже подключен; ConnectionPendingException - Если операция подключения без ожидания уже выполняется на этом канале; ClosedChannelException - Если этот канал закрыт; AsynchronousCloseException - Если другой поток закрывает этот канал во время операции подключения; ClosedByInterruptException - Если другой поток прерывает текущий поток во время операции подключения, тем самым закрывая канал и устанавливая флаг прерывания текущего потока; UnresolvedAddressException - Если заданный удалённый адрес не полностью разрешен; UnsupportedAddressTypeException - Если тип заданного удалённого адреса не поддерживается; IOException - Если произошла какая-либо другая ошибка ввода-вывода

connect

public abstract boolean connect(SocketAddress remote, int maxOutStreams, int maxInStreams) throws IOException

Подключает сокет этого канала.

Это вспомогательный метод, эквивалентный вычислению следующего выражения:

 setOption(SctpStandardSocketOptions.SCTP_INIT_MAXSTREAMS, SctpStandardSocketOption.InitMaxStreams.create(maxInStreams, maxOutStreams))
  .connect(remote);

Параметры maxOutStreams и maxInStreams представляют максимальное количество потоков, которое приложение хочет иметь возможность отправлять и получать. Они согласовываются с удалённым узлом и могут быть ограничены операционной системой.

Parameters:: remote - Удаленный узел, к которому должен быть подключен этот канал; maxOutStreams - Должен быть неотрицательным и не больше 65536. 0 для использования значения по умолчанию конечной точки.; maxInStreams - Должен быть неотрицательным и не больше 65536. 0 для использования значения по умолчанию конечной точки.
Returns:: true, если подключение было установлено, false, если этот канал находится в режиме без ожидания, и операция подключения находится в процессе выполнения
Throws:: AlreadyConnectedException - Если этот канал уже подключен; ConnectionPendingException - Если операция подключения без ожидания уже выполняется на этом канале; ClosedChannelException - Если этот канал закрыт; AsynchronousCloseException - Если другой поток закрывает этот канал во время операции подключения; ClosedByInterruptException - Если другой поток прерывает текущий поток во время операции подключения, тем самым закрывая канал и устанавливая флаг прерывания текущего потока; UnresolvedAddressException - Если заданный удалённый адрес не полностью разрешен; UnsupportedAddressTypeException - Если тип заданного удалённого адреса не поддерживается; IOException - Если произошла какая-либо другая ошибка ввода-вывода

isConnectionPending

public abstract boolean isConnectionPending()

Указывает, выполняется ли операция подключения на этом канале.

Returns:: true, если и только если операция подключения была инициирована на этом канале, но ещё не завершена вызовом метода finishConnect()

finishConnect

public abstract boolean finishConnect() throws IOException

Завершает процесс подключения канала SCTP.

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

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

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

Returns:: true, если сокет этого канала теперь подключён
Throws:: NoConnectionPendingException - Если этот канал не подключён и операция подключения не была инициирована; ClosedChannelException - Если этот канал закрыт; AsynchronousCloseException - Если другой поток закрывает этот канал во время операции подключения; ClosedByInterruptException - Если другой поток прерывает текущий поток во время операции подключения, тем самым закрывая канал и устанавливая флаг прерывания текущего потока; IOException - Если произошла какая-либо другая ошибка ввода-вывода

getAllLocalAddresses

public abstract Set<SocketAddress> getAllLocalAddresses() throws IOException

Возвращает все адреса сокетов, к которым подключён сокет этого канала.

Returns:: Все адреса сокетов, к которым подключён сокет этого канала, или пустой Set, если сокет канала не подключён
Throws:: ClosedChannelException - Если канал закрыт; IOException - Если произошла ошибка ввода-вывода

getRemoteAddresses

public abstract Set<SocketAddress> getRemoteAddresses() throws IOException

Возвращает все удалённые адреса, к которым подключён сокет этого канала.

Если канал подключён к удалённому узлу, привязанному к нескольким адресам, то это эти адреса, к которым подключён сокет канала.

Returns:: Все удалённые адреса, к которым подключён сокет этого канала, или пустой Set, если сокет канала не подключён
Throws:: ClosedChannelException - Если канал закрыт; IOException - Если произошла ошибка ввода-вывода

shutdown

public abstract SctpChannel shutdown() throws IOException

Отключает подключение без закрытия канала.

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

Returns:: Этот канал
Throws:: NotYetConnectedException - Если этот канал ещё не подключен; ClosedChannelException - Если этот канал закрыт; IOException - Если произошла какая-либо другая ошибка ввода-вывода

getOption

public abstract <T> T getOption(SctpSocketOption<T> name) throws IOException

Возвращает значение параметра сокета.

Type Parameters:

T - Тип значения параметра сокета

Parameters:

name - Параметр сокета

Returns:

Значение параметра сокета. Значение null может быть допустимым значением для некоторых параметров сокета.

Throws:

UnsupportedOperationException - Если параметр сокета не поддерживается этим каналом

ClosedChannelException - Если этот канал закрыт

IOException - Если произошла ошибка ввода-вывода

See Also:

setOption

public abstract <T> SctpChannel setOption(SctpSocketOption<T> name, T value) throws IOException

Устанавливает значение параметра сокета.

Type Parameters:

T - Тип значения параметра сокета

Parameters:

name - Параметр сокета

value - Значение параметра сокета. Значение null может быть допустимым для некоторых параметров сокета.

Returns:

Этот канал

Throws:

UnsupportedOperationException - Если параметр сокета не поддерживается этим каналом

IllegalArgumentException - Если значение не является допустимым значением для этого параметра сокета

ClosedChannelException - Если этот канал закрыт

IOException - Если произошла ошибка ввода-вывода

See Also:

supportedOptions

public abstract Set<SctpSocketOption<?>> supportedOptions()

Возвращает набор параметров сокета, поддерживаемых этим каналом.

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

Returns:: Набор параметров сокета, поддерживаемых этим каналом

validOps

public final int validOps()

Возвращает набор операций, определяющий поддерживаемые этим каналом операции.

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

Specified by:: validOps в классе SelectableChannel
Returns:: Набор допустимых операций

receive

public abstract <T> MessageInfo receive(ByteBuffer dst, T attachment, NotificationHandler<T> handler) throws IOException

Принимает сообщение в заданный буфер и/или обрабатывает уведомление.

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

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

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

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

Type Parameters:: T - Тип вложения
Parameters:: dst - Буфер, в который будут передаваться байты сообщения; attachment - Объект, который нужно прикрепить к операции приема; может быть null; handler - Обработчик для обработки уведомлений от стека SCTP, или null для игнорирования любых уведомлений.
Returns:: MessageInfo, null если этот канал в режиме без блокировки и сообщения недоступны сразу или обработчик уведомлений возвращает RETURN после обработки уведомления
Throws:: ClosedChannelException - Если этот канал закрыт; AsynchronousCloseException - Если другой поток закрывает этот канал во время операции чтения; ClosedByInterruptException - Если другой поток прерывает текущий поток во время операции чтения, закрывая канал и устанавливая статус прерывания текущего потока; NotYetConnectedException - Если этот канал еще не подключен; IllegalReceiveException - Если заданный обработчик вызывает метод receive этого канала; IOException - Если произошла какая-либо другая ошибка ввода-вывода

send

public abstract int send(ByteBuffer src, MessageInfo messageInfo) throws IOException

Отправляет сообщение через этот канал.

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

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

Байты будут записаны в номер потока, который указан в streamNumber в заданном messageInfo.

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

Parameters:: src - Буфер, содержащий отправляемое сообщение; messageInfo - Дополнительные данные о отправляемом сообщении
Returns:: Количество отправленных байт, которое будет равно либо количеству оставшихся байтов в буфере сообщения, когда этот метод был вызван, либо, если этот канал неблокирующий, может быть равно нулю, если в базовом буфере вывода не было достаточно места для сообщения
Throws:: InvalidStreamException - Если streamNumner отрицательное или больше или равно максимальному числу исходящих потоков; ClosedChannelException - Если этот канал закрыт; AsynchronousCloseException - Если другой поток закрывает этот канал во время операции чтения; ClosedByInterruptException - Если другой поток прерывает текущий поток во время операции чтения, закрывая канал и устанавливая статус прерывания текущего потока; NotYetConnectedException - Если этот канал еще не подключен; IOException - Если произошла какая-либо другая ошибка ввода-вывода

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/jdk.sctp/com/sun/nio/sctp/SctpChannel.html