compact1, compact2, compact3

java.nio.channels

Interface MulticastChannel

All Superinterfaces:

AutoCloseable， Channel， Closeable， NetworkChannel

所有已知实现类：

DatagramChannel

public interface MulticastChannel
extends NetworkChannel

支持因特网协议（IP）多播的网络信道。

IP多播是IP数据报传输的一组是零个或多个由一个目的地址标识的主机名。

在一个IPv4套接字通道的情况下，底层操作系统支持 RFC 2236: Internet Group Management Protocol, Version 2 (IGMPv2)。它可以支持源过滤指定的 RFC 3376: Internet Group Management Protocol, Version 3 (IGMPv3)。对于渠道的IPv6插座，相当于标准 RFC 2710: Multicast Listener Discovery (MLD) for IPv6和 RFC 3810: Multicast Listener Discovery Version 2 (MLDv2) for IPv6。

的join(InetAddress,NetworkInterface)所使用的方法是加入一个组和接收所有的多播数据报发送到组。一个频道可以加入多个组播组，可以加入几interfaces同组。会员下降调用返回的MembershipKey的drop方法。如果基础平台支持源过滤然后block和unblock方法可以用来阻止或允许多播数据报从特定的源地址。

的join(InetAddress,NetworkInterface,InetAddress)法开始接收发送到一组其源地址匹配给定的源地址的数据报。该方法将UnsupportedOperationException如果基础平台不支持源过滤。会员是累积性的，这种方法可以调用了同组和接口允许从其他源地址接收数据报的。该方法返回一个MembershipKey代表会员从给定的源地址接收数据报。调用的方法的关键drop滴会员，从源地址的数据报，不再能接受。

平台依赖性

组播实现的目的是直接映射到本地多播设备。因此，下列项目应考虑开发一个应用程序接收IP组播数据报的时候：

1. 通道的创作应指定对应于该信道将加入组播组地址类型的ProtocolFamily。有没有保证，在一个协议族套接字通道可以连接和接收多播数据报当组播组地址对应到另一个协议族。例如，它是具体实施如果一个IPv6套接字通道可以加入多播组的多播数据报IPv4接收发送到组。

2. 通道的插座应绑定到wildcard地址。如果套接字绑定到一个特定的地址，而不是通配符地址那么多播数据报套接字接收它的具体实施。

3. 的SO_REUSEADDR选项应该可以binding插座之前。这是必需的，允许该组的多个成员绑定到相同的地址。

使用示例：

在这个接口上加入多播组，并使用此发送多播数据报/接口网络接口网络接口通过getByName（NI =“hme0”）；datagramchannel直流= DatagramChannel.开放（standardprotocolfamily。INET）（standardsocketoptions.so_reuseaddr SetOption，真的）。。绑定（新inetsocketaddress（5000））（standardsocketoptions.ip_multicast_if SetOption，Ni）；InetAddress组它。通过getByName（“225.4.5.6”）；membershipkey关键=直流。加入（组、Ni）；

从以下版本开始：

一点七

方法摘要

Modifier and Type	Method and Description
void	close() 关闭此通道。
MembershipKey	join(InetAddress group, NetworkInterface interf) 加入一个多播组开始接收所有的数据包发送到组，返回一个会员的关键。
MembershipKey	join(InetAddress group, NetworkInterface interf, InetAddress source) 加入一个多播组开始接收从一个给定的源地址的数据包发送到组。

Methods inherited from interface java.nio.channels.NetworkChannel

bind, getLocalAddress, getOption, setOption, supportedOptions

Methods inherited from interface java.nio.channels.Channel

isOpen

方法详细信息

close

void close()
    throws IOException

关闭此通道。

如果信道是一个多播组的成员dropped成员。返回后，该membership-key将invalid。

本法另有行为完全由Channel指定界面。

Specified by:

close 接口 AutoCloseable

Specified by:

close 接口 Channel

Specified by:

close 接口 Closeable

异常

IOException如果I/O错误发生

join

MembershipKey join(InetAddress group,
                   NetworkInterface interf)
            throws IOException

加入一个多播组开始接收所有的数据包发送到组，返回一个会员的关键。

如果这个频道是目前集团的成员之一，在给定的接口接收数据包然后所有会员的关键，代表会员，返回。否则，此通道将加入该组，并返回所产生的新成员密钥。由此产生的会员关键不source-specific。

一个多播信道可以加入多个组播组，包括同一组在一个以上的接口上。一个实现可能会对可能同时加入的组的数量施加限制。

参数

group -加入组播地址

interf上的网络接口加入组

结果

会员的关键

异常

IllegalArgumentException如果组参数不是一个 multicast地址，或组参数是一个地址类型不是由这个渠道支持

IllegalStateException如果通道已经源接口上的特定组的成员

UnsupportedOperationException如果通道的插座不是一个网络协议的套接字

ClosedChannelException -如果这通道关闭

IOException如果I/O错误发生

SecurityException -如果一个安全管理设置，其 checkMulticast方法拒绝访问该组播组

join

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

加入一个多播组开始接收从一个给定的源地址的数据包发送到组。

如果这个频道是目前集团的成员之一，在给定的接口接收数据报从给定的源地址然后会员钥匙，代表会员，返回。否则，此通道将加入该组，并返回所产生的新成员密钥。由此产生的关键是source-specific会员。

会员是累积性的，这种方法可以调用了同组和接口允许接收的源地址的数据报发送到组。

参数

group -加入组播地址

interf上的网络接口加入组

source -源地址

结果

会员的关键

异常

IllegalArgumentException如果组参数不是一个 multicast地址，源参数不是一个单播地址，这组参数是一个地址类型不支持这个频道，或者源参数不相同的地址类型为组

IllegalStateException如果通道目前是在给定的接口接收的数据包的组的成员

UnsupportedOperationException如果通道的插座不是一个网络协议的socket或源过滤不支持

ClosedChannelException -如果这通道关闭

IOException如果I/O错误发生

SecurityException -如果一个安全管理设置，其 checkMulticast方法拒绝访问该组播组