Интерфейс MulticastChannel

public interface MulticastChannel
extends NetworkChannel

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

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

В случае канала для сокета IPv4 операционная система по желанию поддерживает RFC 2236: Протокол управления группами Интернета, версия 2 (IGMPv2). Если 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);

void close()
    throws IOException

MembershipKey join(InetAddress group,
                   NetworkInterface interf)
            throws IOException

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