compact1, compact2, compact3

java.net

Class MulticastSocket

java.lang.Object

java.net.DatagramSocket

java.net.MulticastSocket

All Implemented Interfaces:

Closeable， AutoCloseable

public class MulticastSocket
extends DatagramSocket

多播数据报套接字类发送和接收IP多播包是有用的。一个多播套接字（UDP）是DatagramSocket，附加功能，加入“组”的其他多播主机在互联网上。

一个多播组的D类IP地址和一个标准的UDP端口号指定。D类IP地址的范围是224.0.0.0到239.255.255.255，包容。地址224.0.0.0保留，不应使用。

人会首先创建一个具有所需的端口来加入一个组播组，然后调用joinGroup(InetAddress groupAddr)方法：

/ /加入一个组播组发送组致敬…字符串味精=“你好”；InetAddress组它。通过getByName（“228.5.6.7”）；多播套接字=新来的（6789）；s.joingroup（集团）；数据报HI =新的数据报（味精。getbytes() length()，味精，组，6789）；派遣（HI）；得到他们的回应！字节[] BUF字节=新[ 1000 ]；数据报接收=新的数据报（缓冲区，缓冲区的长度）；接受（接收）；…/好的，我做了说话-离开小组…s.leavegroup（集团）；

时发送一个消息到一个多播组， 全部的预定该主机和端口的接收者接收信息（时间内的数据包，生活范围见下）。该套接字不需要是多播组的成员来发送消息。

当一个套接字预订一个多播组/端口，它接收到其它主机发送到组/端口的数据报，这样的组和端口的所有其他成员。插座离组中的成员资格的leavegroup（InetAddress addr）方法。多个多播套接字可以订阅一个组播组和港口的同时，他们都可以接收数据报。

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

从以下版本开始：

JDK1.1

构造方法摘要

构造方法

Constructor and Description
MulticastSocket() 创建一个多播套接字。
MulticastSocket(int port) 创建一个多播套接字并将其绑定到一个特定的端口。
MulticastSocket(SocketAddress bindaddr) 创建一个多播套接字绑定到指定的套接字地址。

方法摘要

Modifier and Type	Method and Description
InetAddress	getInterface() 检索用于多播包的网络接口的地址。
boolean	getLoopbackMode() 获得多播数据报的本地回环设置。
NetworkInterface	getNetworkInterface() 获取组播网络接口集。
int	getTimeToLive() 获取在套接字上发送的多播包的默认时间。
byte	getTTL() 过时的。 使用gettimetolive方法相反，它返回一个int代替一个字节。
void	joinGroup(InetAddress mcastaddr) 加入一个多播组。
void	joinGroup(SocketAddress mcastaddr, NetworkInterface netIf) 在指定的接口中加入指定的多播组。
void	leaveGroup(InetAddress mcastaddr) 留下一个多播组。
void	leaveGroup(SocketAddress mcastaddr, NetworkInterface netIf) 在指定的本地接口上留下多播组。
void	send(DatagramPacket p, byte ttl) 过时的。 使用下面的代码或其等效的：int TTL = mcastsocket。gettimetolive()；mcastsocket。settimetolive（newttl）；mcastsocket。发送（P）；mcastsocket。settimetolive（TTL）；......
void	setInterface(InetAddress inf) 设置使用网络接口的值影响其行为的方法所使用的多播网络接口。
void	setLoopbackMode(boolean disable) 禁用/启用多播数据报的本地回环的选项是使用平台的网络代码作为是否设置将多播数据回送到本地套接字的暗示。
void	setNetworkInterface(NetworkInterface netIf) 指定发送多播数据报套接字的网络接口上发送。
void	setTimeToLive(int ttl) 设置默认时间为组播包住发出这 MulticastSocket为了控制多播的范围。
void	setTTL(byte ttl) 过时的。 使用settimetolive方法相反，它使用int代替字节为TTL型。

Methods inherited from class java.net.DatagramSocket

bind, close, connect, connect, disconnect, getBroadcast, getChannel, getInetAddress, getLocalAddress, getLocalPort, getLocalSocketAddress, getPort, getReceiveBufferSize, getRemoteSocketAddress, getReuseAddress, getSendBufferSize, getSoTimeout, getTrafficClass, isBound, isClosed, isConnected, receive, send, setBroadcast, setDatagramSocketImplFactory, setReceiveBufferSize, setReuseAddress, setSendBufferSize, setSoTimeout, setTrafficClass

Methods inherited from class java.lang.Object

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

Constructor Detail

MulticastSocket

public MulticastSocket()
                throws IOException

创建一个多播套接字。

如果存在安全管理器，它的checkListen方法是先叫0来保证操作的参数是允许的。这可能导致SecurityException。

当套接字创建DatagramSocket.setReuseAddress(boolean)方法以使so_reuseaddr套接字选项。

异常

IOException如果发生I/O异常而创建的多播套接字

SecurityException -如果存在一个安全管理及其 checkListen方法不允许操作。

另请参见：

SecurityManager.checkListen(int)， DatagramSocket.setReuseAddress(boolean)

MulticastSocket

public MulticastSocket(int port)
                throws IOException

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

如果存在安全管理器，它的checkListen方法与port参数以保证运行参数可以先叫。这可能导致SecurityException。

当套接字创建DatagramSocket.setReuseAddress(boolean)方法以使so_reuseaddr套接字选项。

参数

port端口使用

异常

IOException如果发生I/O异常而创建的多播套接字

SecurityException -如果存在一个安全管理及其 checkListen方法不允许操作。

另请参见：

SecurityManager.checkListen(int)， DatagramSocket.setReuseAddress(boolean)

MulticastSocket

public MulticastSocket(SocketAddress bindaddr)
                throws IOException

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

或者，如果地址是null，创建一个未绑定套接字。

如果存在安全管理器，它的checkListen方法与SocketAddress端口以确保操作的参数是允许先叫。这可能导致SecurityException。

当套接字创建DatagramSocket.setReuseAddress(boolean)方法以使so_reuseaddr套接字选项。

参数

bindaddr套接字地址绑定，或 null为未绑定套接字。

异常

IOException如果发生I/O异常而创建的多播套接字

SecurityException -如果存在一个安全管理及其 checkListen方法不允许操作。

从以下版本开始：

一点四

另请参见：

SecurityManager.checkListen(int)， DatagramSocket.setReuseAddress(boolean)

方法详细信息

setTTL

@Deprecated
public void setTTL(byte ttl)
                        throws IOException

过时的。 使用settimetolive方法相反，它使用int代替字节为TTL型。

设置默认时间为组播包住发出这 MulticastSocket为了控制多播的范围。

TTL是一个无符号 8位的数量，所以必须范围是0 <= ttl <= 0xFF 。

参数

ttl -生存时间

异常

IOException如果发生I/O异常而设置的生活价值的默认时间

另请参见：

getTTL()

setTimeToLive

public void setTimeToLive(int ttl)
                   throws IOException

设置默认时间为组播包住发出这 MulticastSocket为了控制多播的范围。

TTL 必须范围是0 <= ttl <= 255或IllegalArgumentException将抛出。多播数据包的TTL以0派不上网络传输可提供本地。

参数

ttl -生存时间

异常

IOException如果发生I/O异常而设置的生活价值的默认时间

另请参见：

getTimeToLive()

getTTL

@Deprecated
public byte getTTL()
                        throws IOException

过时的。 使用gettimetolive方法相反，它返回一个int代替一个字节。

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

结果

活值的默认时间

异常

IOException如果发生I/O异常而获得生活价值的默认时间

另请参见：

setTTL(byte)

getTimeToLive

public int getTimeToLive()
                  throws IOException

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

结果

活值的默认时间

异常

IOException如果发生I/O异常而获得生活价值的默认时间

另请参见：

setTimeToLive(int)

joinGroup

public void joinGroup(InetAddress mcastaddr)
               throws IOException

加入一个多播组。它的行为可以通过 setInterface setNetworkInterface

如果存在安全管理器，该方法首先调用它的checkMulticast法作为其参数的mcastaddr论点。

或影响。

参数

mcastaddr -加入组播地址

异常

IOException -如果有一个错误连接或当地址不是一个多播地址。

SecurityException -如果存在一个安全管理及其 checkMulticast方法不允许加入。

另请参见：

SecurityManager.checkMulticast(InetAddress)

leaveGroup

public void leaveGroup(InetAddress mcastaddr)
                throws IOException

留下一个多播组。它的行为可能会影响 setInterface或 setNetworkInterface。

如果存在安全管理器，该方法首先调用与mcastaddr参数作为其参数的checkMulticast方法。

参数

mcastaddr -离开组播地址

异常

IOException -如果有错误或离开时的地址不是一个多播地址。

SecurityException -如果存在一个安全管理及其 checkMulticast方法不允许操作。

另请参见：

SecurityManager.checkMulticast(InetAddress)

joinGroup

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

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

如果存在安全管理器，该方法首先调用作为参数的mcastaddr论证其checkMulticast方法。

参数

mcastaddr -加入组播地址

netIf -指定本地接口接收组播数据包，或推迟到 setInterface(InetAddress)或 setNetworkInterface(NetworkInterface)接口

异常

IOException -如果有一个错误连接或当地址不是一个多播地址。

SecurityException -如果存在一个安全管理及其 checkMulticast方法不允许加入。

IllegalArgumentException -如果mcastaddr是空的或是通过这个插座不支持SocketAddress类

从以下版本开始：

一点四

另请参见：

SecurityManager.checkMulticast(InetAddress)

leaveGroup

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

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

如果存在安全管理器，该方法首先调用与mcastaddr参数作为其参数的checkMulticast方法。

参数

mcastaddr -离开组播地址

netIf -指定本地接口或推迟到 setInterface(InetAddress)或 setNetworkInterface(NetworkInterface)接口

异常

IOException -如果有错误或离开时的地址不是一个多播地址。

SecurityException -如果存在一个安全管理及其 checkMulticast方法不允许操作。

IllegalArgumentException -如果mcastaddr是空的或是通过这个插座不支持SocketAddress类

从以下版本开始：

一点四

另请参见：

SecurityManager.checkMulticast(InetAddress)

setInterface

public void setInterface(InetAddress inf)
                  throws SocketException

设置使用网络接口的值影响其行为的方法所使用的多播网络接口。有用的多宿主主机。

参数

inf -但是它

异常

SocketException -如果在底层协议有错误，例如TCP错误。

另请参见：

getInterface()

getInterface

public InetAddress getInterface()
                         throws SocketException

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

结果

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

异常

SocketException -如果在底层协议有错误，例如TCP错误。

另请参见：

setInterface(java.net.InetAddress)

setNetworkInterface

public void setNetworkInterface(NetworkInterface netIf)
                         throws SocketException

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

参数

netIf -界面

异常

SocketException -如果在底层协议有错误，例如TCP错误。

从以下版本开始：

一点四

另请参见：

getNetworkInterface()

getNetworkInterface

public NetworkInterface getNetworkInterface()
                                     throws SocketException

获取组播网络接口集。

结果

目前组播 NetworkInterface

异常

SocketException -如果在底层协议有错误，例如TCP错误。

从以下版本开始：

一点四

另请参见：

setNetworkInterface(NetworkInterface)

setLoopbackMode

public void setLoopbackMode(boolean disable)
                     throws SocketException

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

因为这个选项是一个提示，应用程序要验证什么环回模式设置为应该叫getLoopbackMode()

参数

disable - true禁用loopbackmode

异常

SocketException如果同时设置的值时发生错误

从以下版本开始：

一点四

另请参见：

getLoopbackMode()

getLoopbackMode

public boolean getLoopbackMode()
                        throws SocketException

获得多播数据报的本地回环设置。

结果

如果loopbackmode已被禁用

异常

SocketException -如果发生错误而获得的价值

从以下版本开始：

一点四

另请参见：

setLoopbackMode(boolean)

send

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

过时的。 使用下面的代码或其等效的：int TTL = mcastsocket。gettimetolive()；mcastsocket。settimetolive（newttl）；mcastsocket。发送（P）；mcastsocket。settimetolive（TTL）；......

发送一个数据包的目的地，一个TTL（生存时间）比其他的套接字默认。这种方法只需要使用的情况下，特定的TTL是理想的；否则最好设置TTL曾经在插座上，并使用所有数据包的默认TTL。该方法不 不改变插座的默认TTL。它的行为可能会受到 setInterface。

如果有一个安全管理器，该方法首先执行一些安全检查。首先，如果z- bbbbb 7e0-60a0-4cf9-b072-cd9e4ee58168是真的，这个方法调用作为参数p.getAddress()和ttl安全经理的checkMulticast方法。如果这个表达是错误的评价，这种方法而不是调用参数p.getAddress().getHostAddress()和p.getPort()安全经理的checkConnect方法。每次调用一个安全管理方法如果操作不允许导致SecurityException。

参数

p -发送数据包。该数据包应该包含目的地组播IP地址和发送的数据。一个不需要是组的成员发送数据包到一个目的地多播地址。

ttl可选时间为多播包住。默认的TTL是1。

异常

IOException -如果出现错误，即错误而设置的TTL提出。

SecurityException -如果存在一个安全管理及其 checkMulticast或 checkConnect方法不允许发送。

另请参见：

DatagramSocket.send(java.net.DatagramPacket)， DatagramSocket.receive(java.net.DatagramPacket)， SecurityManager.checkMulticast(java.net.InetAddress, byte)， SecurityManager.checkConnect(java.lang.String, int)