-/*\r
- * Copyright (c) 2013 Cisco Systems, Inc. and others. All rights reserved.\r
- *\r
- * This program and the accompanying materials are made available under the\r
- * terms of the Eclipse Public License v1.0 which accompanies this distribution,\r
- * and is available at http://www.eclipse.org/legal/epl-v10.html\r
- */\r
-package org.opendaylight.yangtools.yang.model.api;\r
-\r
-import java.net.URI;\r
-import java.util.Date;\r
-import java.util.List;\r
-import java.util.Set;\r
-\r
-public interface Module extends DataNodeContainer {\r
-\r
- URI getNamespace();\r
-\r
- String getName();\r
-\r
- Date getRevision();\r
-\r
- String getPrefix();\r
-\r
- String getYangVersion();\r
-\r
- String getDescription();\r
-\r
- String getReference();\r
-\r
- String getOrganization();\r
-\r
- String getContact();\r
-\r
- Set<ModuleImport> getImports();\r
-\r
- /**\r
- * Returns feature statements defined in module.\r
- *\r
- * @return feature statements in lexicographical order\r
- */\r
- Set<FeatureDefinition> getFeatures();\r
-\r
- /**\r
- * Returns notification statements defined in module.\r
- *\r
- * @return notification statements in lexicographical order\r
- */\r
- Set<NotificationDefinition> getNotifications();\r
-\r
- /**\r
- * Returns augment statements defined in module.\r
- *\r
- * @return augment statements\r
- */\r
- Set<AugmentationSchema> getAugmentations();\r
-\r
- /**\r
- * Returns rpc statements defined in module.\r
- *\r
- * @return rpc statements in lexicographical order\r
- */\r
- Set<RpcDefinition> getRpcs();\r
-\r
- /**\r
- * Returns deviation statements defined in module.\r
- *\r
- * @return deviation statements\r
- */\r
- Set<Deviation> getDeviations();\r
-\r
- /**\r
- * Returns identity statements defined in module.\r
- *\r
- * @return identity statements in lexicographical order\r
- */\r
- Set<IdentitySchemaNode> getIdentities();\r
-\r
- /**\r
- * Returns extension statements defined in module.\r
- *\r
- * @return extension statements in lexicographical order\r
- */\r
- List<ExtensionDefinition> getExtensionSchemaNodes();\r
-\r
- /**\r
- * Returns unknown nodes defined in module.\r
- *\r
- * @return unknown nodes in lexicographical order\r
- */\r
- List<UnknownSchemaNode> getUnknownSchemaNodes();\r
-\r
-}\r
+/*
+ * 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.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>
+ {@link #getYangVersion() <b><font color="#8b4513">yang-version</font></b>} "1";<br><br>
+
+ {@link #getNamespace() <b><font color="#00FF00">namespace</font></b>} "urn:module:namespace";<br>
+ {@link #getPrefix() <b><font color="#0000FF">prefix</font></b><a name="prefix"></a>} "prefix";<br><br>
+
+ {@link #getDescription() <b><font color="#b8860b">description</font></b>} "description test";<br>
+ {@link #getReference() <b><font color="#008b8b">reference</font></b>} "reference test";<br><br>
+
+ {@link #getOrganization() <b><font color="#606060">organization</font></b>}
+ "John Doe, john.doe@email.com";<br>
+ {@link #getContact() <b><font color="#FF9900">contact</font></b>} "http://www.opendaylight.org/";<br>
+ <br>
+
+ {@link #getFeatures() <b><font color="#8b0000">feature</font></b>} feature-test{<br>
+ description "description of some feature";<br>
+ }<br>
+
+ {@link #getNotifications() <b><font color="#b22222">notification</font></b>} notification-test;<br>
+ {@link #getRpcs() <b><font color="#d2691e">rpc</font></b>} rpc-test;<br>
+ <!-- {@link #getDeviations() <b><font color="#b8860b">deviation</font></b>} deviation-test;<br> -->
+ {@link #getIdentities() <b><font color="#bdb76b">identity</font></b>} identity-test;<br>
+ {@link #getExtensionSchemaNodes() <b><font color="#808000">extension</font></b>} extension-test;<br>
+
+
+ {@link #getRevision() <b><font color="#339900">revision</font></b>} 2011-08-27 {<br>
+
+ {@link #getImports() <b><font color="#9400d3">import</font></b>} other_module {<br>
+ prefix "other_module_prefix"<br>
+ revision-date 2011-08-27<br>
+ }<br><br>
+
+ container cont {<br>
+ }<br>
+
+ {@link #getAugmentations() <b><font color="#dc143c">augment</font></b>} "/cont" { ;<br>
+ }<br>
+ }
+
+ </code>
+ */
+@Immutable
+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.
+ *
+ * @return string with the module prefix which is specified as argument of
+ * YANG {@link Module <b><font color="#0000FF">prefix</font></b>}
+ * keyword
+ */
+ String getPrefix();
+
+ /**
+ * Returns the YANG version.
+ *
+ * @return YANG version of this module.
+ */
+ YangVersion getYangVersion();
+
+ /**
+ * Returns the module description.
+ *
+ * @return string with the module description which is specified as argument
+ * of YANG {@link Module <b><font
+ * color="#b8860b">description</font></b>} keyword
+ */
+ String getDescription();
+
+ /**
+ * Returns the module reference.
+ *
+ * @return string with the module reference which is specified as argument
+ * of YANG {@link Module <b><font
+ * color="#008b8b">reference</font></b>} keyword
+ */
+ String getReference();
+
+ /**
+ * Returns the module organization.
+ *
+ * @return string with the name of the organization specified in the module
+ * as the argument of YANG {@link Module <b><font
+ * color="#606060">organization</font></b>} keyword
+ */
+ String getOrganization();
+
+ /**
+ * 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.
+ *
+ * @return string with the contact data specified in the module as the
+ * argument of YANG {@link Module <b><font
+ * color="#FF9900">contact</font></b>} keyword
+ */
+ String getContact();
+
+ /**
+ * Returns imports which represents YANG modules which are imported to this
+ * module via <b>import</b> statement.
+ *
+ * @return set of module imports which are specified in the module as the
+ * argument of YANG {@link Module <b><font
+ * color="#9400d3">import</font></b>} keywords.
+ */
+ 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.
+ *
+ * @return feature statements in lexicographical order which are specified
+ * in the module as the argument of YANG {@link Module <b><font
+ * color="#8b0000">feature</font></b>} keywords.
+ */
+ Set<FeatureDefinition> getFeatures();
+
+ /**
+ * Returns <code>AugmentationSchema</code> instances which contain data from
+ * <b>augment</b> statements defined in the module.
+ *
+ * @return set of the augmentation schema instances which are specified in
+ * the module as YANG {@link Module <b><font
+ * color="#dc143c">augment</font></b>} keyword and are
+ * lexicographically ordered
+ */
+ Set<AugmentationSchema> getAugmentations();
+
+ /**
+ * Returns <code>RpcDefinition</code> instances which contain data from
+ * <b>rpc</b> statements defined in the module.
+ *
+ * @return set of the rpc definition instances which are specified in the
+ * module as YANG {@link Module <b><font
+ * color="#d2691e">rpc</font></b>} keywords and are lexicographicaly
+ * ordered
+ */
+ Set<RpcDefinition> getRpcs();
+
+ /**
+ * Returns <code>Deviation</code> instances which contain data from
+ * <b>deviation</b> statements defined in the module.
+ *
+ * @return set of the deviation instances
+ */
+ Set<Deviation> getDeviations();
+
+ /**
+ * Returns <code>IdentitySchemaNode</code> instances which contain data from
+ * <b>identity</b> statements defined in the module.
+ *
+ * @return set of identity schema node instances which are specified in the
+ * module as YANG {@link Module <b><font
+ * color="#bdb76b">identity</font></b>} keywords and are
+ * lexicographically ordered
+ */
+ Set<IdentitySchemaNode> getIdentities();
+
+ /**
+ * Returns <code>ExtensionDefinition</code> instances which contain data
+ * from <b>extension</b> statements defined in the module.
+ *
+ * @return set of extension definition instances which are specified in the
+ * module as YANG {@link Module <b><font
+ * color="#808000">extension</font></b>} keyword and are
+ * lexicographically ordered
+ */
+ List<ExtensionDefinition> getExtensionSchemaNodes();
+
+ /**
+ * Returns unknown nodes defined in module.
+ *
+ * @return unknown nodes in lexicographical order
+ */
+ @Nonnull
+ List<UnknownSchemaNode> getUnknownSchemaNodes();
+}