org.opendaylight.vtn.manager.internal.inventory

Class StaticTopologyManager

java.lang.Object

org.opendaylight.vtn.manager.internal.util.CloseableContainer

org.opendaylight.vtn.manager.internal.util.AbstractDataChangeListener<T,C>

org.opendaylight.vtn.manager.internal.util.MultiDataStoreListener<VtnStaticTopology,org.opendaylight.vtn.manager.internal.inventory.StaticLinkUpdateTask>

org.opendaylight.vtn.manager.internal.inventory.StaticTopologyManager

All Implemented Interfaces:

AutoCloseable, EventListener, org.opendaylight.controller.md.sal.binding.api.DataTreeChangeListener<VtnStaticTopology>, VTNSubSystem

public final class StaticTopologyManager
extends MultiDataStoreListener<VtnStaticTopology,org.opendaylight.vtn.manager.internal.inventory.StaticLinkUpdateTask>
implements VTNSubSystem

StaticTopologyManager manages the static network topology configured by user.

Method Summary

Modifier and Type	Method and Description
protected org.opendaylight.vtn.manager.internal.inventory.StaticLinkUpdateTask	enterEvent() Invoked when AbstractDataChangeListener.onDataTreeChanged(Collection) has just been called.
protected void	exitEvent(org.opendaylight.vtn.manager.internal.inventory.StaticLinkUpdateTask ectx) Invoked when AbstractDataChangeListener.onDataTreeChanged(Collection) is going to leave.
protected org.slf4j.Logger	getLogger() Return a logger instance.
protected org.opendaylight.yangtools.yang.binding.InstanceIdentifier<VtnStaticTopology>	getWildcardPath() Return a wildcard instance identifier that specifies data objects to be listened.
VTNFuture<?>	initConfig(boolean master) Post a MD-SAL datastore transaction task that initializes the configuration.
void	initRpcServices(org.opendaylight.controller.sal.binding.api.RpcProviderRegistry rpcReg, CompositeAutoCloseable regs) Register RPC implementation required by the subsystem.
protected boolean	isDepth(VtnUpdateType type) Return a boolean value which specifies the order of tree traversal.
protected boolean	isRequiredType(Class<?> type) Determine whether the specified type of the tree node is required to be notified or not.
protected boolean	isUpdated(org.opendaylight.vtn.manager.internal.inventory.StaticLinkUpdateTask ectx, ChangedData<?> data) Determine whether the specified data was updated or not.
protected void	onCreated(org.opendaylight.vtn.manager.internal.inventory.StaticLinkUpdateTask ectx, IdentifiedData<?> data) Invoked when a new data has been created in the datastore.
protected void	onRemoved(org.opendaylight.vtn.manager.internal.inventory.StaticLinkUpdateTask ectx, IdentifiedData<?> data) Invoked when a data has been removed from the datastore.
protected void	onUpdated(org.opendaylight.vtn.manager.internal.inventory.StaticLinkUpdateTask ectx, ChangedData<?> data) Invoked when a data in the datastore has been updated.

Methods inherited from class org.opendaylight.vtn.manager.internal.util.MultiDataStoreListener

handleTree, isLeafNode

Methods inherited from class org.opendaylight.vtn.manager.internal.util.AbstractDataChangeListener

checkPath, getTargetType, isRequiredEvent, nullValue, onDataTreeChanged, registerListener

Methods inherited from class org.opendaylight.vtn.manager.internal.util.CloseableContainer

addCloseable, close

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.AutoCloseable

close

Method Detail

isDepth

protected boolean isDepth(VtnUpdateType type)

Return a boolean value which specifies the order of tree traversal.

Specified by:

isDepth in class MultiDataStoreListener<VtnStaticTopology,org.opendaylight.vtn.manager.internal.inventory.StaticLinkUpdateTask>

Parameters:

type - A VtnUpdateType instance which specifies the type of event.

Returns:

true means that each tree node's children need to be processed after the tree node itself (from outer to innter). false means that each tree node's children need to be processed before the tree node itself (from inner to outer).

isRequiredType

protected boolean isRequiredType(@Nonnull
                                 Class<?> type)

Determine whether the specified type of the tree node is required to be notified or not.

Specified by:

isRequiredType in class MultiDataStoreListener<VtnStaticTopology,org.opendaylight.vtn.manager.internal.inventory.StaticLinkUpdateTask>

Parameters:

type - A class that specifies the type of the tree node.

Returns:

true if the specified type of the tree node needs to be notified. false otherwise.

isUpdated

protected boolean isUpdated(org.opendaylight.vtn.manager.internal.inventory.StaticLinkUpdateTask ectx,
                            ChangedData<?> data)

Determine whether the specified data was updated or not.

MultiDataStoreListener.onUpdated(Object, ChangedData) is called only if this method returns true. This method is called only if MultiDataStoreListener.isRequiredType(Class) with specifying type returns true.

Specified by:

isUpdated in class MultiDataStoreListener<VtnStaticTopology,org.opendaylight.vtn.manager.internal.inventory.StaticLinkUpdateTask>

Parameters:

ectx - An event context created by this instance.

data - A ChangedData instance which contains the changed data.

Returns:

true if the target data was updated. false otherwise.

enterEvent

protected org.opendaylight.vtn.manager.internal.inventory.StaticLinkUpdateTask enterEvent()

Invoked when AbstractDataChangeListener.onDataTreeChanged(Collection) has just been called.

Specified by:

enterEvent in class AbstractDataChangeListener<VtnStaticTopology,org.opendaylight.vtn.manager.internal.inventory.StaticLinkUpdateTask>

Returns:

A new event context.

exitEvent

protected void exitEvent(org.opendaylight.vtn.manager.internal.inventory.StaticLinkUpdateTask ectx)

Invoked when AbstractDataChangeListener.onDataTreeChanged(Collection) is going to leave.

Note that this method may be called even if no modified data was notified.

Specified by:

exitEvent in class AbstractDataChangeListener<VtnStaticTopology,org.opendaylight.vtn.manager.internal.inventory.StaticLinkUpdateTask>

Parameters:

ectx - An event context created by AbstractDataChangeListener.enterEvent().

onCreated

protected void onCreated(org.opendaylight.vtn.manager.internal.inventory.StaticLinkUpdateTask ectx,
                         IdentifiedData<?> data)

Invoked when a new data has been created in the datastore.

Specified by:

onCreated in class MultiDataStoreListener<VtnStaticTopology,org.opendaylight.vtn.manager.internal.inventory.StaticLinkUpdateTask>

Parameters:

ectx - An event context created by this instance.

data - An IdentifiedData instance which contains the created data.

onUpdated

protected void onUpdated(org.opendaylight.vtn.manager.internal.inventory.StaticLinkUpdateTask ectx,
                         ChangedData<?> data)

Invoked when a data in the datastore has been updated.

Specified by:

onUpdated in class MultiDataStoreListener<VtnStaticTopology,org.opendaylight.vtn.manager.internal.inventory.StaticLinkUpdateTask>

Parameters:

ectx - An event context created by this instance.

data - A ChangedData instance which contains the changed data.

onRemoved

protected void onRemoved(org.opendaylight.vtn.manager.internal.inventory.StaticLinkUpdateTask ectx,
                         IdentifiedData<?> data)

Invoked when a data has been removed from the datastore.

Specified by:

onRemoved in class MultiDataStoreListener<VtnStaticTopology,org.opendaylight.vtn.manager.internal.inventory.StaticLinkUpdateTask>

Parameters:

ectx - An event context created by this instance.

data - An IdentifiedData instance which contains the removed data.

getWildcardPath

protected org.opendaylight.yangtools.yang.binding.InstanceIdentifier<VtnStaticTopology> getWildcardPath()

Return a wildcard instance identifier that specifies data objects to be listened.

Specified by:

getWildcardPath in class AbstractDataChangeListener<VtnStaticTopology,org.opendaylight.vtn.manager.internal.inventory.StaticLinkUpdateTask>

Returns:

A wildcard instance identifier.

getLogger

protected org.slf4j.Logger getLogger()

Return a logger instance.

Note that this method will be called before the constructor returns.

Specified by:

getLogger in class CloseableContainer

Returns:

A Logger instance.

initConfig

public VTNFuture<?> initConfig(boolean master)

Post a MD-SAL datastore transaction task that initializes the configuration.

Specified by:

initConfig in interface VTNSubSystem

Parameters:

master - true if the local node is the configuration provider.

Returns:

A VTNFuture instance associated with the task for initialization. null means that there is nothing to do on initialization.

initRpcServices

public void initRpcServices(org.opendaylight.controller.sal.binding.api.RpcProviderRegistry rpcReg,
                            CompositeAutoCloseable regs)

Register RPC implementation required by the subsystem.

Specified by:

initRpcServices in interface VTNSubSystem

Parameters:

rpcReg - A RpcProviderRegistry service instance.

regs - A CompositeAutoCloseable instance to store RPC registration.