Package org.jupnp.transport

Klasse RouterImpl

java.lang.Object

org.jupnp.transport.RouterImpl

Alle implementierten Schnittstellen:

Router

public class RouterImpl
extends Object
implements Router

Default implementation of network message router.

Initializes and starts listening for data on the network when enabled.

Autor:

Christian Bauer, Kai Kreuzer - added multicast response port

Feldübersicht

Felder

Modifizierer und Typ	Feld	Beschreibung
protected UpnpServiceConfiguration	configuration
protected final Map<InetAddress,DatagramIO>	datagramIOs
protected boolean	enabled
protected final Map<NetworkInterface,MulticastReceiver>	multicastReceivers
protected NetworkAddressFactory	networkAddressFactory
protected ProtocolFactory	protocolFactory
protected Lock	readLock
protected ReentrantReadWriteLock	routerLock
protected StreamClient	streamClient
protected final Map<InetAddress,StreamServer>	streamServers
protected Lock	writeLock

Konstruktorübersicht

Konstruktoren

Modifizierer	Konstruktor	Beschreibung
protected	RouterImpl()
	RouterImpl(UpnpServiceConfiguration configuration, ProtocolFactory protocolFactory)

Methodenübersicht

Modifizierer und Typ	Methode	Beschreibung
void	broadcast(byte[] bytes)	Sends the given bytes as a broadcast on all bound DatagramIOs, using source port 9.
boolean	disable()	Unbinds all sockets and stops all listening threads for datagrams and streams.
boolean	disable(DisableRouter event)
boolean	enable()	Initializes listening services: First an instance of MulticastReceiver is bound to each network interface.
boolean	enable(EnableRouter event)
List<NetworkAddress>	getActiveStreamServers(InetAddress preferredAddress)
UpnpServiceConfiguration	getConfiguration()
protected int	getLockTimeoutMillis()
ProtocolFactory	getProtocolFactory()
void	handleStartFailure(InitializationException e)	Called by the Router.enable() method before it returns.
boolean	isEnabled()
protected void	lock(Lock lock)
protected void	lock(Lock lock, int timeoutMilliseconds)
void	received(IncomingDatagramMessage msg)	Obtains the asynchronous protocol Executor and runs the protocol created by the ProtocolFactory for the given message.
void	received(UpnpStream stream)	Obtains the synchronous protocol Executor and runs the UpnpStream directly.
void	send(OutgoingDatagramMessage msg)	Sends the UDP datagram on all bound DatagramIOs.
StreamResponseMessage	send(StreamRequestMessage msg)	Sends the TCP stream request with the StreamClient.
void	shutdown()	Disables the router and releases all other resources.
protected void	startAddressBasedTransports(Iterator<InetAddress> addresses)
protected void	startInterfaceBasedTransports(Iterator<NetworkInterface> interfaces)
protected void	unlock(Lock lock)

Von Klasse geerbte Methoden java.lang.Object

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

Felddetails

configuration

protected UpnpServiceConfiguration configuration

protocolFactory

protected ProtocolFactory protocolFactory

enabled

protected volatile boolean enabled

routerLock

protected ReentrantReadWriteLock routerLock

readLock

protected Lock readLock

writeLock

protected Lock writeLock

networkAddressFactory

protected NetworkAddressFactory networkAddressFactory

streamClient

protected StreamClient streamClient

multicastReceivers

protected final Map<NetworkInterface,MulticastReceiver> multicastReceivers

datagramIOs

protected final Map<InetAddress,DatagramIO> datagramIOs

streamServers

protected final Map<InetAddress,StreamServer> streamServers

Konstruktordetails

RouterImpl

protected RouterImpl()

RouterImpl

public RouterImpl(UpnpServiceConfiguration configuration,
 ProtocolFactory protocolFactory)

Parameter:

configuration - The configuration used by this router.

protocolFactory - The protocol factory used by this router.

Methodendetails

enable

public boolean enable(EnableRouter event)
               throws RouterException

Löst aus:

RouterException

disable

public boolean disable(DisableRouter event)
                throws RouterException

Löst aus:

RouterException

getConfiguration

public UpnpServiceConfiguration getConfiguration()

Angegeben von:

getConfiguration in Schnittstelle Router

Gibt zurück:

The configuration used by this router.

getProtocolFactory

public ProtocolFactory getProtocolFactory()

Angegeben von:

getProtocolFactory in Schnittstelle Router

Gibt zurück:

The protocol factory used by this router.

enable

public boolean enable()
               throws RouterException

Initializes listening services: First an instance of MulticastReceiver is bound to each network interface. Then an instance of DatagramIO and StreamServer is bound to each bind address returned by the network address factory, respectively. There is only one instance of StreamClient created and managed by this router.

Angegeben von:

enable in Schnittstelle Router

Gibt zurück:

true if the router was enabled. false if it's already running.

Löst aus:

RouterException

disable

public boolean disable()
                throws RouterException

Beschreibung aus Schnittstelle kopiert: Router

Unbinds all sockets and stops all listening threads for datagrams and streams.

Angegeben von:

disable in Schnittstelle Router

Gibt zurück:

true if the router was disabled. false if it wasn't running.

Löst aus:

RouterException

shutdown

public void shutdown()
              throws RouterException

Beschreibung aus Schnittstelle kopiert: Router

Disables the router and releases all other resources.

Angegeben von:

shutdown in Schnittstelle Router

Löst aus:

RouterException

isEnabled

public boolean isEnabled()

Angegeben von:

isEnabled in Schnittstelle Router

Gibt zurück:

true if the router is currently enabled.

handleStartFailure

public void handleStartFailure(InitializationException e)
                        throws InitializationException

Beschreibung aus Schnittstelle kopiert: Router

Called by the Router.enable() method before it returns.

Angegeben von:

handleStartFailure in Schnittstelle Router

Parameter:

e - The cause of the failure.

Löst aus:

InitializationException - if the exception was not recoverable.

getActiveStreamServers

public List<NetworkAddress> getActiveStreamServers(InetAddress preferredAddress)
                                            throws RouterException

Angegeben von:

getActiveStreamServers in Schnittstelle Router

Parameter:

preferredAddress - A preferred stream server bound address or null.

Gibt zurück:

An empty list if no stream server is currently active, otherwise a single network address if the preferred address is active, or a list of all active bound stream servers.

Löst aus:

RouterException

received

public void received(IncomingDatagramMessage msg)

Obtains the asynchronous protocol Executor and runs the protocol created by the ProtocolFactory for the given message.

If the factory doesn't create a protocol, the message is dropped immediately without creating another thread or consuming further resources. This means we can filter the datagrams in the protocol factory and e.g. completely disable discovery or only allow notification message from some known services we'd like to work with.

Angegeben von:

received in Schnittstelle Router

Parameter:

msg - The received datagram message.

received

public void received(UpnpStream stream)

Obtains the synchronous protocol Executor and runs the UpnpStream directly.

Angegeben von:

received in Schnittstelle Router

Parameter:

stream - The received UpnpStream.

send

public void send(OutgoingDatagramMessage msg)
          throws RouterException

Sends the UDP datagram on all bound DatagramIOs.

Angegeben von:

send in Schnittstelle Router

Parameter:

msg - The UDP datagram message to send.

Löst aus:

RouterException - if a recoverable error, such as thread interruption, occurs.

send

public StreamResponseMessage send(StreamRequestMessage msg)
                           throws RouterException

Sends the TCP stream request with the StreamClient.

Angegeben von:

send in Schnittstelle Router

Parameter:

msg - The TCP (HTTP) stream message to send.

Gibt zurück:

The return value of the StreamClient.sendRequest(StreamRequestMessage) method or null if no StreamClient is available.

Löst aus:

RouterException - if a recoverable error, such as thread interruption, occurs.

broadcast

public void broadcast(byte[] bytes)
               throws RouterException

Sends the given bytes as a broadcast on all bound DatagramIOs, using source port 9.

TODO: Support source port parameter

Angegeben von:

broadcast in Schnittstelle Router

Parameter:

bytes - The byte payload of the UDP datagram.

Löst aus:

RouterException - if a recoverable error, such as thread interruption, occurs.

startInterfaceBasedTransports

protected void startInterfaceBasedTransports(Iterator<NetworkInterface> interfaces)
                                      throws InitializationException

Löst aus:

InitializationException

startAddressBasedTransports

protected void startAddressBasedTransports(Iterator<InetAddress> addresses)
                                    throws InitializationException

Löst aus:

InitializationException

lock

protected void lock(Lock lock,
 int timeoutMilliseconds)
             throws RouterException

Löst aus:

RouterException

lock

protected void lock(Lock lock)
             throws RouterException

Löst aus:

RouterException

unlock

protected void unlock(Lock lock)

getLockTimeoutMillis

protected int getLockTimeoutMillis()

Gibt zurück:

Defaults to 6 seconds, should be longer than it takes the router to be enabled/disabled.