java.nio.channels

Интерфейсный MulticastChannel

Все Суперинтерфейсы:

AutoCloseable, Канал, Closeable, NetworkChannel

Все Известные Классы с реализацией:

DatagramChannel

public interface MulticastChannel
extends NetworkChannel

Сетевой канал, который поддерживает интернет-Протокол (IP) многоадресная передача.

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

В случае канала к IPv4 сокет, базовая операционная система поддерживает RFC 2236: Протокол управления Internet Group, Версия 2 (IGMPv2). Это может дополнительно поддерживать источник, фильтрующий как определено RFC 3376: Протокол управления Internet Group, Версия 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 если базовая платформа не поддерживает исходную фильтрацию. Членство является совокупным, и этот метод может быть вызван снова с той же самой группой и интерфейсом, чтобы позволить получать дейтаграммы от других исходных адресов. Метод возвращает a 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);
 

С тех пор:

1.7

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
void	close() Завершения этот канал.
MembershipKey	join(InetAddress group, NetworkInterface interf) Присоединяется к многоадресной группе, чтобы начать получать все дейтаграммы, отправленные группе, возвращая ключ членства.
MembershipKey	join(InetAddress group, NetworkInterface interf, InetAddress source) Присоединяется к многоадресной группе, чтобы начать получать дейтаграммы, отправленные группе от данного исходного адреса.

Методы, наследованные от интерфейса java.nio.channels. NetworkChannel

bind, getLocalAddress, getOption, setOption, supportedOptions

Методы, наследованные от интерфейса java.nio.channels. Канал

isOpen

Деталь метода

близко

void close()
           throws IOException

Завершения этот канал.

Если канал является элементом многоадресной группы тогда, членство dropped. По возврату, membership-key будет invalid.

Этот метод иначе ведет себя точно как определено Channel интерфейс.

Определенный:

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

Определенный:

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

Определенный:

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

Броски:

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

соединение

MembershipKey join(InetAddress group,
                 NetworkInterface interf)
                   throws IOException

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

Если этот канал является в настоящий момент элементом группы в данном интерфейсе, чтобы получить все дейтаграммы тогда, ключ членства, представляя то членство, возвращается. Иначе этот канал присоединяется к группе, и получающийся новый ключ членства возвращается. Получающийся ключ членства не source-specific.

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

Параметры:

group - Многоадресный адрес, чтобы присоединиться

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

Возвраты:

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

Броски:

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

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

UnsupportedOperationException - Если сокет канала не является интернет-сокетом Протокола

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

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

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

соединение

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

Присоединяется к многоадресной группе, чтобы начать получать дейтаграммы, отправленные группе от данного исходного адреса.

Если этот канал является в настоящий момент элементом группы в данном интерфейсе, чтобы получить дейтаграммы от данного исходного адреса тогда, ключ членства, представляя то членство, возвращается. Иначе этот канал присоединяется к группе, и получающийся новый ключ членства возвращается. Получающийся ключ членства source-specific.

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

Параметры:

group - Многоадресный адрес, чтобы присоединиться

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

source - Исходный адрес

Возвраты:

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

Броски:

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

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

UnsupportedOperationException - Если сокет канала не является интернет-сокетом Протокола, или исходная фильтрация не поддерживается

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

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

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