--- /dev/null
+/*
+ * Copyright (c) 2015 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.parser.stmt.reactor;
+
+import static com.google.common.base.Preconditions.checkState;
+import static java.util.Objects.requireNonNull;
+
+import com.google.common.collect.ImmutableMap;
+import com.google.common.collect.SetMultimap;
+import java.util.Arrays;
+import java.util.Collection;
+import java.util.EnumMap;
+import java.util.Map;
+import java.util.Set;
+import org.eclipse.jdt.annotation.NonNull;
+import org.opendaylight.yangtools.yang.common.QName;
+import org.opendaylight.yangtools.yang.common.QNameModule;
+import org.opendaylight.yangtools.yang.parser.spi.meta.ModelProcessingPhase;
+import org.opendaylight.yangtools.yang.parser.spi.meta.ReactorException;
+import org.opendaylight.yangtools.yang.parser.spi.meta.StatementSupportBundle;
+import org.opendaylight.yangtools.yang.parser.spi.source.StatementStreamSource;
+import org.opendaylight.yangtools.yang.parser.spi.validation.ValidationBundlesNamespace.ValidationBundleType;
+
+public final class CrossSourceStatementReactor {
+ private final ImmutableMap<ModelProcessingPhase, StatementSupportBundle> supportedTerminology;
+ private final ImmutableMap<ValidationBundleType, Collection<?>> supportedValidation;
+
+ CrossSourceStatementReactor(final Map<ModelProcessingPhase, StatementSupportBundle> supportedTerminology,
+ final Map<ValidationBundleType, Collection<?>> supportedValidation) {
+ this.supportedTerminology = ImmutableMap.copyOf(supportedTerminology);
+ this.supportedValidation = ImmutableMap.copyOf(supportedValidation);
+ }
+
+ /**
+ * Create a new {@link Builder}.
+ *
+ * @return A new builder.
+ */
+ public static @NonNull Builder builder() {
+ return new Builder();
+ }
+
+ /**
+ * Start a new reactor build using the default statement parser mode with all features and deviations enabled.
+ *
+ * @return A new {@link BuildAction}.
+ */
+ public @NonNull BuildAction newBuild() {
+ return new BuildAction(supportedTerminology, supportedValidation);
+ }
+
+ public static class Builder implements org.opendaylight.yangtools.concepts.Builder<CrossSourceStatementReactor> {
+ private final Map<ValidationBundleType, Collection<?>> validationBundles =
+ new EnumMap<>(ValidationBundleType.class);
+ private final Map<ModelProcessingPhase, StatementSupportBundle> bundles =
+ new EnumMap<>(ModelProcessingPhase.class);
+
+ public @NonNull Builder setBundle(final ModelProcessingPhase phase, final StatementSupportBundle bundle) {
+ bundles.put(phase, bundle);
+ return this;
+ }
+
+ public @NonNull Builder setValidationBundle(final ValidationBundleType type,
+ final Collection<?> validationBundle) {
+ validationBundles.put(type, validationBundle);
+ return this;
+ }
+
+ @Override
+ public CrossSourceStatementReactor build() {
+ return new CrossSourceStatementReactor(bundles, validationBundles);
+ }
+ }
+
+ public static class BuildAction {
+ private final BuildGlobalContext context;
+ private boolean supportedFeaturesSet = false;
+ private boolean modulesDeviatedByModulesSet = false;
+
+ BuildAction(final ImmutableMap<ModelProcessingPhase, StatementSupportBundle> supportedTerminology,
+ final ImmutableMap<ValidationBundleType, Collection<?>> supportedValidation) {
+ this.context = new BuildGlobalContext(supportedTerminology, supportedValidation);
+ }
+
+ /**
+ * Add main source. All main sources are present in resulting SchemaContext.
+ *
+ * @param source which should be added into main sources
+ * @return This build action, for fluent use.
+ * @throws NullPointerException if @{code source} is null
+ */
+ public @NonNull BuildAction addSource(final StatementStreamSource source) {
+ context.addSource(source);
+ return this;
+ }
+
+ /**
+ * Add main sources. All main sources are present in resulting SchemaContext.
+ *
+ * @param sources which should be added into main sources
+ * @return This build action, for fluent use.
+ * @throws NullPointerException if @{code sources} is null or contains a null element
+ */
+ public @NonNull BuildAction addSources(final StatementStreamSource... sources) {
+ addSources(Arrays.asList(sources));
+ return this;
+ }
+
+ /**
+ * Add main sources. All main sources are present in resulting SchemaContext.
+ *
+ * @param sources which should be added into main sources
+ * @return This build action, for fluent use.
+ * @throws NullPointerException if @{code sources} is null or contains a null element
+ */
+ public @NonNull BuildAction addSources(final @NonNull Collection<? extends StatementStreamSource> sources) {
+ for (final StatementStreamSource source : sources) {
+ context.addSource(requireNonNull(source));
+ }
+ return this;
+ }
+
+ /**
+ * Add a library source. Only library sources required by main sources are present in resulting SchemaContext.
+ * Any other library sources are ignored and this also applies to error reporting.
+ *
+ * <p>
+ * Library sources are not supported in semantic version mode currently.
+ *
+ * @param libSource source which should be added into library sources
+ * @return This build action, for fluent use.
+ * @throws NullPointerException if @{code libSource} is null
+ */
+ public @NonNull BuildAction addLibSource(final StatementStreamSource libSource) {
+ context.addLibSource(libSource);
+ return this;
+ }
+
+ /**
+ * Add library sources. Only library sources required by main sources are present in resulting SchemaContext.
+ * Any other library sources are ignored and this also applies to error reporting.
+ *
+ * <p>
+ * Library sources are not supported in semantic version mode currently.
+ *
+ * @param libSources sources which should be added into library sources
+ * @return This build action, for fluent use.
+ * @throws NullPointerException if @{code libSources} is null or contains a null element
+ */
+ public @NonNull BuildAction addLibSources(final StatementStreamSource... libSources) {
+ addLibSources(Arrays.asList(libSources));
+ return this;
+ }
+
+ /**
+ * Add library sources. Only library sources required by main sources are present in resulting SchemaContext.
+ * Any other library sources are ignored and this also applies to error reporting.
+ *
+ * <p>
+ * Library sources are not supported in semantic version mode currently.
+ *
+ * @param libSources sources which should be added into library sources
+ * @return This build action, for fluent use.
+ * @throws NullPointerException if @{code libSources} is null or contains a null element
+ */
+ public @NonNull BuildAction addLibSources(final Collection<StatementStreamSource> libSources) {
+ for (final StatementStreamSource libSource : libSources) {
+ context.addLibSource(libSource);
+ }
+ return this;
+ }
+
+ /**
+ * Set supported features based on which all if-feature statements in the
+ * parsed YANG modules will be resolved.
+ *
+ * @param supportedFeatures
+ * Set of supported features in the final SchemaContext.
+ * If the set is empty, no features encountered will be supported.
+ * @return This build action, for fluent use.
+ */
+ public @NonNull BuildAction setSupportedFeatures(final @NonNull Set<QName> supportedFeatures) {
+ checkState(!supportedFeaturesSet, "Supported features should be set only once.");
+ context.setSupportedFeatures(requireNonNull(supportedFeatures));
+ supportedFeaturesSet = true;
+ return this;
+ }
+
+ /**
+ * Set YANG modules which can be deviated by specified modules during the parsing process.
+ * Map key (QNameModule) denotes a module which can be deviated by the modules in the Map value.
+ *
+ * @param modulesDeviatedByModules
+ * Map of YANG modules (Map key) which can be deviated by specified modules (Map value) in the final
+ * SchemaContext. If the map is empty, no deviations encountered will be supported.
+ * @return This build action, for fluent use.
+ */
+ public @NonNull BuildAction setModulesWithSupportedDeviations(
+ final @NonNull SetMultimap<QNameModule, QNameModule> modulesDeviatedByModules) {
+ checkState(!modulesDeviatedByModulesSet, "Modules with supported deviations should be set only once.");
+ context.setModulesDeviatedByModules(requireNonNull(modulesDeviatedByModules));
+ modulesDeviatedByModulesSet = true;
+ return this;
+ }
+
+ /**
+ * Build the effective model context.
+ */
+ public ReactorDeclaredModel build() throws ReactorException {
+ return context.build();
+ }
+
+ public EffectiveSchemaContext buildEffective() throws ReactorException {
+ return context.buildEffective();
+ }
+ }
+}
Code Review / yangtools.git / blobdiff