BUG-2138: Create DistributedShardFrontend
[controller.git] / opendaylight / md-sal / sal-distributed-datastore / src / main / java / org / opendaylight / controller / cluster / datastore / shardstrategy / ShardStrategy.java
index 9a05c381ea556aeccf10013952aab453282c3dba..0a4c54b656bad9c77e4f2500c5df72c64d14819a 100644 (file)
@@ -11,17 +11,25 @@ package org.opendaylight.controller.cluster.datastore.shardstrategy;
 import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier;
 
 /**
- * The role of ShardStrategy is to figure out which Shards a given piece of data belongs to
+ * The role of ShardStrategy is to figure out which shards a given piece of data belongs to.
  */
 public interface ShardStrategy {
-  /**
-   * Find the name of the shard in which the data pointed to by the specified path belongs in
-   * <p>
-   * Should return the name of the default shard DefaultShardStrategy.DEFAULT_SHARD
-   * if no matching shard was found
-   *
-   * @param path The location of the data in the logical tree
-   * @return
-   */
-  String findShard(YangInstanceIdentifier path);
+    /**
+     * Find the name of the shard in which the data pointed to by the specified path belongs in.
+     *
+     * <p>
+     * Should return the name of the default shard DefaultShardStrategy.DEFAULT_SHARD
+     * if no matching shard was found
+     *
+     * @param path the location of the data in the logical tree
+     * @return the corresponding shard name.
+     */
+    String findShard(YangInstanceIdentifier path);
+
+    /**
+     * Get the prefix of the shard that contains the data pointed to by the specified path.
+     * @param path the location of the data in the logical tree.
+     * @return the corresponding shards prefix.
+     */
+    YangInstanceIdentifier getPrefixForPath(YangInstanceIdentifier path);
 }