/*
- * Copyright (c) 2013 Cisco Systems, Inc. and others. All rights reserved.
+ * Copyright (c) 2013 Cisco Systems, Inc. and others. All rights reserved.
+ *
* This program and the accompanying materials are made available under the
* terms of the Eclipse Public License v1.0 which accompanies this distribution,
* and is available at http://www.eclipse.org/legal/epl-v10.html
*/
package org.opendaylight.yangtools.yang.parser.builder.api;
+import java.util.List;
import java.util.Map;
import java.util.Set;
import org.opendaylight.yangtools.yang.common.QName;
* Common builder for for all YANG {@link DataNodeContainer}
* <code>augment, case, container,
* grouping, list, module, notification</code>.
+ *
+ * @deprecated Pre-Beryllium implementation, scheduled for removal.
*/
+@Deprecated
public interface DataNodeContainerBuilder extends Builder {
/**
SchemaPath getPath();
/**
- * Returns set of of child node builders.
+ * Returns list of of child node builders in order they are declared in yang
+ * file.
*
* This child node builder are build, during invoking {@link #build()} and
* added as children to resulting {@link DataNodeContainer}.
*
* @return collection child nodes builders
*/
- Set<DataSchemaNodeBuilder> getChildNodeBuilders();
+ List<DataSchemaNodeBuilder> getChildNodeBuilders();
/**
* Retrieves child node builder by local name.
/**
* Add builder of child node to this node.
*
- * @param childNode
+ * @param childNode name of child node to add
*/
void addChildNode(DataSchemaNodeBuilder childNode);
+ /**
+ * Add builder of child node to this node at specified position.
+ *
+ * @param index position at which the child node will be added
+ * @param childNode name of child node to add at specified position
+ */
+ void addChildNode(int index, DataSchemaNodeBuilder childNode);
+
void addChildNode(DataSchemaNode childNode);
void addChildNodeToContext(DataSchemaNodeBuilder childNode);
/**
* Add builder of grouping statement to this node.
*
- * @param groupingBuilder
+ * @param groupingBuilder grouping statement builder
*/
void addGrouping(GroupingBuilder groupingBuilder);
*
* @return collection of uses builders
*/
- Set<UsesNodeBuilder> getUsesNodeBuilders();
+ List<UsesNodeBuilder> getUsesNodeBuilders();
/**
* Add builder of uses statement to this node.
*
- * @param usesBuilder
+ * @param usesBuilder uses statement builder
*/
void addUsesNode(UsesNodeBuilder usesBuilder);
/**
* Returns builders of typedef statement defined in this node.
*
- * @return builders of typedef statement defined in this node.
+ * @return builders of typedef statement defined in this node.
*/
Set<TypeDefinitionBuilder> getTypeDefinitionBuilders();
/**
* Add typedef builder to this node.
*
- * @param typedefBuilder Builder to add to this node.
+ * @param typedefBuilder
+ * Builder to add to this node.
*/
void addTypedef(TypeDefinitionBuilder typedefBuilder);
/**
* Returns an instance of product - DataNodeContainer
*
- * Returns an instance of data node container with
- * children and properties constructed as per this builder state,
- * all nested builders are also built and their product is
- * set to DataNodeContainer.
+ * Returns an instance of data node container with children and properties
+ * constructed as per this builder state, all nested builders are also built
+ * and their product is set to DataNodeContainer.
*
* @return Instance of DataNodeContainer
*/
@Override
DataNodeContainer build();
+ /**
+ * Returns map of child nodes of this node. Child nodes should be in same
+ * order as they were defined in yang file.
+ *
+ * @return map of child nodes of this node
+ */
Map<QName, DataSchemaNode> getChildNodes();
}