Класс DatagramChannel

Новый канал создаётся путём вызова метода openDatagramChannel системного глобального объекта SelectorProvider. Канал не будет подключён.

ProtocolFamily сокета канала зависит от платформы (и, возможно, конфигурации), поэтому не определён. open позволяет выбрать семейство протоколов при открытии канала дейтаграмм и должен использоваться для открытия каналов дейтаграмм, предназначенных для многоадресной рассылки по протоколу Интернета.

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

Новый канал создаётся путём вызова метода openDatagramChannel системного глобального объекта SelectorProvider. Канал не будет подключён.

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

Этот метод используется для установления связи между сокетом и локальным адресом. После установления связи сокет остаётся привязанным до закрытия канала. Если параметр local имеет значение null , то сокет будет привязан к автоматически назначенному адресу.

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

Этот метод выполняет точно такие же проверки безопасности, что и метод connect класса DatagramSocket. То есть, если установлен менеджер безопасности, то этот метод проверяет, разрешает ли его метод checkAccept и checkConnect соответственно, приём дейтаграмм от и отправку дейтаграмм на указанный удалённый адрес. После подключения дальнейшие проверки безопасности для дейтаграмм, принятых от или отправленных на указанный удалённый адрес, не выполняются. Необходимо позаботиться о том, чтобы подключённый канал дейтаграмм не использовался совместно с недоверенным кодом.

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

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

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

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

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

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

Этот метод выполняет точно такие же проверки безопасности, как метод receive класса DatagramSocket. То есть, если сокет не подключён к определённому удалённому адресу и установлен менеджер безопасности, то для каждой принятой датаграммы этот метод проверяет, разрешены ли адрес и номер порта источника менеджером безопасности с помощью метода checkAccept. Датаграммы, которые не разрешены менеджером безопасности, отбрасываются. Надстройка этой проверки безопасности может быть избежана путём предварительного подключения сокета с помощью метода connect.

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

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

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

Этот метод выполняет точно такие же проверки безопасности, как метод send класса DatagramSocket. То есть, если сокет не подключён к определённому удалённому адресу и установлен менеджер безопасности, то для каждой отправленной датаграммы этот метод проверяет, разрешены ли целевой адрес и номер порта менеджером безопасности с помощью метода checkConnect. Надстройка этой проверки безопасности может быть избежана путём предварительного подключения сокета с помощью метода connect.

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

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

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

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

Этот метод можно вызывать только если сокет этого канала подключен, в этом случае он отправляет дейтаграммы непосредственно удалённому сокету. В противном случае он ведет себя точно так же, как и указано в интерфейсе WritableByteChannel.

Этот метод можно вызывать только если сокет этого канала подключен, в этом случае он отправляет дейтаграммы непосредственно удалённому сокету. В противном случае он ведет себя точно так же, как и указано в интерфейсе GatheringByteChannel.

Этот метод можно вызывать только если сокет этого канала подключен, в этом случае он отправляет дейтаграммы непосредственно удалённому сокету. В противном случае он ведет себя точно так же, как и указано в интерфейсе GatheringByteChannel.

Если канал bound к адресу сокета интернет-протокола, то возвращаемое значение этого метода имеет тип InetSocketAddress.

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