Fix Module.getVersion()
[yangtools.git] / yang / yang-model-api / src / main / java / org / opendaylight / yangtools / yang / model / api / Module.java
index 211d234b6d11781758ae378ea765a2caa62cbfa1..68ae7c6108b79dce326d3a44d76468e9bf9cc5e2 100644 (file)
@@ -9,58 +9,66 @@ package org.opendaylight.yangtools.yang.model.api;
 
 import java.util.List;
 import java.util.Set;
+import javax.annotation.Nonnull;
 import javax.annotation.concurrent.Immutable;
+import org.opendaylight.yangtools.concepts.SemVer;
+import org.opendaylight.yangtools.yang.common.YangVersion;
 
 /**
  * This interface contains the methods for getting the data from the YANG
- * module.<br />
- * <br />
- * <i>Example of YANG module</i> <code><br/>
- * {@link #getName() <b><font color="#FF0000">module</font></b>} module_name{<br />
-    &nbsp;&nbsp;{@link #getYangVersion() <b><font color="#8b4513">yang-version</font></b>} "1";<br /><br />
+ * module.<br>
+ * <br>
+ * <i>Example of YANG module</i> <code><br>
+ * {@link #getName() <b><font color="#FF0000">module</font></b>} module_name{<br>
+    &nbsp;&nbsp;{@link #getYangVersion() <b><font color="#8b4513">yang-version</font></b>} "1";<br><br>
 
-    &nbsp;&nbsp;{@link #getNamespace() <b><font color="#00FF00">namespace</font></b>} "urn:module:namespace";<br />
-    &nbsp;&nbsp;{@link #getPrefix() <b><font color="#0000FF">prefix</font></b><a name="prefix"></a>} "prefix";<br /><br />
+    &nbsp;&nbsp;{@link #getNamespace() <b><font color="#00FF00">namespace</font></b>} "urn:module:namespace";<br>
+    &nbsp;&nbsp;{@link #getPrefix() <b><font color="#0000FF">prefix</font></b><a name="prefix"></a>} "prefix";<br><br>
 
-    &nbsp;&nbsp;{@link #getDescription() <b><font color="#b8860b">description</font></b>} "description test";<br />
-    &nbsp;&nbsp;{@link #getReference() <b><font color="#008b8b">reference</font></b>} "reference test";<br /><br />
+    &nbsp;&nbsp;{@link #getDescription() <b><font color="#b8860b">description</font></b>} "description test";<br>
+    &nbsp;&nbsp;{@link #getReference() <b><font color="#008b8b">reference</font></b>} "reference test";<br><br>
 
-    &nbsp;&nbsp;{@link #getOrganization() <b><font color="#606060">organization</font></b>} "John Doe, john.doe@email.com";<br />
-    &nbsp;&nbsp;{@link #getContact() <b><font color="#FF9900">contact</font></b>} "http://www.opendaylight.org/";<br /><br />
+    &nbsp;&nbsp;{@link #getOrganization() <b><font color="#606060">organization</font></b>}
+    "John Doe, john.doe@email.com";<br>
+    &nbsp;&nbsp;{@link #getContact() <b><font color="#FF9900">contact</font></b>} "http://www.opendaylight.org/";<br>
+    <br>
 
-    &nbsp;&nbsp;{@link #getFeatures() <b><font color="#8b0000">feature</font></b>} feature-test{<br />
-    &nbsp;&nbsp;&nbsp;&nbsp; description "description of some feature";<br />
-    &nbsp;&nbsp;}</br>
+    &nbsp;&nbsp;{@link #getFeatures() <b><font color="#8b0000">feature</font></b>} feature-test{<br>
+    &nbsp;&nbsp;&nbsp;&nbsp; description "description of some feature";<br>
+    &nbsp;&nbsp;}<br>
 
-    &nbsp;&nbsp;{@link #getNotifications() <b><font color="#b22222">notification</font></b>} notification-test;<br />
-    &nbsp;&nbsp;{@link #getRpcs() <b><font color="#d2691e">rpc</font></b>} rpc-test;<br />
-    <!-- &nbsp;&nbsp;{@link #getDeviations() <b><font color="#b8860b">deviation</font></b>} deviation-test;<br /> -->
-    &nbsp;&nbsp;{@link #getIdentities() <b><font color="#bdb76b">identity</font></b>} identity-test;<br />
-    &nbsp;&nbsp;{@link #getExtensionSchemaNodes() <b><font color="#808000">extension</font></b>} extension-test;<br />
+    &nbsp;&nbsp;{@link #getNotifications() <b><font color="#b22222">notification</font></b>} notification-test;<br>
+    &nbsp;&nbsp;{@link #getRpcs() <b><font color="#d2691e">rpc</font></b>} rpc-test;<br>
+    <!-- &nbsp;&nbsp;{@link #getDeviations() <b><font color="#b8860b">deviation</font></b>} deviation-test;<br> -->
+    &nbsp;&nbsp;{@link #getIdentities() <b><font color="#bdb76b">identity</font></b>} identity-test;<br>
+    &nbsp;&nbsp;{@link #getExtensionSchemaNodes() <b><font color="#808000">extension</font></b>} extension-test;<br>
 
 
-    &nbsp;&nbsp;{@link #getRevision() <b><font color="#339900">revision</font></b>} 2011-08-27 {<br />
+    &nbsp;&nbsp;{@link #getRevision() <b><font color="#339900">revision</font></b>} 2011-08-27 {<br>
 
-    &nbsp;&nbsp;{@link #getImports() <b><font color="#9400d3">import</font></b>} other_module {<br />
-    &nbsp;&nbsp;&nbsp;&nbsp;prefix "other_module_prefix"<br />
-    &nbsp;&nbsp;&nbsp;&nbsp;revision-date 2011-08-27<br />
-    &nbsp;&nbsp;}<br /><br />
+    &nbsp;&nbsp;{@link #getImports() <b><font color="#9400d3">import</font></b>} other_module {<br>
+    &nbsp;&nbsp;&nbsp;&nbsp;prefix "other_module_prefix"<br>
+    &nbsp;&nbsp;&nbsp;&nbsp;revision-date 2011-08-27<br>
+    &nbsp;&nbsp;}<br><br>
 
-    &nbsp;&nbsp;container cont {<br />
-    &nbsp;&nbsp;}<br />
+    &nbsp;&nbsp;container cont {<br>
+    &nbsp;&nbsp;}<br>
 
-    &nbsp;&nbsp;{@link #getAugmentations() <b><font color="#dc143c">augment</font></b>} "/cont" { ;<br />
-    &nbsp;&nbsp;}<br />
+    &nbsp;&nbsp;{@link #getAugmentations() <b><font color="#dc143c">augment</font></b>} "/cont" { ;<br>
+    &nbsp;&nbsp;}<br>
     }
 
     </code>
  */
 @Immutable
-public interface Module extends DataNodeContainer, SourceStreamAware, ModuleIdentifier {
-
+public interface Module extends DataNodeContainer, ModuleIdentifier, NotificationNodeContainer {
+    /**
+     * Default semantic version of Module.
+     */
+    SemVer DEFAULT_SEMANTIC_VERSION = SemVer.create(0, 0, 0);
 
     /**
-     * Returns the prefix of the module
+     * Returns the prefix of the module.
      *
      * @return string with the module prefix which is specified as argument of
      *         YANG {@link Module <b><font color="#0000FF">prefix</font></b>}
@@ -71,13 +79,9 @@ public interface Module extends DataNodeContainer, SourceStreamAware, ModuleIden
     /**
      * Returns the YANG version.
      *
-     * Default value is 1.
-     *
-     * @return string with the module YANG version which is specified as
-     *         argument of YANG {@link Module <b> <font
-     *         color="#8b4513">yang-version</font></b>} keyword
+     * @return YANG version of this module.
      */
-    String getYangVersion();
+    YangVersion getYangVersion();
 
     /**
      * Returns the module description.
@@ -109,6 +113,7 @@ public interface Module extends DataNodeContainer, SourceStreamAware, ModuleIden
     /**
      * Returns the module contact.
      *
+     * <p>
      * The contact represents the person or persons to whom technical queries
      * concerning this module should be sent, such as their name, postal
      * address, telephone number, and electronic mail address.
@@ -129,10 +134,13 @@ public interface Module extends DataNodeContainer, SourceStreamAware, ModuleIden
      */
     Set<ModuleImport> getImports();
 
+    Set<Module> getSubmodules();
+
     /**
      * Returns <code>FeatureDefinition</code> instances which contain data from
      * <b>feature</b> statements defined in the module.
      *
+     * <p>
      * The feature is used to define a mechanism by which portions of the schema
      * are marked as conditional.
      *
@@ -142,16 +150,6 @@ public interface Module extends DataNodeContainer, SourceStreamAware, ModuleIden
      */
     Set<FeatureDefinition> getFeatures();
 
-    /**
-     * Returns <code>NotificationDefinition</code> instances which contain data
-     * from <b>notification</b> statements defined in the module.
-     *
-     * @return notification statements in lexicographical order which are
-     *         specified in the module as the argument of YANG {@link Module
-     *         <b><font color="#b22222">notification</font></b>} keywords.
-     */
-    Set<NotificationDefinition> getNotifications();
-
     /**
      * Returns <code>AugmentationSchema</code> instances which contain data from
      * <b>augment</b> statements defined in the module.
@@ -209,11 +207,6 @@ public interface Module extends DataNodeContainer, SourceStreamAware, ModuleIden
      *
      * @return unknown nodes in lexicographical order
      */
+    @Nonnull
     List<UnknownSchemaNode> getUnknownSchemaNodes();
-
-    /**
-     * Get yang source.
-     */
-    String getSource();
-
 }