Revert "Bug 4640: Change semantic-version to openconfig-version"

[yangtools.git] / yang / yang-model-api / src / main / java / org / opendaylight / yangtools / yang / model / repo / api / SchemaContextFactory.java

diff --git a/yang/yang-model-api/src/main/java/org/opendaylight/yangtools/yang/model/repo/api/SchemaContextFactory.java b/yang/yang-model-api/src/main/java/org/opendaylight/yangtools/yang/model/repo/api/SchemaContextFactory.java
index 2597e9c185481d8886d4ee65155e74d9264cdc37..91dfc946f4c004df57ed157ba93c3e04d8b02c06 100644 (file)
--- a/yang/yang-model-api/src/main/java/org/opendaylight/yangtools/yang/model/repo/api/SchemaContextFactory.java
+++ b/yang/yang-model-api/src/main/java/org/opendaylight/yangtools/yang/model/repo/api/SchemaContextFactory.java
@@ -3,35 +3,91 @@
  *
  * 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/eplv10.html
+ * and is available at http://www.eclipse.org/legal/epl-v10.html
  */
 package org.opendaylight.yangtools.yang.model.repo.api;
 
 import com.google.common.annotations.Beta;
 import com.google.common.util.concurrent.CheckedFuture;
-
 import java.util.Collection;
-
+import java.util.Set;
 import javax.annotation.Nonnull;
-
+import org.opendaylight.yangtools.yang.common.QName;
 import org.opendaylight.yangtools.yang.model.api.SchemaContext;
 
 /**
- * An asynchronous factory for building {@link SchemaContext} instances
- * based on a specification of what {@link SourceIdentifier}s are required
- * and dynamic recursive resolution.
+ * An asynchronous factory for building {@link SchemaContext} instances based on
+ * a specification of what {@link SourceIdentifier}s are required and dynamic
+ * recursive resolution.
  */
 @Beta
 public interface SchemaContextFactory {
     /**
-     * Create a new schema context containing specified sources, pulling in
-     * any dependencies they may have.
+     * Create a new schema context containing specified sources, pulling in any
+     * dependencies they may have.
+     *
+     * @param requiredSources
+     *            a collection of sources which are required to be present
+     * @return A checked future, which will produce a schema context, or fail
+     *         with an explanation why the creation of the schema context
+     *         failed.
+     */
+    default CheckedFuture<SchemaContext, SchemaResolutionException> createSchemaContext(
+            @Nonnull final Collection<SourceIdentifier> requiredSources) {
+        return createSchemaContext(requiredSources, StatementParserMode.DEFAULT_MODE);
+    }
+
+    /**
+     * Create a new schema context containing specified sources, pulling in any
+     * dependencies they may have.
+     *
+     * @param requiredSources
+     *            a collection of sources which are required to be present
+     * @param statementParserMode
+     *            mode of statement parser
+     * @return A checked future, which will produce a schema context, or fail
+     *         with an explanation why the creation of the schema context
+     *         failed.
+     */
+    default CheckedFuture<SchemaContext, SchemaResolutionException> createSchemaContext(
+            final Collection<SourceIdentifier> requiredSources, final StatementParserMode statementParserMode) {
+        return createSchemaContext(requiredSources, statementParserMode, null);
+    }
+
+    /**
+     * Create a new schema context containing specified sources, pulling in any
+     * dependencies they may have.
+     *
+     * @param requiredSources
+     *            a collection of sources which are required to be present
+     * @param supportedFeatures
+     *            set of supported features based on which all if-feature statements in the
+     *            parsed yang models are resolved
+     * @return A checked future, which will produce a schema context, or fail
+     *         with an explanation why the creation of the schema context
+     *         failed.
+     */
+    default CheckedFuture<SchemaContext, SchemaResolutionException> createSchemaContext(
+            @Nonnull final Collection<SourceIdentifier> requiredSources, final Set<QName> supportedFeatures) {
+        return createSchemaContext(requiredSources, StatementParserMode.DEFAULT_MODE, supportedFeatures);
+    }
+
+    /**
+     * Create a new schema context containing specified sources, pulling in any
+     * dependencies they may have.
      *
-     * @param requiredSources a collection of sources which are required to
-     *                        be present
-     * @return A checked future, which will produce a schema context, or
-     *         fail with an explanation why the creation of the schema context
+     * @param requiredSources
+     *            a collection of sources which are required to be present
+     * @param statementParserMode
+     *            mode of statement parser
+     * @param supportedFeatures
+     *            set of supported features based on which all if-feature statements in the
+     *            parsed yang models are resolved
+     * @return A checked future, which will produce a schema context, or fail
+     *         with an explanation why the creation of the schema context
      *         failed.
      */
-    CheckedFuture<SchemaContext, SchemaResolutionException> createSchemaContext(@Nonnull Collection<SourceIdentifier> requiredSources);
+    CheckedFuture<SchemaContext, SchemaResolutionException> createSchemaContext(
+            Collection<SourceIdentifier> requiredSources, StatementParserMode statementParserMode,
+            Set<QName> supportedFeatures);
 }