Класс MembershipKey

public abstract class MembershipKey
extends Object

Токен, представляющий членство в группе интернет-мультимедиа (IP) multicast.

Ключ членства может представлять членство в получении всех дейтаграмм, отправленных в группу, или он может быть специфичным для источника, что означает, что он представляет членство, получающее только дейтаграммы от определенного адреса источника. Является ли ключ членства специфичным для источника, можно определить, вызвав метод sourceAddress.

Ключ членства действителен при создании и остается действительным до тех пор, пока членство не будет отменено вызовом метода drop или канал не будет закрыт. Действительность ключа членства можно проверить, вызвав метод isValid.

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

Конструкторы

MembershipKey

protected MembershipKey()

Инициализирует новый экземпляр этого класса.

Методы

isValid

public abstract boolean isValid()

Возвращает:

true если этот ключ членства действителен, false в противном случае

drop

public abstract void drop()

block

public abstract MembershipKey block(InetAddress source)
                             throws IOException

Параметры:

source - Адрес источника, который нужно заблокировать

Возвращает:

Этот ключ членства

Исключения:

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

IllegalStateException - Если этот ключ членства специфичен для источника или больше недействителен

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

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

unblock

public abstract MembershipKey unblock(InetAddress source)

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

Параметры:

source - Адрес источника, который нужно разблокировать

Возвращает:

Этот ключ членства

Исключения:

IllegalStateException - Если указанный адрес источника в настоящее время не заблокирован или ключ членства больше недействителен

channel

public abstract MulticastChannel channel()

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

Возвращает:

канал

group

public abstract InetAddress group()

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

Возвращает:

группа multicast

networkInterface

public abstract NetworkInterface networkInterface()

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

Возвращает:

сетевой интерфейс

sourceAddress

public abstract InetAddress sourceAddress()

Возвращает адрес источника, если этот ключ членства специфичен для источника, или null если это членство не специфично для источника.

Возвращает:

Адрес источника, если этот ключ членства специфичен для источника, в противном случае null