2 * Copyright (c) 2013 Cisco Systems, Inc. and others. All rights reserved.
4 * This program and the accompanying materials are made available under the
5 * terms of the Eclipse Public License v1.0 which accompanies this distribution,
6 * and is available at http://www.eclipse.org/legal/epl-v10.html
8 package org.opendaylight.yangtools.yang.parser.builder.api;
10 import java.util.List;
12 import org.opendaylight.yangtools.concepts.Mutable;
13 import org.opendaylight.yangtools.yang.parser.builder.impl.UnknownSchemaNodeBuilder;
16 * Parent interface for all builder interfaces.
18 public interface Builder extends Mutable {
21 * Returns name of module in which node created by this builder
26 String getModuleName();
29 * Set name of module in which this node is declared.
32 * @deprecated Module name should be set during creation of builder.
35 void setModuleName(String moduleName);
38 * Get current line in yang file, on which statement
39 * associated with this builder was declared.
41 * @return current line in yang file
46 * Returns parent node builder of this node.
48 * @return parent node builder or null if this is top level node
53 * Set parent of this node.
58 void setParent(Builder parent);
61 * Adds an unknown node builder to this builder.
63 * When product (child) is builded by the {@link #build()}
64 * method, this builder is also built and unknown node is added
65 * as child to the product of this builder.
69 void addUnknownNodeBuilder(UnknownSchemaNodeBuilder unknownNode);
72 * Get builders of unknown nodes defined in this node.
74 * @return collection of UnknownSchemaNodeBuilder objects
76 List<UnknownSchemaNodeBuilder> getUnknownNodes();
79 * Build YANG data model node.
81 * This method should create an instance of YANG data model node. After
82 * creating an instance, this instance should be returned for each call
83 * without repeating build process.
85 * @return YANG data model node