compact1, compact2, compact3

java.nio.channels

Class MembershipKey

java.lang.Object

java.nio.channels.MembershipKey

public abstract class MembershipKey
extends Object

表示因特网协议（IP）多播组的成员资格的令牌。

一个会员的关键可能代表一个会员接收所有数据包发送到组，也可以是特定源，这意味着它是一个会员，从一个特定的源地址只接收数据报。是否一个会员的关键是源的可以通过调用其sourceAddress法测定。

一个会员的关键是有效的在创造和保持有效直到会员下降调用drop方法，或关闭通道。成为会员的关键的有效性可以通过调用其isValid法测试。

凡会员关键不特定源和底层操作系统支持源过滤，然后block和unblock方法可以用来阻止或允许多播数据报从特定的源地址。

从以下版本开始：

一点七

另请参见：

MulticastChannel

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	MembershipKey() 初始化该类的一个新实例。

方法摘要

Modifier and Type	Method and Description
abstract MembershipKey	block(InetAddress source) 块多播数据报从给定的源地址。
abstract MulticastChannel	channel() 返回此成员键创建的通道。
abstract void	drop() 滴会员。
abstract InetAddress	group() 返回创建此成员键的多播组。
abstract boolean	isValid() 告诉是否该成员资格是有效的。
abstract NetworkInterface	networkInterface() 返回创建此成员键的网络接口。
abstract InetAddress	sourceAddress() 如果这个会员关键是源的返回源地址，或 null如果会员不特定源。
abstract MembershipKey	unblock(InetAddress source) 疏通多播数据报从给定的源地址，先前被使用 block方法。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

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如果I/O错误发生

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