Cleanup checkstyle in yang-{data,model}-api

[yangtools.git] / yang / yang-model-api / src / main / java / org / opendaylight / yangtools / yang / model / api / DataNodeContainer.java

diff --git a/yang/yang-model-api/src/main/java/org/opendaylight/yangtools/yang/model/api/DataNodeContainer.java b/yang/yang-model-api/src/main/java/org/opendaylight/yangtools/yang/model/api/DataNodeContainer.java
index 8b20b2b72f3ee8f0f00444029d162b8f58988283..d07be7d64d8586a0cd3f8fd5c7af7f4aa0f5b262 100644 (file)
--- a/yang/yang-model-api/src/main/java/org/opendaylight/yangtools/yang/model/api/DataNodeContainer.java
+++ b/yang/yang-model-api/src/main/java/org/opendaylight/yangtools/yang/model/api/DataNodeContainer.java
@@ -7,8 +7,8 @@
  */
 package org.opendaylight.yangtools.yang.model.api;
 
+import java.util.Collection;
 import java.util.Set;
-
 import org.opendaylight.yangtools.yang.common.QName;
 
 /**
@@ -25,10 +25,12 @@ public interface DataNodeContainer {
 
     /**
      * Returns set of all child nodes defined within this DataNodeContainer.
+     * Although the return type is a collection, each node is guaranteed to
+     * be present at most once.
      *
      * @return child nodes in lexicographical order
      */
-    Set<DataSchemaNode> getChildNodes();
+    Collection<DataSchemaNode> getChildNodes();
 
     /**
      * Returns set of all groupings defined within this DataNodeContainer.
@@ -38,24 +40,19 @@ public interface DataNodeContainer {
     Set<GroupingDefinition> getGroupings();
 
     /**
+     * Returns the child node corresponding to the specified name.
+     *
      * @param name
-     *            QName of seeked child
+     *            QName of child
      * @return child node of this DataNodeContainer if child with given name is
      *         present, null otherwise
      */
     DataSchemaNode getDataChildByName(QName name);
 
     /**
-     * @param name
-     *            name of seeked child as String
-     * @return child node of this DataNodeContainer if child with given name is
-     *         present, null otherwise
-     */
-    DataSchemaNode getDataChildByName(String name);
-
-    /**
+     * Returns grouping nodes used ny this container.
+     *
      * @return Set of all uses nodes defined within this DataNodeContainer
      */
     Set<UsesNode> getUses();
-
 }