本文主要是介绍MulticastSocket API 详解,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
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 可以同时预定多播组和端口,并且都会接收到组数据报。
同时,不允许 applet 使用多播套接字。
Constructors |
---|
public | MulticastSocket() throws IOException 创建多播套接字。 如果有安全管理器,则首先使用 0 作为变量来调用其 checkListen 方法,以确保允许该操作。这可能会导致 SecurityException 异常。 创建套接字时,将调用 DatagramSocket#setReuseAddress(boolean) 方法来启用 SO_REUSEADDR 套接字选项。 Throws | IOException: 如果在创建 MulticastSocket 时发生 I/O 异常 | Throws | SecurityException: 如果安全管理器存在并且其 checkListen 方法不允许进行该操作。 | See also | checkListen, setReuseAddress(boolean) | |
public | MulticastSocket(int port) throws IOException 创建多播套接字并将其绑定到特定端口。 如果存在安全管理器,则首先使用 port 参数作为参数调用其 checkListen 方法,以确保允许该操作。这可能会导致 SecurityException 异常。 创建套接字时,将调用 DatagramSocket#setReuseAddress(boolean) 方法来启用 SO_REUSEADDR 套接字选项。 port | 要使用的端口 | Throws | IOException: 如果在创建 MulticastSocket 时发生 I/O 异常 | Throws | SecurityException: 如果安全管理器存在并且其 checkListen 方法不允许进行该操作。 | See also | checkListen, setReuseAddress(boolean) | |
public | MulticastSocket(SocketAddress bindaddr) throws IOException 创建绑定到指定套接字地址的 MulticastSocket。 或者,如果地址为 null ,则创建未绑定套接字。 如果有安全管理器,则首先使用 SocketAddress 端口作为参数来调用其 checkListen 方法,以确保允许该操作。这可能会导致 SecurityException 异常。 创建套接字时,将调用 DatagramSocket#setReuseAddress(boolean) 方法来启用 SO_REUSEADDR 套接字选项。 bindaddr | 要绑定到的套接字地址;或者为 null ,它表示非绑定套接字。 | Throws | IOException: 如果在创建 MulticastSocket 时发生 I/O 异常 | Throws | SecurityException: 如果安全管理器存在并且其 checkListen 方法不允许进行该操作。 | since | 1.4 | See also | checkListen, setReuseAddress(boolean) | |
Methods |
---|
public void | joinGroup(InetAddress mcastaddr) throws IOException 加入多播组。其行为可能受到 setInterface 或 setNetworkInterface 的影响。 如果有安全管理器,则此方法首先使用 mcastaddr 作为参数来调用其 checkMulticast 方法。 mcastaddr | 要加入的多播地址 | Throws | IOException: 如果存在错误加入或者当地址不是多播地址时。 | Throws | SecurityException: 如果安全管理器存在并且其 checkMulticast 方法不允许加入。 | See also | checkMulticast(InetAddress) | |
public void | joinGroup(SocketAddress mcastaddr, NetworkInterface netIf) throws IOException 加入指定接口上的指定多播组。 如果有安全管理器,则此方法首先使用 mcastaddr 作为参数来调用其 checkMulticast 方法。 mcastaddr | 要加入的多播地址 | netIf | 指定要接收多播数据报包的本地接口;或者为 null,表示由 MulticastSocket#setInterface(InetAddress) 或 MulticastSocket#setNetworkInterface(NetworkInterface) 设置的接口 | Throws | IOException: 如果存在错误加入或者当地址不是多播地址时。 | Throws | SecurityException: 如果安全管理器存在并且其 checkMulticast 方法不允许加入。 | Throws | IllegalArgumentException: 如果 mcastaddr 为 null 或者为此套接字不支持的 SocketAddress 子类。 | since | 1.4 | See also | checkMulticast(InetAddress) | |
public void | leaveGroup(InetAddress mcastaddr) throws IOException 离开多播组。其行为可能受到 setInterface 或 setNetworkInterface 的影响。 如果有安全管理器,则此方法首先使用 mcastaddr 作为参数来调用其 checkMulticast 方法。 mcastaddr | 要离开的多播地址 | Throws | IOException: 如果存在错误离开或者当地址不是多播地址时。 | Throws | SecurityException: 如果安全管理器存在并且其 checkMulticast 方法不允许进行该操作。 | See also | checkMulticast(InetAddress) | |
public void | leaveGroup(SocketAddress mcastaddr, NetworkInterface netIf) throws IOException 离开指定本地接口上的多播组。 如果有安全管理器,则此方法首先使用 mcastaddr 作为参数来调用其 checkMulticast 方法。 mcastaddr | 要离开的多播地址 | netIf | 指定本地接口;或者为 null,表示由 MulticastSocket#setInterface(InetAddress) 或MulticastSocket#setNetworkInterface(NetworkInterface) 设置的接口 | Throws | IOException: 如果存在错误离开或者当地址不是多播地址时。 | Throws | SecurityException: 如果安全管理器存在并且其 checkMulticast 方法不允许进行该操作。 | Throws | IllegalArgumentException: 如果 mcastaddr 为 null 或者为此套接字不支持的 SocketAddress 子类。 | since | 1.4 | See also | checkMulticast(InetAddress) | |
public void | send( DatagramPacket p, byte ttl) throws IOException 利用套接字的默认值之外的 TTL(生存时间)将数据报包发送到目的地。只有在需要特定 TTL 的实例中才需要使用此方法;否则,优先考虑在套接字上设置一次 TTL 并将该默认 TTL 用于所有数据包。此方法不改变套接字的默认 TTL。其行为可能受到setInterface 的影响。 如果存在安全管理器,则此方法首先执行某些安全检查。首先,如果 p.getAddress().isMulticastAddress() 为 true,则此方法将使用p.getAddress() 和 ttl 作为参数调用安全管理器的 checkMulticast 方法。如果该表达式的计算为 false,则此方法改为调用安全管理器的以p.getAddress().getHostAddress() 和 p.getPort() 为参数的 checkConnect 方法。如果不允许该操作,则每次调用安全管理器方法都会导致 SecurityException。 p | 要发送的数据包。数据包应该包含目标多播 ip 地址和要发送的数据。不必成为组成员即可将数据包发送到目标多播地址。 | ttl | 多播数据包的可选生存时间。默认的 ttl 为 1。 | Throws | IOException: 如果发生错误(即设置 ttl 时出错)则引发该异常。 | Throws | SecurityException: 如果安全管理器存在并且其 checkMulticast 或 checkConnect 方法不允许发送。 | deprecated | 使用以下代码或其等效代码:...... 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 设置多播网络接口,供其行为将受网络接口值影响的方法使用。对多宿主机 (multihomed host) 很有用。 inf | InetAddress | Throws | SocketException: 如果底层协议出现错误,例如 TCP 错误。 | See also | getInterface() | |
public InetAddress | getInterface() throws SocketException 获取用于多播数据包的网络接口的地址。 return | 表示用于多播数据包的网络接口地址的 InetAddress 。 | Throws | SocketException: 如果底层协议出现错误,例如 TCP 错误。 | See also | setInterface(java.net.InetAddress) | |
public void | setLoopbackMode(boolean disable) throws SocketException 启用/禁用多播数据报的本地回送。平台的网络代码将该选项用作设置是否将多播数据回送到本地套接字的提示。 因为此选项是一个提示,所以要验证回送的设置模式的应用程序应该调用 #getLoopbackMode() disable | 为 true 表示禁用 LoopbackMode | Throws | SocketException: 如果在设置值时发生错误 | since | 1.4 | See also | getLoopbackMode | |
public boolean | getLoopbackMode() throws SocketException 获取多播数据报的本地回送的设置。 Throws | SocketException: 如果在获取值时发生错误 | return | 如果已禁用 LoopbackMode,则返回 true | since | 1.4 | See also | setLoopbackMode | |
public void | setNetworkInterface(NetworkInterface netIf) throws SocketException 指定在此套接字上发送的输出多播数据报的网络接口。 netIf | 接口 | Throws | SocketException: 如果底层协议出现错误,例如 TCP 错误。 | since | 1.4 | See also | getNetworkInterface() | |
public NetworkInterface | getNetworkInterface() throws SocketException 获取多播网络接口集合。 Throws | SocketException: 如果底层协议出现错误,例如 TCP 错误。 | return | 当前设置的多播 NetworkInterface | since | 1.4 | See also | setNetworkInterface(NetworkInterface) | |
public void | setTimeToLive(int ttl) throws IOException 设置在此 MulticastSocket 上发出的多播数据包的默认生存时间,以便控制多播的范围。 ttl 必须在 0 <= ttl <= 255 范围内,否则将抛出 IllegalArgumentException。 Throws | IOException: 如果在设置默认生存时间值时发生 I/O 异常 | ttl | 生存时间 | See also | getTimeToLive() | |
public int | getTimeToLive() throws IOException 获取在套接字上发出的多播数据包的默认生存时间。 Throws | IOException: 如果在获取默认生存时间值时发生 I/O 异常 | return | 默认生存时间值 | See also | setTimeToLive(int) | |
public void | setTTL(byte ttl) throws IOException 设置在此 MulticastSocket 上发出的多播数据包的默认生存时间,以便控制多播的范围。 ttl 为无符号 8 位量,所以其必须在 0 <= ttl <= 0xFF 范围内。 ttl | 生存时间 | Throws | IOException: 如果在设置默认生存时间值时发生 I/O 异常 | deprecated | 使用 setTimeToLive 方法来代替,该方法使用 int(而不用 byte)作为 ttl 的类型。 | See also | getTTL() | |
public byte | getTTL() throws IOException 获取在套接字上发出的多播数据包的默认生存时间。 Throws | IOException: 如果在获取默认生存时间值时发生 I/O 异常 | return | 默认生存时间值 | deprecated | 使用 getTimeToLive 方法来代替,该方法返回 int(而不是 byte)。 | See also | setTTL(byte) | |
这篇关于MulticastSocket API 详解的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!