yang/yang-parser-impl/src/main/java/org/opendaylight/yangtools/yang/parser/impl/DefaultReactors.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.impl;
   9
  10 import static org.opendaylight.yangtools.yang.parser.spi.meta.NamespaceBehaviour.treeScoped;
  11
  12 import com.google.common.annotations.Beta;
  13 import org.opendaylight.yangtools.openconfig.parser.OpenConfig;
  14 import org.opendaylight.yangtools.rfc7952.parser.Metadata;
  15 import org.opendaylight.yangtools.yang.parser.odlext.namespace.AnyxmlSchemaLocationNamespace;
  16 import org.opendaylight.yangtools.yang.parser.odlext.stmt.AnyxmlSchemaLocationSupport;
  17 import org.opendaylight.yangtools.yang.parser.rfc7950.reactor.CustomCrossSourceStatementReactorBuilder;
  18 import org.opendaylight.yangtools.yang.parser.rfc7950.reactor.RFC7950Reactors;
  19 import org.opendaylight.yangtools.yang.parser.spi.meta.ModelProcessingPhase;
  20 import org.opendaylight.yangtools.yang.parser.spi.meta.StatementSupport;
  21 import org.opendaylight.yangtools.yang.parser.stmt.reactor.CrossSourceStatementReactor;
  22 import org.opendaylight.yangtools.yang.parser.stmt.reactor.CrossSourceStatementReactor.Builder;
  23 import org.opendaylight.yangtools.yang.parser.stmt.rfc8040.YangDataStatementSupport;
  24
  25 /**
  26  * Utility class for instantiating default-configured {@link CrossSourceStatementReactor}s.
  27  *
  28  * @author Robert Varga
  29  */
  30 @Beta
  31 public final class DefaultReactors {
  32     private static final CrossSourceStatementReactor DEFAULT_REACTOR = defaultReactorBuilder().build();
  33
  34     private DefaultReactors() {
  35         throw new UnsupportedOperationException();
  36     }
  37
  38     /**
  39      * Get a shared default-configured reactor instance. This instance is configured to handle both RFC6020 and RFC7950,
  40      * as well as RFC8040's yang-data extension.
  41      *
  42      * @return a shared default-configured reactor instance.
  43      */
  44     public static CrossSourceStatementReactor defaultReactor() {
  45         return DEFAULT_REACTOR;
  46     }
  47
  48     /**
  49      * Return a baseline CrossSourceStatementReactor {@link Builder}. The builder is initialized to the equivalent
  50      * of the reactor returned via {@link #defaultReactor()}, but can be further customized before use.
  51      *
  52      * @return A populated CrossSourceStatementReactor builder.
  53      */
  54     public static CustomCrossSourceStatementReactorBuilder defaultReactorBuilder() {
  55         final CustomCrossSourceStatementReactorBuilder ret =  RFC7950Reactors.defaultReactorBuilder();
  56
  57         // AnyxmlSchemaLocation support
  58         ret.addStatementSupport(ModelProcessingPhase.FULL_DECLARATION, AnyxmlSchemaLocationSupport.getInstance());
  59         ret.addNamespaceSupport(ModelProcessingPhase.FULL_DECLARATION, treeScoped(AnyxmlSchemaLocationNamespace.class));
  60
  61         // RFC7952 annotation support
  62         for (StatementSupport<?, ?, ?> support : Metadata.getStatements()) {
  63             ret.addStatementSupport(ModelProcessingPhase.FULL_DECLARATION, support);
  64         }
  65
  66         // RFC8040 yang-data support
  67         ret.addStatementSupport(ModelProcessingPhase.FULL_DECLARATION, YangDataStatementSupport.getInstance());
  68
  69         // OpenConfig extensions support (except openconfig-version)
  70         for (StatementSupport<?, ?, ?> support : OpenConfig.getStatements()) {
  71             ret.addStatementSupport(ModelProcessingPhase.FULL_DECLARATION, support);
  72         }
  73
  74         return ret;
  75     }
  76 }