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.model.api;
10 import java.util.List;
12 import javax.annotation.Nonnull;
13 import javax.annotation.Nullable;
14 import javax.annotation.concurrent.Immutable;
15 import org.opendaylight.yangtools.concepts.SemVer;
18 * This interface contains the methods for getting the data from the YANG
21 * <i>Example of YANG module</i> <code><br>
22 * {@link #getName() <b><font color="#FF0000">module</font></b>} module_name{<br>
23 {@link #getYangVersion() <b><font color="#8b4513">yang-version</font></b>} "1";<br><br>
25 {@link #getNamespace() <b><font color="#00FF00">namespace</font></b>} "urn:module:namespace";<br>
26 {@link #getPrefix() <b><font color="#0000FF">prefix</font></b><a name="prefix"></a>} "prefix";<br><br>
28 {@link #getDescription() <b><font color="#b8860b">description</font></b>} "description test";<br>
29 {@link #getReference() <b><font color="#008b8b">reference</font></b>} "reference test";<br><br>
31 {@link #getOrganization() <b><font color="#606060">organization</font></b>}
32 "John Doe, john.doe@email.com";<br>
33 {@link #getContact() <b><font color="#FF9900">contact</font></b>} "http://www.opendaylight.org/";<br>
36 {@link #getFeatures() <b><font color="#8b0000">feature</font></b>} feature-test{<br>
37 description "description of some feature";<br>
40 {@link #getNotifications() <b><font color="#b22222">notification</font></b>} notification-test;<br>
41 {@link #getRpcs() <b><font color="#d2691e">rpc</font></b>} rpc-test;<br>
42 <!-- {@link #getDeviations() <b><font color="#b8860b">deviation</font></b>} deviation-test;<br> -->
43 {@link #getIdentities() <b><font color="#bdb76b">identity</font></b>} identity-test;<br>
44 {@link #getExtensionSchemaNodes() <b><font color="#808000">extension</font></b>} extension-test;<br>
47 {@link #getRevision() <b><font color="#339900">revision</font></b>} 2011-08-27 {<br>
49 {@link #getImports() <b><font color="#9400d3">import</font></b>} other_module {<br>
50 prefix "other_module_prefix"<br>
51 revision-date 2011-08-27<br>
54 container cont {<br>
57 {@link #getAugmentations() <b><font color="#dc143c">augment</font></b>} "/cont" { ;<br>
64 public interface Module extends DataNodeContainer, SourceStreamAware, ModuleIdentifier, NotificationNodeContainer {
66 * Default semantic version of Module.
68 SemVer DEFAULT_SEMANTIC_VERSION = SemVer.create(0, 0, 0);
71 * Returns the prefix of the module.
73 * @return string with the module prefix which is specified as argument of
74 * YANG {@link Module <b><font color="#0000FF">prefix</font></b>}
80 * Returns the YANG version. Default value is 1.
82 * @return string with the module YANG version which is specified as
83 * argument of YANG {@link Module <b> <font
84 * color="#8b4513">yang-version</font></b>} keyword
86 // FIXME: version 2.0.0: return YangVersion
87 String getYangVersion();
90 * Returns the module description.
92 * @return string with the module description which is specified as argument
93 * of YANG {@link Module <b><font
94 * color="#b8860b">description</font></b>} keyword
96 String getDescription();
99 * Returns the module reference.
101 * @return string with the module reference which is specified as argument
102 * of YANG {@link Module <b><font
103 * color="#008b8b">reference</font></b>} keyword
105 String getReference();
108 * Returns the module organization.
110 * @return string with the name of the organization specified in the module
111 * as the argument of YANG {@link Module <b><font
112 * color="#606060">organization</font></b>} keyword
114 String getOrganization();
117 * Returns the module contact.
120 * The contact represents the person or persons to whom technical queries
121 * concerning this module should be sent, such as their name, postal
122 * address, telephone number, and electronic mail address.
124 * @return string with the contact data specified in the module as the
125 * argument of YANG {@link Module <b><font
126 * color="#FF9900">contact</font></b>} keyword
131 * Returns imports which represents YANG modules which are imported to this
132 * module via <b>import</b> statement.
134 * @return set of module imports which are specified in the module as the
135 * argument of YANG {@link Module <b><font
136 * color="#9400d3">import</font></b>} keywords.
138 Set<ModuleImport> getImports();
140 Set<Module> getSubmodules();
143 * Returns <code>FeatureDefinition</code> instances which contain data from
144 * <b>feature</b> statements defined in the module.
147 * The feature is used to define a mechanism by which portions of the schema
148 * are marked as conditional.
150 * @return feature statements in lexicographical order which are specified
151 * in the module as the argument of YANG {@link Module <b><font
152 * color="#8b0000">feature</font></b>} keywords.
154 Set<FeatureDefinition> getFeatures();
157 * Returns <code>AugmentationSchema</code> instances which contain data from
158 * <b>augment</b> statements defined in the module.
160 * @return set of the augmentation schema instances which are specified in
161 * the module as YANG {@link Module <b><font
162 * color="#dc143c">augment</font></b>} keyword and are
163 * lexicographically ordered
165 Set<AugmentationSchema> getAugmentations();
168 * Returns <code>RpcDefinition</code> instances which contain data from
169 * <b>rpc</b> statements defined in the module.
171 * @return set of the rpc definition instances which are specified in the
172 * module as YANG {@link Module <b><font
173 * color="#d2691e">rpc</font></b>} keywords and are lexicographicaly
176 Set<RpcDefinition> getRpcs();
179 * Returns <code>Deviation</code> instances which contain data from
180 * <b>deviation</b> statements defined in the module.
182 * @return set of the deviation instances
184 Set<Deviation> getDeviations();
187 * Returns <code>IdentitySchemaNode</code> instances which contain data from
188 * <b>identity</b> statements defined in the module.
190 * @return set of identity schema node instances which are specified in the
191 * module as YANG {@link Module <b><font
192 * color="#bdb76b">identity</font></b>} keywords and are
193 * lexicographically ordered
195 Set<IdentitySchemaNode> getIdentities();
198 * Returns <code>ExtensionDefinition</code> instances which contain data
199 * from <b>extension</b> statements defined in the module.
201 * @return set of extension definition instances which are specified in the
202 * module as YANG {@link Module <b><font
203 * color="#808000">extension</font></b>} keyword and are
204 * lexicographically ordered
206 List<ExtensionDefinition> getExtensionSchemaNodes();
209 * Returns unknown nodes defined in module.
211 * @return unknown nodes in lexicographical order
214 List<UnknownSchemaNode> getUnknownSchemaNodes();
219 * @return YANG text of this module, or null if the source is not available.
220 * @deprecated Use {@link org.opendaylight.yangtools.yang.model.repo.api.SchemaRepository#getSchemaSource(
221 * org.opendaylight.yangtools.yang.model.repo.api.SourceIdentifier, Class)} instead.
224 @Nullable String getSource();