Support for a recurive create in AsyncDocumentTree + Javadoc clean up
Change-Id: I2a4a961e24ff34aa106c93d3a8cb9093f10cee72
diff --git a/core/api/src/main/java/org/onosproject/store/service/DocumentTree.java b/core/api/src/main/java/org/onosproject/store/service/DocumentTree.java
index 4255b65..e8e4746 100644
--- a/core/api/src/main/java/org/onosproject/store/service/DocumentTree.java
+++ b/core/api/src/main/java/org/onosproject/store/service/DocumentTree.java
@@ -73,6 +73,17 @@
boolean create(DocumentPath path, V value);
/**
+ * Creates a document tree node by first creating any missing intermediate nodes in the path.
+ *
+ * @param path path for the node to create
+ * @param value the non-null value to be associated with the key
+ * @return returns {@code true} if the mapping could be added successfully, {@code false} if
+ * a node already exists at that path
+ * @throws IllegalDocumentModificationException if {@code path} points to root
+ */
+ boolean createRecursive(DocumentPath path, V value);
+
+ /**
* Conditionally updates a tree node if the current version matches a specified version.
*
* @param path path for the node to create