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

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

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