Интерфейс MulticastChannel

public interface MulticastChannel
extends NetworkChannel

Сеть канал, поддерживающий многоадресную рассылку по протоколу Internet Protocol (IP).

Многоадресная рассылка IP — это передача IP-датаграмм членам группы, которая включает ноль или более хостов, идентифицируемых по одному адресу назначения.

В случае канала на сокет IPv4 операционная система поддерживает RFC 2236: Протокол управления группами в Интернете, версия 2 (IGMPv2). Она может дополнительно поддерживать фильтрацию источников, как указано в RFC 3376: Протокол управления группами в Интернете, версия 3 (IGMPv3). Для каналов на сокет IPv6 соответствующие стандарты — RFC 2710: Открытие многоадресных слушателей (MLD) для IPv6 и RFC 3810: Открытие многоадресных слушателей версии 2 (MLDv2) для IPv6.

Метод join(InetAddress,NetworkInterface) используется для присоединения к группе и получения всех многоадресных датаграмм, отправленных в эту группу. Канал может присоединяться к нескольким многоадресным группам и может присоединяться к одной и той же группе на нескольких interfaces. Членство аннулируется вызовом метода drop возвращённого MembershipKey. Если платформа поддерживает фильтрацию источников, то можно использовать методы block и unblock для блокировки или разблокировки многоадресных датаграмм от определённых адресов источника.

Метод join(InetAddress,NetworkInterface,InetAddress) используется для начала получения датаграмм, отправленных в группу, адрес источника которой совпадает с заданным адресом источника. Этот метод выбрасывает UnsupportedOperationException, если платформа не поддерживает фильтрацию источников. Членство кумулятивное, и этот метод можно вызывать снова с той же группой и интерфейсом, чтобы разрешить получение датаграмм от других адресов источника. Метод возвращает MembershipKey, который представляет членство для получения датаграмм от указанного адреса источника. Вызов метода ключа drop аннулирует членство, так что датаграммы от адреса источника больше не будут получаться.

Зависимости от платформы

Реализация многоадресной рассылки предназначена для прямого отображения на средства многоадресной рассылки нативной платформы. Следовательно, при разработке приложения, получающего IP-многоадресные датаграммы, следует учитывать следующие моменты:

1. Создание канала должно указывать ProtocolFamily, соответствующий типу адреса многоадресных групп, к которым будет присоединяться канал. Нет гарантии, что канал на сокете одного семейства протоколов сможет присоединиться и получить многоадресные датаграммы, если адрес многоадресной группы соответствует другому семейству протоколов. Например, если канал на сокет IPv6 может присоединиться к многоадресной группе IPv4 и получать многоадресные датаграммы, отправленные в эту группу, зависит от реализации.

2. Сокет канала должен быть привязан к адресу wildcard. Если сокет привязан к определённому адресу, а не к общему, то получение многоадресных датаграмм сокетом зависит от реализации.

3. Опция SO_REUSEADDR должна быть включена перед binding сокета. Это необходимо для разрешения привязки нескольких членов группы к одному адресу.

Пример использования:

// join multicast group on this interface, and also use this
     // interface for outgoing multicast datagrams
     NetworkInterface ni = NetworkInterface.getByName("hme0");

     DatagramChannel dc = DatagramChannel.open(StandardProtocolFamily.INET)
         .setOption(StandardSocketOptions.SO_REUSEADDR, true)
         .bind(new InetSocketAddress(5000))
         .setOption(StandardSocketOptions.IP_MULTICAST_IF, ni);

     InetAddress group = InetAddress.getByName("225.4.5.6");

     MembershipKey key = dc.join(group, ni);

Методы

close

void close()
    throws IOException

Определено в:

close в интерфейсе AutoCloseable

Определено в:

close в интерфейсе Channel

Определено в:

close в интерфейсе Closeable

Выбрасывает:

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

join

MembershipKey join(InetAddress group,
                   NetworkInterface interf)
            throws IOException

Параметры:

group - Многоадресный адрес для присоединения

interf - Сеть интерфейс, на котором присоединиться к группе

Возвращает:

Ключ членства

Выбрасывает:

IllegalArgumentException - Если параметр группы не является multicast адресом, или тип адреса параметра группы не поддерживается данным каналом

IllegalStateException - Если канал уже имеет членство, специфичное для источника, в группе на интерфейсе

UnsupportedOperationException - Если сокет канала не является сокетом Internet Protocol

ClosedChannelException - Если данный канал закрыт

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

SecurityException - Если установлен менеджер безопасности, а его метод checkMulticast запрещает доступ к многоадресной группе

join

MembershipKey join(InetAddress group,
                   NetworkInterface interf,
                   InetAddress source)
            throws IOException

Параметры:

group - Многоадресный адрес для присоединения

interf - Сеть интерфейс, на котором присоединиться к группе

source - Адрес источника

Возвращает:

Ключ членства

Выбрасывает:

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

IllegalStateException - Если канал в настоящее время является членом группы на заданном интерфейсе для получения всех датаграмм

UnsupportedOperationException - Если сокет канала не является сокетом Internet Protocol или фильтрация источников не поддерживается

ClosedChannelException - Если данный канал закрыт

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

SecurityException - Если установлен менеджер безопасности, а его метод checkMulticast запрещает доступ к многоадресной группе