©
本文档使用 PHP中文网手册 发布
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Object java.net.DatagramSocket java.net.MulticastSocket
public class MulticastSocket
多播数据报套接字类用于发送和接收 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 使用多播套接字。
构造方法摘要 | |
---|---|
MulticastSocket()
创建多播套接字。 |
|
MulticastSocket(int port)
创建多播套接字并将其绑定到特定端口。 |
|
MulticastSocket(SocketAddress bindaddr)
创建绑定到指定套接字地址的 MulticastSocket。 |
方法摘要 | |
---|---|
InetAddress |
getInterface()
获取用于多播数据包的网络接口的地址。 |
boolean |
getLoopbackMode()
获取多播数据报的本地回送的设置。 |
NetworkInterface |
getNetworkInterface()
获取多播网络接口集合。 |
int |
getTimeToLive()
获取在套接字上发出的多播数据包的默认生存时间。 |
byte |
getTTL()
已过时。 使用 getTimeToLive 方法来代替,该方法返回 int(而不是 byte)。 |
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.send(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(而不用 byte)作为 ttl 的类型。 |
从类 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 |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
构造方法详细信息 |
---|
public MulticastSocket() throws IOException
如果有安全管理器,则首先使用 0 作为变量来调用其 checkListen
方法,以确保允许该操作。这可能会导致 SecurityException 异常。
创建套接字时,将调用 DatagramSocket.setReuseAddress(boolean)
方法来启用 SO_REUSEADDR 套接字选项。
IOException
- 如果在创建 MulticastSocket 时发生 I/O 异常
SecurityException
- 如果安全管理器存在并且其 checkListen
方法不允许进行该操作。SecurityManager.checkListen(int)
,
DatagramSocket.setReuseAddress(boolean)
public MulticastSocket(int port) throws IOException
如果存在安全管理器,则首先使用 port
参数作为参数调用其 checkListen
方法,以确保允许该操作。这可能会导致 SecurityException 异常。
创建套接字时,将调用 DatagramSocket.setReuseAddress(boolean)
方法来启用 SO_REUSEADDR 套接字选项。
port
- 要使用的端口
IOException
- 如果在创建 MulticastSocket 时发生 I/O 异常
SecurityException
- 如果安全管理器存在并且其 checkListen
方法不允许进行该操作。SecurityManager.checkListen(int)
,
DatagramSocket.setReuseAddress(boolean)
public MulticastSocket(SocketAddress bindaddr) throws IOException
或者,如果地址为 null
,则创建未绑定套接字。
如果有安全管理器,则首先使用 SocketAddress 端口作为参数来调用其 checkListen
方法,以确保允许该操作。这可能会导致 SecurityException 异常。
创建套接字时,将调用 DatagramSocket.setReuseAddress(boolean)
方法来启用 SO_REUSEADDR 套接字选项。
bindaddr
- 要绑定到的套接字地址;或者为 null
,它表示非绑定套接字。
IOException
- 如果在创建 MulticastSocket 时发生 I/O 异常
SecurityException
- 如果安全管理器存在并且其 checkListen
方法不允许进行该操作。SecurityManager.checkListen(int)
,
DatagramSocket.setReuseAddress(boolean)
方法详细信息 |
---|
@Deprecated public void setTTL(byte ttl) throws IOException
MulticastSocket
上发出的多播数据包的默认生存时间,以便控制多播的范围。
ttl 为无符号 8 位量,所以其必须在 0 <= ttl <= 0xFF
范围内。
ttl
- 生存时间
IOException
- 如果在设置默认生存时间值时发生 I/O 异常getTTL()
public void setTimeToLive(int ttl) throws IOException
MulticastSocket
上发出的多播数据包的默认生存时间,以便控制多播的范围。
ttl 必须在 0 <= ttl <= 255
范围内,否则将抛出 IllegalArgumentException。
ttl
- 生存时间
IOException
- 如果在设置默认生存时间值时发生 I/O 异常getTimeToLive()
@Deprecated public byte getTTL() throws IOException
IOException
- 如果在获取默认生存时间值时发生 I/O 异常setTTL(byte)
public int getTimeToLive() throws IOException
IOException
- 如果在获取默认生存时间值时发生 I/O 异常setTimeToLive(int)
public void joinGroup(InetAddress mcastaddr) throws IOException
setInterface
或 setNetworkInterface
的影响。
如果有安全管理器,则此方法首先使用 mcastaddr
作为参数来调用其 checkMulticast
方法。
mcastaddr
- 要加入的多播地址
IOException
- 如果存在错误加入或者当地址不是多播地址时。
SecurityException
- 如果安全管理器存在并且其 checkMulticast
方法不允许加入。SecurityManager.checkMulticast(InetAddress)
public void leaveGroup(InetAddress mcastaddr) throws IOException
setInterface
或 setNetworkInterface
的影响。
如果有安全管理器,则此方法首先使用 mcastaddr
作为参数来调用其 checkMulticast
方法。
mcastaddr
- 要离开的多播地址
IOException
- 如果存在错误离开或者当地址不是多播地址时。
SecurityException
- 如果安全管理器存在并且其 checkMulticast
方法不允许进行该操作。SecurityManager.checkMulticast(InetAddress)
public void joinGroup(SocketAddress mcastaddr, NetworkInterface netIf) throws IOException
如果有安全管理器,则此方法首先使用 mcastaddr
作为参数来调用其 checkMulticast
方法。
mcastaddr
- 要加入的多播地址netIf
- 指定要接收多播数据报包的本地接口;或者为 null,表示由 setInterface(InetAddress)
或 setNetworkInterface(NetworkInterface)
设置的接口
IOException
- 如果存在错误加入或者当地址不是多播地址时。
SecurityException
- 如果安全管理器存在并且其 checkMulticast
方法不允许加入。
IllegalArgumentException
- 如果 mcastaddr 为 null 或者为此套接字不支持的 SocketAddress 子类。SecurityManager.checkMulticast(InetAddress)
public void leaveGroup(SocketAddress mcastaddr, NetworkInterface netIf) throws IOException
如果有安全管理器,则此方法首先使用 mcastaddr
作为参数来调用其 checkMulticast
方法。
mcastaddr
- 要离开的多播地址netIf
- 指定本地接口;或者为 null,表示由 setInterface(InetAddress)
或 setNetworkInterface(NetworkInterface)
设置的接口
IOException
- 如果存在错误离开或者当地址不是多播地址时。
SecurityException
- 如果安全管理器存在并且其 checkMulticast
方法不允许进行该操作。
IllegalArgumentException
- 如果 mcastaddr 为 null 或者为此套接字不支持的 SocketAddress 子类。SecurityManager.checkMulticast(InetAddress)
public void setInterface(InetAddress inf) throws SocketException
inf
- InetAddress
SocketException
- 如果在底层协议中存在错误,如 TCP 错误。getInterface()
public InetAddress getInterface() throws SocketException
InetAddress
。
SocketException
- 如果底层协议出现错误,例如 TCP 错误。setInterface(java.net.InetAddress)
public void setNetworkInterface(NetworkInterface netIf) throws SocketException
netIf
- 接口
SocketException
- 如果在底层协议中存在错误,如 TCP 错误。getNetworkInterface()
public NetworkInterface getNetworkInterface() throws SocketException
NetworkInterface
SocketException
- 如果底层协议出现错误,例如 TCP 错误。setNetworkInterface(NetworkInterface)
public void setLoopbackMode(boolean disable) throws SocketException
因为此选项是一个提示,所以要验证回送的设置模式的应用程序应该调用 getLoopbackMode()
disable
- 为 true
表示禁用 LoopbackMode
SocketException
- 如果在设置值时发生错误getLoopbackMode()
public boolean getLoopbackMode() throws SocketException
SocketException
- 如果在获取值时发生错误setLoopbackMode(boolean)
@Deprecated public void send(DatagramPacket p, byte ttl) throws IOException
setInterface
的影响。
如果存在安全管理器,则此方法首先执行某些安全检查。首先,如果 p.getAddress().isMulticastAddress()
为 true,则此方法将使用 p.getAddress()
和 ttl
作为参数调用安全管理器的 checkMulticast
方法。如果该表达式的计算为 false,则此方法改为调用安全管理器的以 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)
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。