Fix checkstyle violations in sal-dom-spi
[controller.git] / opendaylight / md-sal / sal-dom-spi / src / main / java / org / opendaylight / controller / sal / core / spi / data / DOMStore.java
index 7a51df9f56c76086224b4e1ddee450c0e43328ff..238aeb91691e14b48dcbc0513f7010968097524f 100644 (file)
@@ -20,6 +20,7 @@ import org.opendaylight.yangtools.yang.data.api.schema.NormalizedNode;
  * DOM Data Store provides transactional tree-like storage for YANG-modeled
  * entities described by YANG schema and represented by {@link NormalizedNode}.
  *
+ * <p>
  * Read and write access to stored data is provided only via transactions
  * created using {@link #newReadOnlyTransaction()},
  * {@link #newWriteOnlyTransaction()} and {@link #newReadWriteTransaction()}, or
@@ -29,12 +30,13 @@ import org.opendaylight.yangtools.yang.data.api.schema.NormalizedNode;
 public interface DOMStore extends DOMStoreTransactionFactory {
 
     /**
-     * Registers {@link org.opendaylight.controller.md.sal.common.api.data.AsyncDataChangeListener} for Data Change callbacks which will
-     * be triggered on the change of provided subpath. What constitutes a change
+     * Registers {@link org.opendaylight.controller.md.sal.common.api.data.AsyncDataChangeListener} for Data Change
+     * callbacks which will be triggered on the change of provided subpath. What constitutes a change
      * depends on the @scope parameter.
      *
      * Listener upon registration receives an initial callback
-     * {@link AsyncDataChangeListener#onDataChanged(org.opendaylight.controller.md.sal.common.api.data.AsyncDataChangeEvent)}
+     * {@link AsyncDataChangeListener#onDataChanged(org.opendaylight.controller.md.sal.common.api.data
+     *     .AsyncDataChangeEvent)}
      * which contains stable view of data tree at the time of registration.
      *
      *  @param path Path (subtree identifier) on which client listener will be
@@ -48,21 +50,19 @@ public interface DOMStore extends DOMStoreTransactionFactory {
      *         registration / interest on receiving data changes.
      *
      */
-    <L extends AsyncDataChangeListener<YangInstanceIdentifier, NormalizedNode<?, ?>>> ListenerRegistration<L> registerChangeListener(
-            YangInstanceIdentifier path, L listener, DataChangeScope scope);
+    <L extends AsyncDataChangeListener<YangInstanceIdentifier, NormalizedNode<?, ?>>> ListenerRegistration<L>
+        registerChangeListener(YangInstanceIdentifier path, L listener, DataChangeScope scope);
 
     /**
-     *
      * Creates new transaction chain.
      *
+     * <p>
      * Transactions in a chain need to be committed in sequence and each
      * transaction should see the effects of previous transactions as if they
      * happened.
      *
-     * See {@link DOMStoreTransactionChain} for more information.
-     *
+     * @see DOMStoreTransactionChain for more information.
      * @return Newly created transaction chain.
      */
     DOMStoreTransactionChain createTransactionChain();
-
 }