Package org.jupnp.transport.impl

Klasse DatagramIOImpl

java.lang.Object

org.jupnp.transport.impl.DatagramIOImpl

Alle implementierten Schnittstellen:

Runnable, DatagramIO<DatagramIOConfigurationImpl>

public class DatagramIOImpl
extends Object
implements DatagramIO<DatagramIOConfigurationImpl>

Default implementation based on a single shared (receive/send) UDP MulticastSocket.

Although we do not receive multicast datagrams with this service, sending multicast datagrams with a configuration time-to-live requires a MulticastSocket.

Thread-safety is guaranteed through synchronization of methods of this service and by the thread-safe underlying socket.

Autor:

Christian Bauer, Kai Kreuzer - added configurable port for search responses, Jochen Hiller - add more diagnostic information in case of an general communication exception

Feldübersicht

Felder

Modifizierer und Typ	Feld	Beschreibung
protected final DatagramIOConfigurationImpl	configuration
protected DatagramProcessor	datagramProcessor
protected InetSocketAddress	localAddress
protected Router	router
protected MulticastSocket	socket

Konstruktorübersicht

Konstruktoren

Konstruktor	Beschreibung
DatagramIOImpl(DatagramIOConfigurationImpl configuration)

Methodenübersicht

Modifizierer und Typ	Methode	Beschreibung
DatagramIOConfigurationImpl	getConfiguration()
void	init(InetAddress bindAddress, int bindPort, Router router, DatagramProcessor datagramProcessor)	Configures the service and starts any listening sockets.
void	run()
void	send(DatagramPacket datagram)	The actual sending of a UDP datagram.
void	send(OutgoingDatagramMessage message)	Sends a datagram after conversion with DatagramProcessor.write(org.jupnp.model.message.OutgoingDatagramMessage).
void	stop()	Stops the service, closes any listening sockets.

Von Klasse geerbte Methoden java.lang.Object

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

Felddetails

configuration

protected final DatagramIOConfigurationImpl configuration

router

protected Router router

datagramProcessor

protected DatagramProcessor datagramProcessor

localAddress

protected InetSocketAddress localAddress

socket

protected MulticastSocket socket

Konstruktordetails

DatagramIOImpl

public DatagramIOImpl(DatagramIOConfigurationImpl configuration)

Methodendetails

getConfiguration

public DatagramIOConfigurationImpl getConfiguration()

Angegeben von:

getConfiguration in Schnittstelle DatagramIO<DatagramIOConfigurationImpl>

Gibt zurück:

This service's configuration.

init

public void init(InetAddress bindAddress,
 int bindPort,
 Router router,
 DatagramProcessor datagramProcessor)
          throws InitializationException

Beschreibung aus Schnittstelle kopiert: DatagramIO

Configures the service and starts any listening sockets.

Angegeben von:

init in Schnittstelle DatagramIO<DatagramIOConfigurationImpl>

Parameter:

bindAddress - The port to bind any sockets on. 0 means choosing an ephemeral port

router - The router which handles received IncomingDatagramMessages.

datagramProcessor - Reads and writes datagrams.

Löst aus:

InitializationException - If the service could not be initialized or started.

stop

public void stop()

Beschreibung aus Schnittstelle kopiert: DatagramIO

Stops the service, closes any listening sockets.

Angegeben von:

stop in Schnittstelle DatagramIO<DatagramIOConfigurationImpl>

run

public void run()

Angegeben von:

run in Schnittstelle Runnable

send

public void send(OutgoingDatagramMessage message)

Beschreibung aus Schnittstelle kopiert: DatagramIO

Sends a datagram after conversion with DatagramProcessor.write(org.jupnp.model.message.OutgoingDatagramMessage).

Angegeben von:

send in Schnittstelle DatagramIO<DatagramIOConfigurationImpl>

Parameter:

message - The message to send.

send

public void send(DatagramPacket datagram)

Beschreibung aus Schnittstelle kopiert: DatagramIO

The actual sending of a UDP datagram.

Recoverable errors should be logged, if appropriate only with debug level. Any non-recoverable errors should be thrown as RuntimeExceptions.

Angegeben von:

send in Schnittstelle DatagramIO<DatagramIOConfigurationImpl>

Parameter:

datagram - The UDP datagram to send.