Merge "Refactored uses statement handling in parser."

[yangtools.git] / yang / yang-parser-impl / src / main / java / org / opendaylight / yangtools / yang / parser / builder / api / UsesNodeBuilder.java

diff --git a/yang/yang-parser-impl/src/main/java/org/opendaylight/yangtools/yang/parser/builder/api/UsesNodeBuilder.java b/yang/yang-parser-impl/src/main/java/org/opendaylight/yangtools/yang/parser/builder/api/UsesNodeBuilder.java
index a861c45f62d56d5955a145e60ffac4741756bf07..6b827841af9a8459707f1e632e3cc57005006537 100644 (file)
--- a/yang/yang-parser-impl/src/main/java/org/opendaylight/yangtools/yang/parser/builder/api/UsesNodeBuilder.java
+++ b/yang/yang-parser-impl/src/main/java/org/opendaylight/yangtools/yang/parser/builder/api/UsesNodeBuilder.java
@@ -13,6 +13,7 @@ import java.util.Set;
 import org.opendaylight.yangtools.yang.model.api.GroupingDefinition;
 import org.opendaylight.yangtools.yang.model.api.SchemaPath;
 import org.opendaylight.yangtools.yang.model.api.UsesNode;
+import org.opendaylight.yangtools.yang.model.api.YangNode;
 import org.opendaylight.yangtools.yang.parser.builder.impl.UnknownSchemaNodeBuilder;
 import org.opendaylight.yangtools.yang.parser.util.RefineHolder;
 
@@ -21,62 +22,192 @@ import org.opendaylight.yangtools.yang.parser.util.RefineHolder;
  */
 public interface UsesNodeBuilder extends GroupingMember, Builder {
 
+    /**
+     * Get parent of this uses node. Since uses can be defined only under on of
+     * module, container, list, case, grouping, input, output, notification or
+     * augment, return type is DataNodeContainerBuilder.
+     */
     DataNodeContainerBuilder getParent();
 
-    String getGroupingName();
-
+    /**
+     * Get grouping path as string.
+     *
+     * @return grouping path as String
+     */
+    String getGroupingPathAsString();
+
+    /**
+     * Get grouping path.
+     *
+     * @return grouping path as SchemaPath
+     */
     SchemaPath getGroupingPath();
 
+    /**
+     * Get grouping definition.
+     *
+     * @return GroupingDefinition if present, null otherwise
+     */
     GroupingDefinition getGroupingDefinition();
 
+    /**
+     * Set grouping definition.
+     *
+     * @param groupingDefinition
+     *            GroupingDefinition object
+     */
     void setGroupingDefinition(GroupingDefinition groupingDefinition);
 
+    /**
+     * Get grouping builder.
+     *
+     * @return GroupingBuilder if present, null otherwise
+     */
     GroupingBuilder getGroupingBuilder();
 
+    /**
+     * Set grouping builder.
+     *
+     * @param grouping
+     *            GroupingBuilder object
+     */
     void setGrouping(GroupingBuilder grouping);
 
-    Set<AugmentationSchemaBuilder> getAugmentations();
-
-    void addAugment(AugmentationSchemaBuilder builder);
-
+    /**
+     * Get information if this uses node is defined in augment.
+     *
+     * @return true, if this node is defined under augment statement, false
+     *         otherwise
+     */
     boolean isAugmenting();
 
+    /**
+     * Set information if this uses node is defined in augment.
+     *
+     * @param augmenting
+     */
     void setAugmenting(boolean augmenting);
 
+    /**
+     * Get augment under which was this uses node was defined.
+     * <p>
+     * Note: This method may return different object than {@link #getParent()}
+     * if this node is a copy of other uses node. If the uses node is copied,
+     * its parent has changed, but parent augment is always same.
+     * </p>
+     *
+     * @return AugmentationSchemaBuilder under which was this node defined
+     */
+    AugmentationSchemaBuilder getParentAugment();
+
+    /**
+     * Set augment under which was this uses node was defined.
+     *
+     * @param augment
+     */
+    void setParentAugment(AugmentationSchemaBuilder augment);
+
+    /**
+     * Get augmentations defined in this uses node.
+     *
+     * @return set of augmentations defined in this node
+     */
+    Set<AugmentationSchemaBuilder> getAugmentations();
+
+    /**
+     * Add augment builder.
+     *
+     * @param builder
+     *            new builder of augment statement
+     */
+    void addAugment(AugmentationSchemaBuilder builder);
+
+    /**
+     * Get refine statements.
+     *
+     * @return list of RefineHolder objects
+     */
     List<RefineHolder> getRefines();
 
+    /**
+     * Get refined nodes.
+     *
+     * @return List of refined SchemaNodeBuilder objects
+     */
     List<SchemaNodeBuilder> getRefineNodes();
 
+    /**
+     * Add refine statement.
+     *
+     * @param refine
+     *            new RefineHolder object
+     */
     void addRefine(RefineHolder refine);
 
+    /**
+     * Add refine node.
+     *
+     * @param refineNode
+     *            refined DataSchemaNodeBuilder object
+     */
     void addRefineNode(DataSchemaNodeBuilder refineNode);
 
-    UsesNode build();
+    /**
+     * Build new UsesNode object.
+     */
+    UsesNode build(YangNode parent);
 
+    /**
+     * Get child nodes defined in target grouping.
+     *
+     * @return set of DataSchemaNodeBuilder objects
+     */
     Set<DataSchemaNodeBuilder> getTargetChildren();
 
-    void setTargetChildren(Set<DataSchemaNodeBuilder> targetChildren);
-
+    /**
+     * Get groupings defined in target grouping.
+     *
+     * @return set of GroupingBuilder objects
+     */
     Set<GroupingBuilder> getTargetGroupings();
 
-    void setTargetGroupings(Set<GroupingBuilder> targetGroupings);
-
+    /**
+     * Get type definitions defined in target grouping.
+     *
+     * @return set of typedefs defined in target grouping
+     */
     Set<TypeDefinitionBuilder> getTargetTypedefs();
 
-    void setTargetTypedefs(Set<TypeDefinitionBuilder> targetTypedefs);
-
+    /**
+     * Get unknown nodes defined in target grouping.
+     *
+     * @return list of unknown nodes defined in target grouping
+     */
     List<UnknownSchemaNodeBuilder> getTargetUnknownNodes();
 
-    void setTargetUnknownNodes(List<UnknownSchemaNodeBuilder> targetUnknownNodes);
-
+    /**
+     *
+     * @return true, if this object was built based on another UsesNodeBuilder,
+     *         false otherwise
+     */
     boolean isCopy();
 
+    /**
+     *
+     * @return true, if target grouping objects was loaded already, false
+     *         otherwise
+     */
     boolean isDataCollected();
 
+    /**
+     * Set if target grouping objects was loaded already.
+     *
+     * @param dataCollected
+     */
     void setDataCollected(boolean dataCollected);
 
-    boolean isParentUpdated();
+    boolean isResolved();
 
-    void setParentUpdated(boolean parentUpdated);
+    void setResolved(boolean resolved);
 
 }