-
- All Superinterfaces:
- AutoCloseable, Channel, Closeable, NetworkChannel
- All Known Implementing Classes:
- DatagramChannel
public interface MulticastChannel extends NetworkChannel
A network channel that supports Internet Protocol (IP) multicasting.IP multicasting is the transmission of IP datagrams to members of a group that is zero or more hosts identified by a single destination address.
In the case of a channel to an
IPv4
socket, the underlying operating system supports RFC 2236: Internet Group Management Protocol, Version 2 (IGMPv2). It may optionally support source filtering as specified by RFC 3376: Internet Group Management Protocol, Version 3 (IGMPv3). For channels to anIPv6
socket, the equivalent standards are RFC 2710: Multicast Listener Discovery (MLD) for IPv6 and RFC 3810: Multicast Listener Discovery Version 2 (MLDv2) for IPv6.The
join(InetAddress,NetworkInterface)
method is used to join a group and receive all multicast datagrams sent to the group. A channel may join several multicast groups and may join the same group on severalinterfaces
. Membership is dropped by invoking thedrop
method on the returnedMembershipKey
. If the underlying platform supports source filtering then theblock
andunblock
methods can be used to block or unblock multicast datagrams from particular source addresses.The
join(InetAddress,NetworkInterface,InetAddress)
method is used to begin receiving datagrams sent to a group whose source address matches a given source address. This method throwsUnsupportedOperationException
if the underlying platform does not support source filtering. Membership is cumulative and this method may be invoked again with the same group and interface to allow receiving datagrams from other source addresses. The method returns aMembershipKey
that represents membership to receive datagrams from the given source address. Invoking the key'sdrop
method drops membership so that datagrams from the source address can no longer be received.Platform dependencies
The multicast implementation is intended to map directly to the native multicasting facility. Consequently, the following items should be considered when developing an application that receives IP multicast datagrams:The creation of the channel should specify the
ProtocolFamily
that corresponds to the address type of the multicast groups that the channel will join. There is no guarantee that a channel to a socket in one protocol family can join and receive multicast datagrams when the address of the multicast group corresponds to another protocol family. For example, it is implementation specific if a channel to anIPv6
socket can join anIPv4
multicast group and receive multicast datagrams sent to the group.The channel's socket should be bound to the
wildcard
address. If the socket is bound to a specific address, rather than the wildcard address then it is implementation specific if multicast datagrams are received by the socket.The
SO_REUSEADDR
option should be enabled prior tobinding
the socket. This is required to allow multiple members of the group to bind to the same address.
Usage Example:
// join multicast group on this interface, and also use this // interface for outgoing multicast datagrams NetworkInterface ni = NetworkInterface.getByName("hme0"); DatagramChannel dc = DatagramChannel.open(StandardProtocolFamily.INET) .setOption(StandardSocketOptions.SO_REUSEADDR, true) .bind(new InetSocketAddress(5000)) .setOption(StandardSocketOptions.IP_MULTICAST_IF, ni); InetAddress group = InetAddress.getByName("225.4.5.6"); MembershipKey key = dc.join(group, ni);
- Since:
- 1.7
-
-
Method Summary
Methods Modifier and Type Method and Description void
close()
Closes this channel.MembershipKey
join(InetAddress group, NetworkInterface interf)
Joins a multicast group to begin receiving all datagrams sent to the group, returning a membership key.MembershipKey
join(InetAddress group, NetworkInterface interf, InetAddress source)
Joins a multicast group to begin receiving datagrams sent to the group from a given source address.-
Methods inherited from interface java.nio.channels.NetworkChannel
bind, getLocalAddress, getOption, setOption, supportedOptions
-
Methods inherited from interface java.nio.channels.Channel
isOpen
-
-
-
-
Method Detail
-
close
void close() throws IOException
Closes this channel.If the channel is a member of a multicast group then the membership is
dropped
. Upon return, themembership-key
will beinvalid
.This method otherwise behaves exactly as specified by the
Channel
interface.- Specified by:
close
in interfaceAutoCloseable
- Specified by:
close
in interfaceChannel
- Specified by:
close
in interfaceCloseable
- Throws:
IOException
- If an I/O error occurs
-
join
MembershipKey join(InetAddress group, NetworkInterface interf) throws IOException
Joins a multicast group to begin receiving all datagrams sent to the group, returning a membership key.If this channel is currently a member of the group on the given interface to receive all datagrams then the membership key, representing that membership, is returned. Otherwise this channel joins the group and the resulting new membership key is returned. The resulting membership key is not
source-specific
.A multicast channel may join several multicast groups, including the same group on more than one interface. An implementation may impose a limit on the number of groups that may be joined at the same time.
- Parameters:
group
- The multicast address to joininterf
- The network interface on which to join the group- Returns:
- The membership key
- Throws:
IllegalArgumentException
- If the group parameter is not amulticast
address, or the group parameter is an address type that is not supported by this channelIllegalStateException
- If the channel already has source-specific membership of the group on the interfaceUnsupportedOperationException
- If the channel's socket is not an Internet Protocol socketClosedChannelException
- If this channel is closedIOException
- If an I/O error occursSecurityException
- If a security manager is set, and itscheckMulticast
method denies access to the multiast group
-
join
MembershipKey join(InetAddress group, NetworkInterface interf, InetAddress source) throws IOException
Joins a multicast group to begin receiving datagrams sent to the group from a given source address.If this channel is currently a member of the group on the given interface to receive datagrams from the given source address then the membership key, representing that membership, is returned. Otherwise this channel joins the group and the resulting new membership key is returned. The resulting membership key is
source-specific
.Membership is cumulative and this method may be invoked again with the same group and interface to allow receiving datagrams sent by other source addresses to the group.
- Parameters:
group
- The multicast address to joininterf
- The network interface on which to join the groupsource
- The source address- Returns:
- The membership key
- Throws:
IllegalArgumentException
- If the group parameter is not amulticast
address, the source parameter is not a unicast address, the group parameter is an address type that is not supported by this channel, or the source parameter is not the same address type as the groupIllegalStateException
- If the channel is currently a member of the group on the given interface to receive all datagramsUnsupportedOperationException
- If the channel's socket is not an Internet Protocol socket or source filtering is not supportedClosedChannelException
- If this channel is closedIOException
- If an I/O error occursSecurityException
- If a security manager is set, and itscheckMulticast
method denies access to the multiast group
-
-
Deutsche Übersetzung
Sie haben gebeten, diese Seite auf Deutsch zu besuchen. Momentan ist nur die Oberfläche übersetzt, aber noch nicht der gesamte Inhalt.Wenn Sie mir bei Übersetzungen helfen wollen, ist Ihr Beitrag willkommen. Alles, was Sie tun müssen, ist, sich auf der Website zu registrieren und mir eine Nachricht zu schicken, in der Sie gebeten werden, Sie der Gruppe der Übersetzer hinzuzufügen, die Ihnen die Möglichkeit gibt, die gewünschten Seiten zu übersetzen. Ein Link am Ende jeder übersetzten Seite zeigt an, dass Sie der Übersetzer sind und einen Link zu Ihrem Profil haben.
Vielen Dank im Voraus.
Dokument erstellt 11/06/2005, zuletzt geändert 04/03/2020
Quelle des gedruckten Dokuments:https://www.gaudry.be/de/java-api-rf-java/nio/channels/MulticastChannel.html
Die Infobro ist eine persönliche Seite, deren Inhalt in meiner alleinigen Verantwortung liegt. Der Text ist unter der CreativeCommons-Lizenz (BY-NC-SA) verfügbar. Weitere Informationen auf die Nutzungsbedingungen und dem Autor.
Referenzen
Diese Verweise und Links verweisen auf Dokumente, die während des Schreibens dieser Seite konsultiert wurden, oder die zusätzliche Informationen liefern können, aber die Autoren dieser Quellen können nicht für den Inhalt dieser Seite verantwortlich gemacht werden.
Der Autor Diese Website ist allein dafür verantwortlich, wie die verschiedenen Konzepte und Freiheiten, die mit den Nachschlagewerken gemacht werden, hier dargestellt werden. Denken Sie daran, dass Sie mehrere Quellinformationen austauschen müssen, um das Risiko von Fehlern zu reduzieren.