X-Git-Url: https://git.opendaylight.org/gerrit/gitweb?a=blobdiff_plain;f=yang%2Fyang-data-api%2Fsrc%2Fmain%2Fjava%2Forg%2Fopendaylight%2Fyangtools%2Fyang%2Fdata%2Fapi%2Fschema%2FAugmentationNode.java;h=71fa5c705a47a6395bfdf92a0fd71d6e66cc071f;hb=06452ecebb1998538c59a0a5ed47f47034045af5;hp=ef9d6b9918ed5c7090e98788d245c7f48a70fbf1;hpb=6e5d0f5533b9c7eb029f477a5fe2f74b0c8882e8;p=yangtools.git
diff --git a/yang/yang-data-api/src/main/java/org/opendaylight/yangtools/yang/data/api/schema/AugmentationNode.java b/yang/yang-data-api/src/main/java/org/opendaylight/yangtools/yang/data/api/schema/AugmentationNode.java
index ef9d6b9918..71fa5c705a 100644
--- a/yang/yang-data-api/src/main/java/org/opendaylight/yangtools/yang/data/api/schema/AugmentationNode.java
+++ b/yang/yang-data-api/src/main/java/org/opendaylight/yangtools/yang/data/api/schema/AugmentationNode.java
@@ -7,16 +7,19 @@
*/
package org.opendaylight.yangtools.yang.data.api.schema;
-import org.opendaylight.yangtools.yang.data.api.InstanceIdentifier;
-import org.opendaylight.yangtools.yang.data.api.InstanceIdentifier.AugmentationIdentifier;
-import org.opendaylight.yangtools.yang.data.api.InstanceIdentifier.PathArgument;
-
-import com.google.common.base.Optional;
+import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier;
+import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier.AugmentationIdentifier;
+import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier.PathArgument;
+import org.opendaylight.yangtools.yang.model.api.AugmentationSchema;
/**
*
- * Node representing Augmentation.
+ * Data instance of augment
assiociated with parent node.
+ *
+ * Augmentation is addition of subtree defined by other external YANG Model and
+ * is schema for subtree is described by instance of {@link AugmentationSchema}
+ * associated with parent node of this node.
*
* Augmentation node MUST NOT be direct child of other augmentation node.
*
@@ -24,15 +27,23 @@ import com.google.common.base.Optional;
public interface AugmentationNode extends //
MixinNode, //
DataContainerNode,
- DataContainerChild>> {
-
- @Override
- public Iterable> getValue();
-
-
- @Override
- public Optional> getChild(PathArgument child);
-
+ DataContainerChild>> {
+
+ /**
+ * Gets identifier of augmentation node
+ *
+ * Returned identifier of augmentation node contains all possible
+ * direct child QNames.
+ *
+ * This is sufficient to identify instance of augmentation,
+ * since RFC6020 states that augment
that augment
+ * statement must not add multiple nodes from same namespace
+ * / module
+ * to the target node.
+ *
+ * @return Identifier which uniquelly identifies augmentation in particular subtree.
+ *
+ */
@Override
public AugmentationIdentifier getIdentifier();
}