MulticastSocket API 详解

Extends:  DatagramSocket

zh_cn

多播数据报套接字类用于发送和接收 IP 多播包。MulticastSocket 是一种 (UDP) DatagramSocket，它具有加入 Internet 上其他多播主机的“组”的附加功能。

多播组通过 D 类 IP 地址和标准 UDP 端口号指定。D 类 IP 地址在 224.0.0.0 和 239.255.255.255 的范围内（包括两者）。地址 224.0.0.0 被保留，不应使用。

可以通过首先使用所需端口创建 MulticastSocket，然后调用 joinGroup(InetAddress groupAddr) 方法来加入多播组：

 // join a Multicast group and send the group salutations
 ...
 String msg = "Hello";
 InetAddress group = InetAddress.getByName("228.5.6.7");
 MulticastSocket s = new MulticastSocket(6789);
 s.joinGroup(group);
 DatagramPacket hi = new DatagramPacket(msg.getBytes(), msg.length(),
                             group, 6789);
 s.send(hi);
 // get their responses!
byte[] buf = new byte[1000];
 DatagramPacket recv = new DatagramPacket(buf, buf.length);
 s.receive(recv);
 ...
 // OK, I'm done talking - leave the group...
 s.leaveGroup(group);
 

将消息发送到多播组时，该主机和端口的 所有预定接收者都将接收到消息（在数据包的生存时间范围内，请参阅下文）。套接字不必成为多播组的成员即可向其发送消息。

当套接字预定多播组/端口时，它将接收由该组/端口的其他主机发送的数据报，像该组和端口的所有其他成员一样。套接字通过 leaveGroup(InetAddress addr) 方法放弃组中的成员资格。多个 MulticastSocket 可以同时预定多播组和端口，并且都会接收到组数据报。

同时，不允许 applet 使用多播套接字。

since

JDK1.1

Constructors
public	MulticastSocket() throws IOException zh_cn 创建多播套接字。 如果有安全管理器，则首先使用 0 作为变量来调用其 checkListen 方法，以确保允许该操作。这可能会导致 SecurityException 异常。 创建套接字时，将调用 DatagramSocket#setReuseAddress(boolean) 方法来启用 SO_REUSEADDR 套接字选项。 Throws IOException:  zh_cn 如果在创建 MulticastSocket 时发生 I/O 异常 Throws SecurityException:  zh_cn 如果安全管理器存在并且其 checkListen 方法不允许进行该操作。 See also checkListen, setReuseAddress(boolean)
public	MulticastSocket(int port) throws IOException zh_cn 创建多播套接字并将其绑定到特定端口。 如果存在安全管理器，则首先使用 port 参数作为参数调用其 checkListen 方法，以确保允许该操作。这可能会导致 SecurityException 异常。 创建套接字时，将调用 DatagramSocket#setReuseAddress(boolean) 方法来启用 SO_REUSEADDR 套接字选项。 port zh_cn 要使用的端口 Throws IOException:  zh_cn 如果在创建 MulticastSocket 时发生 I/O 异常 Throws SecurityException:  zh_cn 如果安全管理器存在并且其 checkListen 方法不允许进行该操作。 See also checkListen, setReuseAddress(boolean)
public	MulticastSocket(SocketAddress bindaddr) throws IOException zh_cn 创建绑定到指定套接字地址的 MulticastSocket。 或者，如果地址为 null，则创建未绑定套接字。 如果有安全管理器，则首先使用 SocketAddress 端口作为参数来调用其 checkListen 方法，以确保允许该操作。这可能会导致 SecurityException 异常。 创建套接字时，将调用 DatagramSocket#setReuseAddress(boolean) 方法来启用 SO_REUSEADDR 套接字选项。 bindaddr zh_cn 要绑定到的套接字地址；或者为 null，它表示非绑定套接字。 Throws IOException:  zh_cn 如果在创建 MulticastSocket 时发生 I/O 异常 Throws SecurityException:  zh_cn 如果安全管理器存在并且其 checkListen 方法不允许进行该操作。 since 1.4 See also checkListen, setReuseAddress(boolean)

Methods
public void	joinGroup(InetAddress mcastaddr) throws IOException zh_cn 加入多播组。其行为可能受到 setInterface 或 setNetworkInterface 的影响。 如果有安全管理器，则此方法首先使用 mcastaddr 作为参数来调用其 checkMulticast 方法。 mcastaddr zh_cn 要加入的多播地址 Throws IOException:  zh_cn 如果存在错误加入或者当地址不是多播地址时。 Throws SecurityException:  zh_cn 如果安全管理器存在并且其 checkMulticast 方法不允许加入。 See also checkMulticast(InetAddress)
public void	joinGroup(SocketAddress mcastaddr, NetworkInterface netIf) throws IOException zh_cn 加入指定接口上的指定多播组。 如果有安全管理器，则此方法首先使用 mcastaddr 作为参数来调用其 checkMulticast 方法。 mcastaddr zh_cn 要加入的多播地址 netIf zh_cn 指定要接收多播数据报包的本地接口；或者为 null，表示由 MulticastSocket#setInterface(InetAddress)或 MulticastSocket#setNetworkInterface(NetworkInterface) 设置的接口 Throws IOException:  zh_cn 如果存在错误加入或者当地址不是多播地址时。 Throws SecurityException:  zh_cn 如果安全管理器存在并且其 checkMulticast 方法不允许加入。 Throws IllegalArgumentException:  zh_cn 如果 mcastaddr 为 null 或者为此套接字不支持的 SocketAddress 子类。 since 1.4 See also checkMulticast(InetAddress)
public void	leaveGroup(InetAddress mcastaddr) throws IOException zh_cn 离开多播组。其行为可能受到 setInterface 或 setNetworkInterface 的影响。 如果有安全管理器，则此方法首先使用 mcastaddr 作为参数来调用其 checkMulticast 方法。 mcastaddr zh_cn 要离开的多播地址 Throws IOException:  zh_cn 如果存在错误离开或者当地址不是多播地址时。 Throws SecurityException:  zh_cn 如果安全管理器存在并且其 checkMulticast 方法不允许进行该操作。 See also checkMulticast(InetAddress)
public void	leaveGroup(SocketAddress mcastaddr, NetworkInterface netIf) throws IOException zh_cn 离开指定本地接口上的多播组。 如果有安全管理器，则此方法首先使用 mcastaddr 作为参数来调用其 checkMulticast 方法。 mcastaddr zh_cn 要离开的多播地址 netIf zh_cn 指定本地接口；或者为 null，表示由 MulticastSocket#setInterface(InetAddress) 或MulticastSocket#setNetworkInterface(NetworkInterface) 设置的接口 Throws IOException:  zh_cn 如果存在错误离开或者当地址不是多播地址时。 Throws SecurityException:  zh_cn 如果安全管理器存在并且其 checkMulticast 方法不允许进行该操作。 Throws IllegalArgumentException:  zh_cn 如果 mcastaddr 为 null 或者为此套接字不支持的 SocketAddress 子类。 since 1.4 See also checkMulticast(InetAddress)
public void	send( DatagramPacket p, byte ttl) throws  IOException zh_cn 利用套接字的默认值之外的 TTL（生存时间）将数据报包发送到目的地。只有在需要特定 TTL 的实例中才需要使用此方法；否则，优先考虑在套接字上设置一次 TTL 并将该默认 TTL 用于所有数据包。此方法不改变套接字的默认 TTL。其行为可能受到setInterface 的影响。 如果存在安全管理器，则此方法首先执行某些安全检查。首先，如果 p.getAddress().isMulticastAddress() 为 true，则此方法将使用p.getAddress() 和 ttl 作为参数调用安全管理器的 checkMulticast 方法。如果该表达式的计算为 false，则此方法改为调用安全管理器的以p.getAddress().getHostAddress() 和 p.getPort() 为参数的 checkConnect 方法。如果不允许该操作，则每次调用安全管理器方法都会导致 SecurityException。 p zh_cn 要发送的数据包。数据包应该包含目标多播 ip 地址和要发送的数据。不必成为组成员即可将数据包发送到目标多播地址。 ttl zh_cn 多播数据包的可选生存时间。默认的 ttl 为 1。 Throws IOException:  zh_cn 如果发生错误（即设置 ttl 时出错）则引发该异常。 Throws SecurityException:  zh_cn 如果安全管理器存在并且其 checkMulticast 或 checkConnect 方法不允许发送。 deprecated zh_cn 使用以下代码或其等效代码：...... int ttl = mcastSocket.getTimeToLive(); mcastSocket.setTimeToLive(newttl); mcastSocket.send(p); mcastSocket.setTimeToLive(ttl); ...... See also send, receive, checkMulticast(java.net.InetAddress, byte), checkConnect

Properties
public void	setInterface(InetAddress inf) throws SocketException zh_cn 设置多播网络接口，供其行为将受网络接口值影响的方法使用。对多宿主机 (multihomed host) 很有用。 inf zh_cn InetAddress Throws SocketException:  zh_cn 如果底层协议出现错误，例如 TCP 错误。 See also getInterface()
public InetAddress	getInterface() throws SocketException zh_cn 获取用于多播数据包的网络接口的地址。 return zh_cn 表示用于多播数据包的网络接口地址的 InetAddress。 Throws SocketException:  zh_cn 如果底层协议出现错误，例如 TCP 错误。 See also setInterface(java.net.InetAddress)
public void	setLoopbackMode(boolean disable) throws SocketException zh_cn 启用/禁用多播数据报的本地回送。平台的网络代码将该选项用作设置是否将多播数据回送到本地套接字的提示。 因为此选项是一个提示，所以要验证回送的设置模式的应用程序应该调用 #getLoopbackMode() disable zh_cn 为 true 表示禁用 LoopbackMode Throws SocketException:  zh_cn 如果在设置值时发生错误 since 1.4 See also getLoopbackMode
public boolean	getLoopbackMode() throws SocketException zh_cn 获取多播数据报的本地回送的设置。 Throws SocketException:  zh_cn 如果在获取值时发生错误 return zh_cn 如果已禁用 LoopbackMode，则返回 true since 1.4 See also setLoopbackMode
public void	setNetworkInterface(NetworkInterface netIf) throws SocketException zh_cn 指定在此套接字上发送的输出多播数据报的网络接口。 netIf zh_cn 接口 Throws SocketException:  zh_cn 如果底层协议出现错误，例如 TCP 错误。 since 1.4 See also getNetworkInterface()
public NetworkInterface	getNetworkInterface() throws SocketException zh_cn 获取多播网络接口集合。 Throws SocketException:  zh_cn 如果底层协议出现错误，例如 TCP 错误。 return zh_cn 当前设置的多播 NetworkInterface since 1.4 See also setNetworkInterface(NetworkInterface)
public void	setTimeToLive(int ttl) throws IOException zh_cn 设置在此 MulticastSocket 上发出的多播数据包的默认生存时间，以便控制多播的范围。 ttl 必须在 0 <= ttl <= 255 范围内，否则将抛出 IllegalArgumentException。 Throws IOException:  zh_cn 如果在设置默认生存时间值时发生 I/O 异常 ttl zh_cn 生存时间 See also getTimeToLive()
public int	getTimeToLive() throws IOException zh_cn 获取在套接字上发出的多播数据包的默认生存时间。 Throws IOException:  zh_cn 如果在获取默认生存时间值时发生 I/O 异常 return zh_cn 默认生存时间值 See also setTimeToLive(int)
public void	setTTL(byte ttl) throws  IOException zh_cn 设置在此 MulticastSocket 上发出的多播数据包的默认生存时间，以便控制多播的范围。 ttl 为无符号 8 位量，所以其必须在 0 <= ttl <= 0xFF 范围内。 ttl zh_cn 生存时间 Throws IOException:  zh_cn 如果在设置默认生存时间值时发生 I/O 异常 deprecated zh_cn 使用 setTimeToLive 方法来代替，该方法使用 int（而不用 byte）作为 ttl 的类型。 See also getTTL()
public byte	getTTL() throws  IOException zh_cn 获取在套接字上发出的多播数据包的默认生存时间。 Throws IOException:  zh_cn 如果在获取默认生存时间值时发生 I/O 异常 return zh_cn 默认生存时间值 deprecated zh_cn 使用 getTimeToLive 方法来代替，该方法返回 int（而不是 byte）。 See also setTTL(byte)