鸿蒙OS MulticastSocket

MulticastSocket

java.lang.Object

|—java.net.DatagramSocket

|—|—java.net.MulticastSocket

public class MulticastSocket
extends DatagramSocket

多播数据报套接字类对于发送和接收 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 可以同时订阅一个组播组和端口，它们都将接收组数据报。

目前不允许小程序使用多播套接字。

构造函数摘要

方法总结

构造函数详细信息

MulticastSocket

public MulticastSocket() throws IOException

创建一个多播套接字。

如果存在安全管理器，则首先调用其 checkListen 方法，并以 0 作为其参数，以确保允许该操作。 这可能会导致 SecurityException。

创建套接字时，调用 DatagramSocket#setReuseAddress(boolean) 方法以启用 SO_REUSEADDR 套接字选项。

Throws:

MulticastSocket

public MulticastSocket(int port) throws IOException

创建一个多播套接字并将其绑定到特定端口。

如果有安全管理器，首先调用它的 checkListen 方法，并将端口参数作为其参数，以确保允许该操作。 这可能会导致 SecurityException。

创建套接字时，调用 DatagramSocket#setReuseAddress(boolean) 方法以启用 SO_REUSEADDR 套接字选项。

参数：

Throws:

MulticastSocket

public MulticastSocket(SocketAddress bindaddr) throws IOException

创建一个绑定到指定套接字地址的 MulticastSocket。

或者，如果地址为空，则创建一个未绑定的套接字。

如果有安全管理器，首先调用它的 checkListen 方法，并以 SocketAddress 端口作为其参数，以确保允许该操作。 这可能会导致 SecurityException。

创建套接字时，调用 DatagramSocket#setReuseAddress(boolean) 方法以启用 SO_REUSEADDR 套接字选项。

参数：

Throws:

方法详情

setTTL

@Deprecated public void setTTL(byte ttl) throws IOException

已弃用。 改用 setTimeToLive 方法，该方法使用 int 而不是 byte 作为 ttl 的类型。

设置在此 MulticastSocket 上发送的多播数据包的默认生存时间，以控制多播的范围。

ttl 是一个无符号的 8 位量，因此必须在 0 <= ttl <= 0xFF 范围内。

参数：

Throws:

setTimeToLive

public void setTimeToLive(int ttl) throws IOException

设置在此 MulticastSocket 上发送的多播数据包的默认生存时间，以控制多播的范围。

ttl 必须在 0 <= ttl <= 255 范围内，否则将引发 IllegalArgumentException。 以 0 的 TTL 发送的组播数据包不会在网络上传输，但可以在本地传送。

参数：

Throws:

getTTL

@Deprecated public byte getTTL() throws IOException

已弃用。 改用 getTimeToLive 方法，它返回一个 int 而不是一个字节。

获取在套接字上发送的多播数据包的默认生存时间。

返回:

默认生存时间值

Throws:

getTimeToLive

public int getTimeToLive() throws IOException

获取在套接字上发送的多播数据包的默认time-to-live。

返回:

默认time-to-live值

Throws:

joinGroup

public void joinGroup(InetAddress mcastaddr) throws IOException

加入多播组。 它的行为可能会受到 setInterface 或 setNetworkInterface 的影响。

如果有安全管理器，则此方法首先调用其 checkMulticast 方法，并将 mcastaddr 参数作为其参数。

参数：

Throws:

leaveGroup

public void leaveGroup(InetAddress mcastaddr) throws IOException

离开一个多播组。 它的行为可能会受到 setInterface 或 setNetworkInterface 的影响。

如果有安全管理器，则此方法首先调用其 checkMulticast 方法，并将 mcastaddr 参数作为其参数。

参数：

Throws:

joinGroup

public void joinGroup(SocketAddress mcastaddr, NetworkInterface netIf) throws IOException

在指定接口加入指定的组播组。

如果有安全管理器，则此方法首先调用其 checkMulticast 方法，并将 mcastaddr 参数作为其参数。

参数：

Throws:

leaveGroup

public void leaveGroup(SocketAddress mcastaddr, NetworkInterface netIf) throws IOException

将组播组留在指定的本地接口上。

如果有安全管理器，则此方法首先调用其 checkMulticast 方法，并将 mcastaddr 参数作为其参数。

参数：

Throws:

setInterface

public void setInterface(InetAddress inf) throws SocketException

设置行为将受网络接口值影响的方法使用的多播网络接口。 对于多宿主主机很有用。

参数：

Throws:

getInterface

public InetAddress getInterface() throws SocketException

检索用于多播数据包的网络接口的地址。

返回:

InetAddress 表示用于多播数据包的网络接口的地址。

Throws:

setNetworkInterface

public void setNetworkInterface(NetworkInterface netIf) throws SocketException

指定在此套接字上发送的传出多播数据报的网络接口。

参数：

Throws:

getNetworkInterface

public NetworkInterface getNetworkInterface() throws SocketException

获取组播网络接口集。

返回:

当前设置的多播网络接口

Throws:

setLoopbackMode

public void setLoopbackMode(boolean disable) throws SocketException

禁用/启用多播数据报的本地环回 该选项被平台的网络代码用作设置多播数据是否将环回本地套接字的提示。

因为这个选项是一个提示，所以想要验证设置的环回模式的应用程序应该调用 getLoopbackMode()

参数：

Throws:

getLoopbackMode

public boolean getLoopbackMode() throws SocketException

获取组播数据报本地环回的设置。

返回:

如果 LoopbackMode 已被禁用，则为 true

Throws:

send

@Deprecated public void send(DatagramPacket p, byte ttl) throws IOException

已弃用。请改用以下代码或其等效代码：…… int ttl = mcastSocket.getTimeToLive(); mcastSocket.setTimeToLive(newttl); mcastSocket.send(p); mcastSocket.setTimeToLive(ttl); ……

将数据报包发送到目的地，其 TTL（生存时间）不是套接字的默认值。这种方法只需要在需要特定 TTL 的情况下使用；否则最好在套接字上设置一次 TTL，并为所有数据包使用该默认 TTL。此方法不会更改套接字的默认 TTL。它的行为可能会受到 setInterface 的影响。

如果有安全管理器，此方法首先执行一些安全检查。首先，如果 p.getAddress().isMulticastAddress() 为真，则此方法以 p.getAddress() 和 ttl 作为其参数调用安全管理器的 checkMulticast 方法。如果该表达式的评估结果为假，则此方法将使用参数 p.getAddress().getHostAddress() 和 p.getPort() 调用安全管理器的 checkConnect 方法。如果不允许该操作，则对安全管理器方法的每次调用都可能导致 SecurityException。

参数：

Throws: