Schnittstelle MulticastReceiver<C extends MulticastReceiverConfiguration>

Typparameter:
C - The type of the service's configuration.
Alle Superschnittstellen:
Runnable
Alle bekannten Implementierungsklassen:
MulticastReceiverImpl

public interface MulticastReceiver<C extends MulticastReceiverConfiguration> extends Runnable
Service for receiving multicast UDP datagrams, one per bound network interface.

This services typically listens on a socket for UDP datagrams, the socket has joined the configured multicast group.

This listening loop is started with the run() method, this service is Runnable. Any received datagram is then converted into an IncomingDatagramMessage and handled by the Router.received(org.jupnp.model.message.IncomingDatagramMessage) method. This conversion is the job of the DatagramProcessor.

An implementation has to be thread-safe.

Autor:
Christian Bauer
  • Methodendetails

    • init

      void init(NetworkInterface networkInterface, Router router, NetworkAddressFactory networkAddressFactory, DatagramProcessor datagramProcessor) throws InitializationException
      Configures the service and starts any listening sockets.
      Parameter:
      networkInterface - The network interface on which to join the multicast group on.
      router - The router which handles received IncomingDatagramMessages.
      networkAddressFactory - The network address factory to use for local address lookup given a local interface and a remote address.
      datagramProcessor - Reads and writes datagrams.
      Löst aus:
      InitializationException - If the service could not be initialized or started.
    • stop

      void stop()
      Stops the service, closes any listening sockets.
    • getConfiguration

      C getConfiguration()
      Gibt zurück:
      This service's configuration.