Package org.somda.sdc.glue.consumer

Class SdcRemoteDeviceImpl

java.lang.Object

com.google.common.util.concurrent.AbstractIdleService

org.somda.sdc.glue.consumer.SdcRemoteDeviceImpl

All Implemented Interfaces:

com.google.common.util.concurrent.Service, SdcRemoteDevice

public class SdcRemoteDeviceImpl
extends com.google.common.util.concurrent.AbstractIdleService
implements SdcRemoteDevice

Default implementation of SdcRemoteDevice.

Nested Class Summary

Nested classes/interfaces inherited from interface com.google.common.util.concurrent.Service

com.google.common.util.concurrent.Service.Listener, com.google.common.util.concurrent.Service.State

Method Summary

Modifier and Type	Method	Description
HostingServiceProxy	getHostingServiceProxy()	Gets the hosting service proxy.
LocalizationServiceAccess	getLocalizationServiceAccess()	Gets a localization service invoker access.
RemoteMdibAccess	getMdibAccess()	Read access to the remote MDIB.
MdibAccessObservable	getMdibAccessObservable()	Gets an interface to subscribe for MDIB updates.
SetServiceAccess	getSetServiceAccess()	Gets a set service invoker access.
void	registerWatchdogObserver(WatchdogObserver watchdogObserver)	In order to get notified on disconnect events, this function attaches a watchdog observer.
protected void	shutDown()
protected void	startUp()
void	unregisterWatchdogObserver(WatchdogObserver watchdogObserver)	Removes a watchdog observer.

Methods inherited from class com.google.common.util.concurrent.AbstractIdleService

addListener, awaitRunning, awaitRunning, awaitRunning, awaitTerminated, awaitTerminated, awaitTerminated, executor, failureCause, isRunning, serviceName, startAsync, state, stopAsync, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.google.common.util.concurrent.Service

addListener, awaitRunning, awaitRunning, awaitRunning, awaitTerminated, awaitTerminated, awaitTerminated, failureCause, isRunning, startAsync, state, stopAsync

Method Details

getHostingServiceProxy

public HostingServiceProxy getHostingServiceProxy()

Description copied from interface: SdcRemoteDevice

Gets the hosting service proxy.

The hosting service proxy can be used to access the device including metadata and services.

Specified by:

getHostingServiceProxy in interface SdcRemoteDevice

Returns:

the hosting service proxy bundled with the SDC remote device instance.

getMdibAccess

public RemoteMdibAccess getMdibAccess()

Description copied from interface: SdcRemoteDevice

Read access to the remote MDIB.

The remote MDIB is updated by a background process that processes incoming reports. In order to manually access Web Services, one can use SdcRemoteDevice.getHostingServiceProxy().

Specified by:

getMdibAccess in interface SdcRemoteDevice

Returns:

MDIB access to read the remote MDIB.

getMdibAccessObservable

public MdibAccessObservable getMdibAccessObservable()

Description copied from interface: SdcRemoteDevice

Gets an interface to subscribe for MDIB updates.

Specified by:

getMdibAccessObservable in interface SdcRemoteDevice

Returns:

the MDIB observable interface.

getSetServiceAccess

public SetServiceAccess getSetServiceAccess()

Description copied from interface: SdcRemoteDevice

Gets a set service invoker access.

Please note that the set service access only works if the context and/or set service are available from the remote device. If not set service exists, any call to the SetServiceAccess interface results in an immediately cancelled future.

Specified by:

getSetServiceAccess in interface SdcRemoteDevice

Returns:

a set service invoker access interface.

See Also:

• SetServiceAccess.invoke(AbstractSet, Class)
• SetServiceAccess.invoke(AbstractSet, Consumer, Class)

registerWatchdogObserver

public void registerWatchdogObserver(WatchdogObserver watchdogObserver)

Description copied from interface: SdcRemoteDevice

In order to get notified on disconnect events, this function attaches a watchdog observer.

Specified by:

registerWatchdogObserver in interface SdcRemoteDevice

Parameters:

watchdogObserver - the watchdog callback interface.

unregisterWatchdogObserver

public void unregisterWatchdogObserver(WatchdogObserver watchdogObserver)

Description copied from interface: SdcRemoteDevice

Removes a watchdog observer.

Specified by:

unregisterWatchdogObserver in interface SdcRemoteDevice

Parameters:

watchdogObserver - the watchdog observer to remove.

getLocalizationServiceAccess

public LocalizationServiceAccess getLocalizationServiceAccess()

Description copied from interface: SdcRemoteDevice

Gets a localization service invoker access.

Please note that the localization service access only works if the service is available from the remote device. If no localization service exists, any call to the LocalizationServiceAccess interface results in an immediately cancelled future.

Specified by:

getLocalizationServiceAccess in interface SdcRemoteDevice

Returns:

a localization service invoker access interface.

See Also:

• LocalizationServiceAccess.getLocalizedText(GetLocalizedText)
• LocalizationServiceAccess.getSupportedLanguages(GetSupportedLanguages)
• LocalizationServiceAccess.cachePrefetch(BigInteger)
• LocalizationServiceAccess.cachePrefetch(BigInteger, List)

startUp

protected void startUp()
                throws TimeoutException

Specified by:

startUp in class com.google.common.util.concurrent.AbstractIdleService

Throws:

TimeoutException

shutDown

protected void shutDown()

Specified by:

shutDown in class com.google.common.util.concurrent.AbstractIdleService