Merge ChoiceStatementSupport
[yangtools.git] / yang / yang-parser-rfc7950 / src / main / java / org / opendaylight / yangtools / yang / parser / rfc7950 / reactor / RFC7950Reactors.java
1 /*
2  * Copyright (c) 2017 Pantheon Technologies, s.r.o. and others.  All rights reserved.
3  *
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
7  */
8 package org.opendaylight.yangtools.yang.parser.rfc7950.reactor;
9
10 import static org.opendaylight.yangtools.yang.common.YangVersion.VERSION_1;
11 import static org.opendaylight.yangtools.yang.common.YangVersion.VERSION_1_1;
12
13 import com.google.common.annotations.Beta;
14 import com.google.common.collect.ImmutableSet;
15 import com.google.common.collect.Sets;
16 import org.eclipse.jdt.annotation.NonNull;
17 import org.opendaylight.yangtools.yang.common.YangVersion;
18 import org.opendaylight.yangtools.yang.parser.openconfig.stmt.OpenConfigVersionSupport;
19 import org.opendaylight.yangtools.yang.parser.rfc7950.namespace.ModuleQNameToPrefix;
20 import org.opendaylight.yangtools.yang.parser.rfc7950.namespace.URIStringToImportPrefix;
21 import org.opendaylight.yangtools.yang.parser.rfc7950.namespace.YangNamespaceContextNamespace;
22 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.XPathSupport;
23 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.action.ActionStatementSupport;
24 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.anydata.AnydataStatementSupport;
25 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.anyxml.AnyxmlStatementSupport;
26 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.argument.ArgumentStatementSupport;
27 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.augment.AugmentImplicitHandlingNamespace;
28 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.augment.AugmentStatementRFC6020Support;
29 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.augment.AugmentStatementRFC7950Support;
30 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.base.BaseStatementSupport;
31 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.belongs_to.BelongsToStatementSupport;
32 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.bit.BitStatementSupport;
33 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.case_.CaseStatementSupport;
34 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.choice.ChoiceStatementSupport;
35 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.config.ConfigStatementSupport;
36 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.contact.ContactStatementSupport;
37 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.container.ContainerStatementRFC6020Support;
38 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.container.ContainerStatementRFC7950Support;
39 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.default_.DefaultStatementSupport;
40 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.description.DescriptionStatementSupport;
41 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.deviate.DeviateStatementRFC6020Support;
42 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.deviate.DeviateStatementRFC7950Support;
43 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.deviation.DeviationStatementSupport;
44 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.enum_.EnumStatementRFC6020Support;
45 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.enum_.EnumStatementRFC7950Support;
46 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.error_app_tag.ErrorAppTagStatementSupport;
47 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.error_message.ErrorMessageStatementSupport;
48 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.extension.ExtensionStatementSupport;
49 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.feature.FeatureStatementSupport;
50 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.fraction_digits.FractionDigitsStatementSupport;
51 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.grouping.GroupingStatementRFC6020Support;
52 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.grouping.GroupingStatementRFC7950Support;
53 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.identity.IdentityStatementSupport;
54 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.if_feature.IfFeatureStatementRFC6020Support;
55 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.if_feature.IfFeatureStatementRFC7950Support;
56 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.import_.ImportStatementRFC6020Support;
57 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.import_.ImportStatementRFC7950Support;
58 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.include.IncludeStatementRFC6020Support;
59 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.include.IncludeStatementRFC7950Support;
60 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.input.InputStatementRFC6020Support;
61 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.input.InputStatementRFC7950Support;
62 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.key.KeyStatementSupport;
63 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.leaf.LeafStatementSupport;
64 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.leaf_list.LeafListStatementRFC6020Support;
65 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.leaf_list.LeafListStatementRFC7950Support;
66 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.length.LengthStatementSupport;
67 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.list.ConfigListWarningNamespace;
68 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.list.ListStatementRFC6020Support;
69 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.list.ListStatementRFC7950Support;
70 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.mandatory.MandatoryStatementSupport;
71 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.max_elements.MaxElementsStatementSupport;
72 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.min_elements.MinElementsStatementSupport;
73 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.modifier.ModifierStatementSupport;
74 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.module.ModuleStatementSupport;
75 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.must.MustStatementSupport;
76 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.namespace.NamespaceStatementSupport;
77 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.notification.NotificationStatementRFC6020Support;
78 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.notification.NotificationStatementRFC7950Support;
79 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.ordered_by.OrderedByStatementSupport;
80 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.organization.OrganizationStatementSupport;
81 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.output.OutputStatementRFC6020Support;
82 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.output.OutputStatementRFC7950Support;
83 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.path.PathStatementSupport;
84 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.pattern.PatternStatementRFC6020Support;
85 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.pattern.PatternStatementRFC7950Support;
86 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.position.PositionStatementSupport;
87 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.prefix.PrefixStatementSupport;
88 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.presence.PresenceStatementSupport;
89 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.range.RangeStatementSupport;
90 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.reference.ReferenceStatementSupport;
91 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.refine.RefineStatementSupport;
92 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.require_instance.RequireInstanceStatementSupport;
93 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.revision.RevisionStatementSupport;
94 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.revision_date.RevisionDateStatementSupport;
95 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.rpc.RpcStatementRFC6020Support;
96 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.rpc.RpcStatementRFC7950Support;
97 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.status.StatusStatementSupport;
98 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.submodule.SubmoduleStatementRFC6020Support;
99 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.submodule.SubmoduleStatementRFC7950Support;
100 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.type.BaseTypeNamespace;
101 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.type.TypeStatementRFC6020Support;
102 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.type.TypeStatementRFC7950Support;
103 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.typedef.TypedefStatementSupport;
104 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.unique.UniqueStatementSupport;
105 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.units.UnitsStatementSupport;
106 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.uses.SourceGroupingNamespace;
107 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.uses.UsesStatementSupport;
108 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.value.ValueStatementSupport;
109 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.when.WhenStatementSupport;
110 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.yang_version.YangVersionStatementSupport;
111 import org.opendaylight.yangtools.yang.parser.rfc7950.stmt.yin_element.YinElementStatementSupport;
112 import org.opendaylight.yangtools.yang.parser.spi.ExtensionNamespace;
113 import org.opendaylight.yangtools.yang.parser.spi.FeatureNamespace;
114 import org.opendaylight.yangtools.yang.parser.spi.GroupingNamespace;
115 import org.opendaylight.yangtools.yang.parser.spi.IdentityNamespace;
116 import org.opendaylight.yangtools.yang.parser.spi.ModuleNamespace;
117 import org.opendaylight.yangtools.yang.parser.spi.NamespaceToModule;
118 import org.opendaylight.yangtools.yang.parser.spi.PreLinkageModuleNamespace;
119 import org.opendaylight.yangtools.yang.parser.spi.SchemaTreeNamespace;
120 import org.opendaylight.yangtools.yang.parser.spi.SubmoduleNamespace;
121 import org.opendaylight.yangtools.yang.parser.spi.TypeNamespace;
122 import org.opendaylight.yangtools.yang.parser.spi.meta.ModelProcessingPhase;
123 import org.opendaylight.yangtools.yang.parser.spi.meta.SemanticVersionModuleNamespace;
124 import org.opendaylight.yangtools.yang.parser.spi.meta.SemanticVersionNamespace;
125 import org.opendaylight.yangtools.yang.parser.spi.meta.StatementDefinitionNamespace;
126 import org.opendaylight.yangtools.yang.parser.spi.meta.StatementSupportBundle;
127 import org.opendaylight.yangtools.yang.parser.spi.source.BelongsToModuleContext;
128 import org.opendaylight.yangtools.yang.parser.spi.source.BelongsToPrefixToModuleCtx;
129 import org.opendaylight.yangtools.yang.parser.spi.source.BelongsToPrefixToModuleName;
130 import org.opendaylight.yangtools.yang.parser.spi.source.ImpPrefixToNamespace;
131 import org.opendaylight.yangtools.yang.parser.spi.source.ImportPrefixToModuleCtx;
132 import org.opendaylight.yangtools.yang.parser.spi.source.ImportPrefixToSemVerSourceIdentifier;
133 import org.opendaylight.yangtools.yang.parser.spi.source.ImportedModuleContext;
134 import org.opendaylight.yangtools.yang.parser.spi.source.IncludedModuleContext;
135 import org.opendaylight.yangtools.yang.parser.spi.source.IncludedSubmoduleNameToModuleCtx;
136 import org.opendaylight.yangtools.yang.parser.spi.source.ModuleCtxToModuleQName;
137 import org.opendaylight.yangtools.yang.parser.spi.source.ModuleCtxToSourceIdentifier;
138 import org.opendaylight.yangtools.yang.parser.spi.source.ModuleNameToModuleQName;
139 import org.opendaylight.yangtools.yang.parser.spi.source.ModuleNameToNamespace;
140 import org.opendaylight.yangtools.yang.parser.spi.source.ModuleNamespaceForBelongsTo;
141 import org.opendaylight.yangtools.yang.parser.spi.source.ModuleQNameToModuleName;
142 import org.opendaylight.yangtools.yang.parser.spi.source.ModulesDeviatedByModules;
143 import org.opendaylight.yangtools.yang.parser.spi.source.PrefixToModule;
144 import org.opendaylight.yangtools.yang.parser.spi.source.QNameToStatementDefinition;
145 import org.opendaylight.yangtools.yang.parser.spi.source.SupportedFeaturesNamespace;
146 import org.opendaylight.yangtools.yang.parser.spi.validation.ValidationBundlesNamespace;
147 import org.opendaylight.yangtools.yang.parser.spi.validation.ValidationBundlesNamespace.ValidationBundleType;
148 import org.opendaylight.yangtools.yang.parser.stmt.reactor.CrossSourceStatementReactor;
149 import org.opendaylight.yangtools.yang.xpath.api.YangXPathParserFactory;
150
151 /**
152  * Utility class holding entrypoints for assembling RFC6020/RFC7950 statement {@link CrossSourceStatementReactor}s.
153  *
154  * @author Robert Varga
155  */
156 @Beta
157 public final class RFC7950Reactors {
158     private static final ImmutableSet<YangVersion> SUPPORTED_VERSIONS = Sets.immutableEnumSet(VERSION_1, VERSION_1_1);
159
160     private static final StatementSupportBundle INIT_BUNDLE = StatementSupportBundle.builder(SUPPORTED_VERSIONS)
161             .addSupport(ValidationBundlesNamespace.BEHAVIOUR)
162             .addSupport(SupportedFeaturesNamespace.BEHAVIOUR)
163             .addSupport(ModulesDeviatedByModules.BEHAVIOUR)
164             .build();
165
166     private static final StatementSupportBundle PRE_LINKAGE_BUNDLE = StatementSupportBundle.derivedFrom(INIT_BUNDLE)
167             .addVersionSpecificSupport(VERSION_1, ModuleStatementSupport.rfc6020Instance())
168             .addVersionSpecificSupport(VERSION_1_1, ModuleStatementSupport.rfc7950Instance())
169             .addVersionSpecificSupport(VERSION_1, SubmoduleStatementRFC6020Support.getInstance())
170             .addVersionSpecificSupport(VERSION_1_1, SubmoduleStatementRFC7950Support.getInstance())
171             .addSupport(NamespaceStatementSupport.getInstance())
172             .addVersionSpecificSupport(VERSION_1, ImportStatementRFC6020Support.getInstance())
173             .addVersionSpecificSupport(VERSION_1_1, ImportStatementRFC7950Support.getInstance())
174             .addVersionSpecificSupport(VERSION_1, IncludeStatementRFC6020Support.getInstance())
175             .addVersionSpecificSupport(VERSION_1_1, IncludeStatementRFC7950Support.getInstance())
176             .addSupport(BelongsToStatementSupport.getInstance())
177             .addSupport(PrefixStatementSupport.getInstance())
178             .addSupport(YangVersionStatementSupport.getInstance())
179             .addSupport(RevisionStatementSupport.getInstance())
180             .addSupport(RevisionDateStatementSupport.getInstance())
181             .addSupport(ModuleNameToNamespace.BEHAVIOUR)
182             .addSupport(PreLinkageModuleNamespace.BEHAVIOUR)
183             .addSupport(ImpPrefixToNamespace.BEHAVIOUR)
184             .addSupport(ModuleCtxToModuleQName.BEHAVIOUR)
185             .build();
186
187     private static final StatementSupportBundle LINKAGE_BUNDLE = StatementSupportBundle
188             .derivedFrom(PRE_LINKAGE_BUNDLE)
189             .addSupport(DescriptionStatementSupport.getInstance())
190             .addSupport(ReferenceStatementSupport.getInstance())
191             .addSupport(ContactStatementSupport.getInstance())
192             .addSupport(OrganizationStatementSupport.getInstance())
193             .addSupport(ModuleNamespace.BEHAVIOUR)
194             .addSupport(ModuleNamespaceForBelongsTo.BEHAVIOUR)
195             .addSupport(SubmoduleNamespace.BEHAVIOUR)
196             .addSupport(NamespaceToModule.BEHAVIOUR)
197             .addSupport(ModuleNameToModuleQName.BEHAVIOUR)
198             .addSupport(ModuleCtxToSourceIdentifier.BEHAVIOUR)
199             .addSupport(ModuleQNameToModuleName.BEHAVIOUR)
200             .addSupport(PrefixToModule.BEHAVIOUR)
201             .addSupport(ImportedModuleContext.BEHAVIOUR)
202             .addSupport(IncludedModuleContext.BEHAVIOUR)
203             .addSupport(IncludedSubmoduleNameToModuleCtx.BEHAVIOUR)
204             .addSupport(ImportPrefixToModuleCtx.BEHAVIOUR)
205             .addSupport(BelongsToPrefixToModuleCtx.BEHAVIOUR)
206             .addSupport(ModuleQNameToPrefix.BEHAVIOUR)
207             .addSupport(URIStringToImportPrefix.BEHAVIOUR)
208             .addSupport(BelongsToModuleContext.BEHAVIOUR)
209             .addSupport(QNameToStatementDefinition.BEHAVIOUR)
210             .addSupport(BelongsToPrefixToModuleName.BEHAVIOUR)
211             .build();
212
213     private static final StatementSupportBundle STMT_DEF_BUNDLE = StatementSupportBundle
214             .derivedFrom(LINKAGE_BUNDLE)
215             .addSupport(YinElementStatementSupport.getInstance())
216             .addSupport(ArgumentStatementSupport.getInstance())
217             .addSupport(ExtensionStatementSupport.getInstance())
218             .addSupport(SchemaTreeNamespace.getInstance())
219             .addSupport(ExtensionNamespace.BEHAVIOUR)
220             .addSupport(TypedefStatementSupport.getInstance())
221             .addSupport(TypeNamespace.BEHAVIOUR)
222             .addVersionSpecificSupport(VERSION_1, IdentityStatementSupport.rfc6020Instance())
223             .addVersionSpecificSupport(VERSION_1_1, IdentityStatementSupport.rfc7950Instance())
224             .addSupport(IdentityNamespace.BEHAVIOUR)
225             .addSupport(DefaultStatementSupport.getInstance())
226             .addSupport(StatusStatementSupport.getInstance())
227             .addSupport(BaseTypeNamespace.BEHAVIOUR)
228             .addVersionSpecificSupport(VERSION_1, TypeStatementRFC6020Support.getInstance())
229             .addVersionSpecificSupport(VERSION_1_1, TypeStatementRFC7950Support.getInstance())
230             .addSupport(UnitsStatementSupport.getInstance())
231             .addSupport(RequireInstanceStatementSupport.getInstance())
232             .addVersionSpecificSupport(VERSION_1, BitStatementSupport.rfc6020Instance())
233             .addVersionSpecificSupport(VERSION_1_1, BitStatementSupport.rfc7950Instance())
234             .addSupport(PathStatementSupport.strictInstance())
235             .addVersionSpecificSupport(VERSION_1, EnumStatementRFC6020Support.getInstance())
236             .addVersionSpecificSupport(VERSION_1_1, EnumStatementRFC7950Support.getInstance())
237             .addSupport(LengthStatementSupport.getInstance())
238             .addVersionSpecificSupport(VERSION_1, PatternStatementRFC6020Support.getInstance())
239             .addVersionSpecificSupport(VERSION_1_1, PatternStatementRFC7950Support.getInstance())
240             .addVersionSpecificSupport(VERSION_1_1, ModifierStatementSupport.getInstance())
241             .addSupport(RangeStatementSupport.getInstance())
242             .addSupport(KeyStatementSupport.getInstance())
243             .addVersionSpecificSupport(VERSION_1, ContainerStatementRFC6020Support.getInstance())
244             .addVersionSpecificSupport(VERSION_1_1, ContainerStatementRFC7950Support.getInstance())
245             .addVersionSpecificSupport(VERSION_1, GroupingStatementRFC6020Support.getInstance())
246             .addVersionSpecificSupport(VERSION_1_1, GroupingStatementRFC7950Support.getInstance())
247             .addVersionSpecificSupport(VERSION_1, ListStatementRFC6020Support.getInstance())
248             .addVersionSpecificSupport(VERSION_1_1, ListStatementRFC7950Support.getInstance())
249             .addSupport(ConfigListWarningNamespace.BEHAVIOUR)
250             .addSupport(UniqueStatementSupport.getInstance())
251             .addVersionSpecificSupport(VERSION_1_1, ActionStatementSupport.getInstance())
252             .addVersionSpecificSupport(VERSION_1, RpcStatementRFC6020Support.getInstance())
253             .addVersionSpecificSupport(VERSION_1_1, RpcStatementRFC7950Support.getInstance())
254             .addVersionSpecificSupport(VERSION_1, InputStatementRFC6020Support.getInstance())
255             .addVersionSpecificSupport(VERSION_1_1, InputStatementRFC7950Support.getInstance())
256             .addVersionSpecificSupport(VERSION_1, OutputStatementRFC6020Support.getInstance())
257             .addVersionSpecificSupport(VERSION_1_1, OutputStatementRFC7950Support.getInstance())
258             .addVersionSpecificSupport(VERSION_1, NotificationStatementRFC6020Support.getInstance())
259             .addVersionSpecificSupport(VERSION_1_1, NotificationStatementRFC7950Support.getInstance())
260             .addSupport(FractionDigitsStatementSupport.getInstance())
261             .addSupport(BaseStatementSupport.getInstance())
262             .addSupport(StatementDefinitionNamespace.BEHAVIOUR)
263             .build();
264
265
266     private RFC7950Reactors() {
267         // Hidden on purpose
268     }
269
270     /**
271      * Returns a pre-built {@link CrossSourceStatementReactor} supporting RFC6020 and RFC7950, along with OpenConfig
272      * semantic version extension. This is useful for parsing near-vanilla YANG models while providing complete
273      * support for semantic versions.
274      *
275      * @return A shared reactor instance.
276      */
277     public static @NonNull CrossSourceStatementReactor defaultReactor() {
278         return ServiceLoaderState.DefaultReactor.INSTANCE;
279     }
280
281     /**
282      * Returns a partially-configured {@link CustomCrossSourceStatementReactorBuilder}, with RFC6020/RFC7950
283      * and OpenConfig semantic version support enabled.
284      *
285      * @return A new {@link CustomCrossSourceStatementReactorBuilder}.
286      */
287     public static @NonNull CustomCrossSourceStatementReactorBuilder defaultReactorBuilder() {
288         return addExtensions(vanillaReactorBuilder());
289     }
290
291     public static @NonNull CustomCrossSourceStatementReactorBuilder defaultReactorBuilder(
292             final YangXPathParserFactory xpathFactory) {
293         return addExtensions(vanillaReactorBuilder(xpathFactory));
294     }
295
296     private static @NonNull CustomCrossSourceStatementReactorBuilder addExtensions(
297             final @NonNull CustomCrossSourceStatementReactorBuilder builder) {
298         return builder
299                 // Semantic version support
300                 .addStatementSupport(ModelProcessingPhase.SOURCE_LINKAGE, OpenConfigVersionSupport.getInstance())
301                 .addNamespaceSupport(ModelProcessingPhase.SOURCE_LINKAGE, SemanticVersionNamespace.BEHAVIOUR)
302                 .addNamespaceSupport(ModelProcessingPhase.SOURCE_LINKAGE, SemanticVersionModuleNamespace.BEHAVIOUR)
303                 .addNamespaceSupport(ModelProcessingPhase.SOURCE_LINKAGE,
304                     ImportPrefixToSemVerSourceIdentifier.BEHAVIOUR);
305     }
306
307     /**
308      * Returns a pre-built {@link CrossSourceStatementReactor} supporting both RFC6020 and RFC7950. This is useful
309      * for parsing vanilla YANG models without any semantic support for extensions. Notably missing is the semantic
310      * version extension, hence attempts to use semantic version mode will cause failures.
311      *
312      * @return A shared reactor instance.
313      */
314     public static @NonNull CrossSourceStatementReactor vanillaReactor() {
315         return ServiceLoaderState.VanillaReactor.INSTANCE;
316     }
317
318     /**
319      * Returns a partially-configured {@link CustomCrossSourceStatementReactorBuilder}, with vanilla RFC6020/RFC7950
320      * support enabled.
321      *
322      * @return A new {@link CustomCrossSourceStatementReactorBuilder}.
323      */
324     public static @NonNull CustomCrossSourceStatementReactorBuilder vanillaReactorBuilder() {
325         return vanillaReactorBuilder(ServiceLoaderState.XPath.INSTANCE);
326     }
327
328     public static @NonNull CustomCrossSourceStatementReactorBuilder vanillaReactorBuilder(
329             final @NonNull YangXPathParserFactory xpathFactory) {
330         return vanillaReactorBuilder(new XPathSupport(xpathFactory));
331     }
332
333     private static @NonNull CustomCrossSourceStatementReactorBuilder vanillaReactorBuilder(
334             final @NonNull XPathSupport xpathSupport) {
335         final StatementSupportBundle fullDeclarationBundle = fullDeclarationBundle(xpathSupport);
336         return new CustomCrossSourceStatementReactorBuilder(SUPPORTED_VERSIONS)
337                 .addAllSupports(ModelProcessingPhase.INIT, INIT_BUNDLE)
338                 .addAllSupports(ModelProcessingPhase.SOURCE_PRE_LINKAGE, PRE_LINKAGE_BUNDLE)
339                 .addAllSupports(ModelProcessingPhase.SOURCE_LINKAGE, LINKAGE_BUNDLE)
340                 .addAllSupports(ModelProcessingPhase.STATEMENT_DEFINITION, STMT_DEF_BUNDLE)
341                 .addAllSupports(ModelProcessingPhase.FULL_DECLARATION, fullDeclarationBundle)
342                 .addAllSupports(ModelProcessingPhase.EFFECTIVE_MODEL, fullDeclarationBundle)
343                 .addValidationBundle(ValidationBundleType.SUPPORTED_REFINE_SUBSTATEMENTS,
344                     YangValidationBundles.SUPPORTED_REFINE_SUBSTATEMENTS)
345                 .addValidationBundle(ValidationBundleType.SUPPORTED_AUGMENT_TARGETS,
346                     YangValidationBundles.SUPPORTED_AUGMENT_TARGETS)
347
348                 // FIXME: 7.0.0: we do not seem to need this validation bundle
349                 .addValidationBundle(ValidationBundleType.SUPPORTED_CASE_SHORTHANDS,
350                     YangValidationBundles.SUPPORTED_CASE_SHORTHANDS)
351
352                 .addValidationBundle(ValidationBundleType.SUPPORTED_DATA_NODES,
353                     YangValidationBundles.SUPPORTED_DATA_NODES);
354     }
355
356     private static @NonNull StatementSupportBundle fullDeclarationBundle(final XPathSupport xpathSupport) {
357         return StatementSupportBundle
358             .derivedFrom(STMT_DEF_BUNDLE)
359             .addSupport(LeafStatementSupport.getInstance())
360             .addSupport(ConfigStatementSupport.getInstance())
361             .addSupport(DeviationStatementSupport.getInstance())
362             .addVersionSpecificSupport(VERSION_1, DeviateStatementRFC6020Support.getInstance())
363             .addVersionSpecificSupport(VERSION_1_1, DeviateStatementRFC7950Support.getInstance())
364             .addVersionSpecificSupport(VERSION_1, ChoiceStatementSupport.rfc6020Instance())
365             .addVersionSpecificSupport(VERSION_1_1, ChoiceStatementSupport.rfc7950Instance())
366             .addVersionSpecificSupport(VERSION_1, CaseStatementSupport.rfc6020Instance())
367             .addVersionSpecificSupport(VERSION_1_1, CaseStatementSupport.rfc7950Instance())
368             .addSupport(MustStatementSupport.createInstance(xpathSupport))
369             .addSupport(MandatoryStatementSupport.getInstance())
370             .addSupport(AnyxmlStatementSupport.getInstance())
371             .addVersionSpecificSupport(VERSION_1_1, AnydataStatementSupport.getInstance())
372             .addSupport(FeatureNamespace.BEHAVIOUR)
373             .addVersionSpecificSupport(VERSION_1, IfFeatureStatementRFC6020Support.getInstance())
374             .addVersionSpecificSupport(VERSION_1_1, IfFeatureStatementRFC7950Support.getInstance())
375             .addSupport(GroupingNamespace.BEHAVIOUR)
376             .addSupport(SourceGroupingNamespace.BEHAVIOUR)
377             .addSupport(UsesStatementSupport.getInstance())
378             .addSupport(ErrorMessageStatementSupport.getInstance())
379             .addSupport(ErrorAppTagStatementSupport.getInstance())
380             .addVersionSpecificSupport(VERSION_1, LeafListStatementRFC6020Support.getInstance())
381             .addVersionSpecificSupport(VERSION_1_1, LeafListStatementRFC7950Support.getInstance())
382             .addSupport(PresenceStatementSupport.getInstance())
383             .addSupport(MaxElementsStatementSupport.getInstance())
384             .addSupport(MinElementsStatementSupport.getInstance())
385             .addSupport(OrderedByStatementSupport.getInstance())
386             .addSupport(WhenStatementSupport.createInstance(xpathSupport))
387             .addSupport(AugmentImplicitHandlingNamespace.BEHAVIOUR)
388             .addVersionSpecificSupport(VERSION_1, AugmentStatementRFC6020Support.getInstance())
389             .addVersionSpecificSupport(VERSION_1_1, AugmentStatementRFC7950Support.getInstance())
390             .addVersionSpecificSupport(VERSION_1, RefineStatementSupport.rfc6020Instance())
391             .addVersionSpecificSupport(VERSION_1_1, RefineStatementSupport.rfc7950Instance())
392             .addSupport(FeatureStatementSupport.getInstance())
393             .addSupport(PositionStatementSupport.getInstance())
394             .addSupport(ValueStatementSupport.getInstance())
395             .addSupport(YangNamespaceContextNamespace.BEHAVIOUR)
396             .build();
397     }
398 }