Класс MembershipKey
public abstract class MembershipKey extends Object
Ключ членства может представлять членство для получения всех дейтаграмм, отправленных в группу, либо он может быть специфичным для источника, то есть представлять членство, при котором принимаются только дейтаграммы с определенного адреса источника. Определить, является ли ключ членства специфичным для источника, можно вызовом его метода sourceAddress.
Ключ членства действителен сразу после создания и остается действительным, пока членство не будет удалено вызовом метода drop или пока канал не будет закрыт. Проверить действительность ключа членства можно вызовом его метода isValid.
Если ключ членства не является специфичным для источника, а базовая операционная система поддерживает фильтрацию источников, то методы block и unblock можно использовать для блокировки или разблокировки многоадресных дейтаграмм с определенных адресов источников.
- С версии:
- 1.7
- См. также:
Краткое описание конструкторов
| Модификатор | Конструктор | Описание |
|---|---|---|
protected |
Инициализирует новый экземпляр этого класса. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
abstract MembershipKey |
block |
Блокирует многоадресные дейтаграммы с указанного адреса источника. |
abstract MulticastChannel |
channel() |
Возвращает канал, для которого был создан этот ключ членства. |
abstract void |
drop() |
Удаляет членство. |
abstract InetAddress |
group() |
Возвращает группу многоадресной рассылки, для которой был создан этот ключ членства. |
abstract boolean |
isValid() |
Показывает, является ли это членство действительным. |
abstract NetworkInterface |
networkInterface() |
Возвращает сетевой интерфейс, для которого был создан этот ключ членства. |
abstract InetAddress |
sourceAddress() |
Возвращает адрес источника, если этот ключ членства специфичен для источника, или null, если это членство не является специфичным для источника. |
abstract MembershipKey |
unblock |
Разблокирует многоадресные дейтаграммы с указанного адреса источника, который ранее был заблокирован с помощью метода block. |
Подробное описание конструкторов
MembershipKey
protected MembershipKey()
Подробное описание методов
isValid
public abstract boolean isValid()
Членство в группе многоадресной рассылки действительно сразу после создания и остается действительным, пока членство не будет удалено вызовом метода drop или пока канал не будет закрыт.
- Возвращает:
-
true, если этот ключ членства действителен, иначеfalse
drop
public abstract void drop()
Если ключ членства представляет членство для получения всех дейтаграмм, членство удаляется, и канал больше не будет получать дейтаграммы, отправленные в группу. Если ключ членства специфичен для источника, канал больше не будет получать дейтаграммы, отправленные в группу с этого адреса источника.
После удаления членства получение дейтаграмм, отправленных в группу, все еще может быть возможным. Это может произойти, если дейтаграммы ожидают получения в буфере приема сокета. После удаления членства канал может снова join группу; в этом случае будет возвращен новый ключ членства.
После завершения вызова этот объект членства будет invalid. Если членство в группе многоадресной рассылки уже недействительно, вызов этого метода не оказывает никакого эффекта. Став недействительным, членство в группе многоадресной рассылки остается таким навсегда.
block
public abstract MembershipKey block(InetAddress source) throws IOException
Если этот ключ членства не является специфичным для источника, а базовая операционная система поддерживает фильтрацию источников, этот метод блокирует многоадресные дейтаграммы с указанного адреса источника. Если указанный адрес источника уже заблокирован, этот метод не оказывает никакого эффекта. После блокировки адреса источника получение дейтаграмм с этого адреса все еще может быть возможным. Это может произойти, если дейтаграммы ожидают получения в буфере приема сокета.
- Параметры:
-
source— адрес источника, который нужно заблокировать - Возвращает:
- этот ключ членства
- Исключения:
-
IllegalArgumentException— если параметрsourceне является одноадресным адресом или имеет тип адреса, отличный от типа адреса группы многоадресной рассылки -
IllegalStateException— если этот ключ членства специфичен для источника или больше не действителен -
UnsupportedOperationException— если базовая операционная система не поддерживает фильтрацию источников -
IOException— если возникает ошибка ввода-вывода
unblock
public abstract MembershipKey unblock(InetAddress source)
block.- Параметры:
-
source— адрес источника, который нужно разблокировать - Возвращает:
- этот ключ членства
- Исключения:
-
IllegalStateException— если указанный адрес источника в данный момент не заблокирован или ключ членства больше не действителен
channel
public abstract MulticastChannel channel()
invalid.- Возвращает:
- канал
group
public abstract InetAddress group()
invalid.- Возвращает:
- группу многоадресной рассылки
networkInterface
public abstract NetworkInterface networkInterface()
invalid.- Возвращает:
- сетевой интерфейс
sourceAddress
public abstract InetAddress sourceAddress()
null, если это членство не является специфичным для источника.- Возвращает:
- Адрес источника, если этот ключ членства специфичен для источника, иначе
null
© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/nio/channels/MembershipKey.html
