*/
package org.opendaylight.controller.md.sal.common.api.data;
-import org.opendaylight.yangtools.concepts.ListenerRegistration;
import org.opendaylight.yangtools.concepts.Path;
/**
- *
* Base interface that provides access to a conceptual data tree store and also provides the ability to
* subscribe for changes to data under a given branch of the tree.
*
* For a detailed explanation of how transaction are isolated and how transaction-local
* changes are committed to global data tree, see
* {@link AsyncReadTransaction}, {@link AsyncWriteTransaction},
- * {@link AsyncReadWriteTransaction} and {@link AsyncWriteTransaction#commit()}.
+ * {@link AsyncReadWriteTransaction} and {@link AsyncWriteTransaction#submit()}.
*
*
* <p>
* @param <D>
* Type of data (payload), which represents data payload
*/
-public interface AsyncDataBroker<P extends Path<P>, D, L extends AsyncDataChangeListener<P, D>> extends //
- AsyncDataTransactionFactory<P, D> {
-
- /**
- *
- * Scope of Data Change
- *
- * <p>
- * Represents scope of data change (addition, replacement, deletion).
- *
- * The terminology for scope types is reused from LDAP.
- *
- * <h2>Examples</h2>
- *
- * Following is an example model with comments describing what notifications
- * you would receive based on the scope you specify, when you are
- * registering for changes on container a.
- *
- * <pre>
- * container a // scope BASE, ONE, SUBTREE
- * leaf "foo" // scope ONE, SUBTREE
- * container // scope ONE, SUBTREE
- * leaf "bar" // scope SUBTREE
- * list list // scope ONE, SUBTREE
- * list [a] // scope SUBTREE
- * id "a" // scope SUBTREE
- * list [b] // scope SUBTREE
- * id "b" // scope SUBTREE
- * </pre>
- *
- * Following is an example model with comments describing what notifications
- * you would receive based on the scope you specify, when you are
- * registering for changes on list list (without specifying concrete item in
- * the list).
- *
- * <pre>
- * list list // scope BASE, ONE, SUBTREE
- * list [a] // scope ONE, SUBTREE
- * id "a" // scope SUBTREE
- * list [b] // scope ONE, SUBTREE
- * id "b" // scope SUBTREE
- * </pre>
- *
- *
- * @see http://www.idevelopment.info/data/LDAP/LDAP_Resources/
- * SEARCH_Setting_the_SCOPE_Parameter.shtml
- */
- public enum DataChangeScope {
+public interface AsyncDataBroker<P extends Path<P>, D> extends AsyncDataTransactionFactory<P, D> {
- /**
- * Represents only a direct change of the node, such as replacement of a
- * node, addition or deletion.
- *
- */
- BASE,
- /**
- * Represent a change (addition,replacement,deletion) of the node or one
- * of its direct children.
- *
- * This scope is superset of {@link #BASE}.
- *
- */
- ONE,
- /**
- * Represents a change of the node or any of or any of its child nodes,
- * direct and nested.
- *
- * This scope is superset of {@link #ONE} and {@link #BASE}.
- *
- */
- SUBTREE
- }
-
- /**
- * {@inheritDoc}
- */
@Override
- public AsyncReadOnlyTransaction<P, D> newReadOnlyTransaction();
+ AsyncReadOnlyTransaction<P, D> newReadOnlyTransaction();
- /**
- * {@inheritDoc}
- */
@Override
- public AsyncReadWriteTransaction<P, D> newReadWriteTransaction();
+ AsyncReadWriteTransaction<P, D> newReadWriteTransaction();
- /**
- * {@inheritDoc}
- */
@Override
- public AsyncWriteTransaction<P, D> newWriteOnlyTransaction();
-
- /**
- * Registers a {@link AsyncDataChangeListener} to receive
- * notifications when data changes under a given path in the conceptual data
- * tree.
- * <p>
- * You are able to register for notifications for any node or subtree
- * which can be reached via the supplied path.
- * <p>
- * If path type <code>P</code> allows it, you may specify paths up to the leaf nodes
- * then it is possible to listen on leaf nodes.
- * <p>
- * You are able to register for data change notifications for a subtree even
- * if it does not exist. You will receive notification once that node is
- * created.
- * <p>
- * If there is any preexisting data in data tree on path for which you are
- * registering, you will receive initial data change event, which will
- * contain all preexisting data, marked as created.
- *
- * <p>
- * You are also able to specify the scope of the changes you want to be
- * notified.
- * <p>
- * Supported scopes are:
- * <ul>
- * <li>{@link DataChangeScope#BASE} - notification events will only be
- * triggered when a node referenced by path is created, removed or replaced.
- * <li>{@link DataChangeScope#ONE} - notifications events will only be
- * triggered when a node referenced by path is created, removed or replaced,
- * or any or any of its immediate children are created, updated or removed.
- * <li>{@link DataChangeScope#SUBTREE} - notification events will be
- * triggered when a node referenced by the path is created, removed
- * or replaced or any of the children in its subtree are created, removed
- * or replaced.
- * </ul>
- * See {@link DataChangeScope} for examples.
- * <p>
- * This method returns a {@link ListenerRegistration} object. To
- * "unregister" your listener for changes call the "close" method on this
- * returned object.
- * <p>
- * You MUST call close when you no longer need to receive notifications
- * (such as during shutdown or for example if your bundle is shutting down).
- *
- * @param store
- * Logical Data Store - Logical Datastore you want to listen for
- * changes in. For example
- * {@link LogicalDatastoreType#OPERATIONAL} or
- * {@link LogicalDatastoreType#CONFIGURATION}
- * @param path
- * Path (subtree identifier) on which client listener will be
- * invoked.
- * @param listener
- * Instance of listener which should be invoked on
- * @param triggeringScope
- * Scope of change which triggers callback.
- * @return Listener registration object, which may be used to unregister
- * your listener using {@link ListenerRegistration#close()} to stop
- * delivery of change events.
- */
- ListenerRegistration<L> registerDataChangeListener(LogicalDatastoreType store, P path, L listener,
- DataChangeScope triggeringScope);
+ AsyncWriteTransaction<P, D> newWriteOnlyTransaction();
}