org.eclipse.californium.elements

Class UdpMulticastConnector

java.lang.Object

org.eclipse.californium.elements.UDPConnector

org.eclipse.californium.elements.UdpMulticastConnector

All Implemented Interfaces:

Connector

public class UdpMulticastConnector
extends UDPConnector

Connector which inherits functionality of UDPConnector replacing DatagramSocket with a MulticastSocket to receive multicast requests in compliance to RFC7390 Group Communication for the Constrained Application Protocol (CoAP) to the registered multicast group.

Field Summary

Fields inherited from class org.eclipse.californium.elements.UDPConnector

localAddr, LOGGER, running, UNDEFINED

Constructor Summary

Constructors

Constructor and Description
UdpMulticastConnector(InetAddress intfAddress, InetSocketAddress localAddress, InetAddress... multicastGroups) Creates a connector bound to given multicast group and IP Port, using the specified network interface for receiving multicast packets Note: This constructor that allows you to specify a network interface was added to mitigate the issue described at https://github.com/eclipse/californium/issues/872.
UdpMulticastConnector(InetSocketAddress localAddress, InetAddress... multicastGroups) Creates a connector bound to given multicast group and IP Port, using the default (any) network interface for receiving multicast packets Note: You might run into issues described at https://bugs.java.com/bugdatabase/view_bug.do?bug_id=4701650 if you do not specify a network interface.

Method Summary

Methods

Modifier and Type	Method and Description
void	start() Starts the connector.

Methods inherited from class org.eclipse.californium.elements.UDPConnector

destroy, getAddress, getProtocol, getReceiveBufferSize, getReceiverPacketSize, getReceiverThreadCount, getSendBufferSize, getSenderThreadCount, init, send, setEndpointContextMatcher, setRawDataReceiver, setReceiveBufferSize, setReceiverPacketSize, setReceiverThreadCount, setSendBufferSize, setSenderThreadCount, stop, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

UdpMulticastConnector

public UdpMulticastConnector(InetAddress intfAddress,
                     InetSocketAddress localAddress,
                     InetAddress... multicastGroups)

Creates a connector bound to given multicast group and IP Port, using the specified network interface for receiving multicast packets Note: This constructor that allows you to specify a network interface was added to mitigate the issue described at https://github.com/eclipse/californium/issues/872. If you run into trouble using this approach, a own UdpMulticastConnector implementation may be used with a proper initialisation of the MulticastSocket in an overriden start() method for that case.

Parameters:

intfAddress - address of interface to use to receive multicast packets

localAddress - local socket address

multicastGroups - multicast groups to join

UdpMulticastConnector

public UdpMulticastConnector(InetSocketAddress localAddress,
                     InetAddress... multicastGroups)

Creates a connector bound to given multicast group and IP Port, using the default (any) network interface for receiving multicast packets Note: You might run into issues described at https://bugs.java.com/bugdatabase/view_bug.do?bug_id=4701650 if you do not specify a network interface. See also https://github.com/eclipse/californium/issues/872.

Parameters:

localAddress - local socket address

multicastGroups - multicast groups to join

Method Detail

start

public void start()
           throws IOException

Description copied from interface: Connector

Starts the connector. The connector might bind to a socket for instance.

Specified by:

start in interface Connector

Overrides:

start in class UDPConnector

Throws:

IOException - Signals that an I/O exception has occurred.