Interface DpwsFramework
-
- All Implemented Interfaces:
-
com.google.common.util.concurrent.Service
public interface DpwsFramework implements ServiceInterface that supplies DPWS core functions.
This service is required to be started before any other interaction with the DPWS stack. It is required once per Guice module.
DpwsFramework is responsible to run a multicast UDP queue in order to send and receive discovery messages. Moreover, it prints out a list of network adapters for information purposes.
Do not forget to stop the DPWS framework for a graceful shutdown.
-
-
Method Summary
Modifier and Type Method Description abstract voidsetNetworkInterface(NetworkInterface networkInterface)Sets the network interface to be used by the framework. abstract voidregisterService(Collection<Service> services)Registers a service to attach to the framework's lifecycle. -
Methods inherited from class com.google.common.util.concurrent.Service
addListener, awaitRunning, awaitTerminated, failureCause, isRunning, startAsync, state, stopAsync -
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
-
Method Detail
-
setNetworkInterface
abstract void setNetworkInterface(NetworkInterface networkInterface)
Sets the network interface to be used by the framework.
This may only be set while the framework isn't running.
- Parameters:
networkInterface- a network interface.
-
registerService
abstract void registerService(Collection<Service> services)
Registers a service to attach to the framework's lifecycle.
Starts and shuts down registered services when starting and stopping the framework. Whenever a constructor (outside of the dpws package) receives a wrapped thread pool, it must register the service using this method to ensure it is properly cleaned up when shutting down the device but not the JVM.
- Services registered when the framework is already running will be started.
- Services will be shutdown in the inverse order they're registered in, i.e. the last service registered will be the first to shut down.
- Parameters:
services- Services to register for startup and shutdown.
-
-
-
-