binding/mdsal-binding-runtime-api/src/main/java/org/opendaylight/mdsal/binding/runtime/api/BindingRuntimeTypes.java

   1 /*
   2  * Copyright (c) 2018 Pantheon Technologies, s.r.o.  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.mdsal.binding.runtime.api;
   9
  10 import com.google.common.annotations.Beta;
  11 import java.util.Optional;
  12 import java.util.Set;
  13 import org.eclipse.jdt.annotation.NonNull;
  14 import org.eclipse.jdt.annotation.Nullable;
  15 import org.opendaylight.mdsal.binding.model.api.GeneratedType;
  16 import org.opendaylight.mdsal.binding.model.api.JavaTypeName;
  17 import org.opendaylight.yangtools.concepts.Immutable;
  18 import org.opendaylight.yangtools.yang.common.QName;
  19 import org.opendaylight.yangtools.yang.common.YangDataName;
  20 import org.opendaylight.yangtools.yang.model.api.EffectiveModelContextProvider;
  21 import org.opendaylight.yangtools.yang.model.api.stmt.SchemaNodeIdentifier.Absolute;
  22
  23 /**
  24  * The result of BindingGenerator run. Contains mapping between Types and SchemaNodes.
  25  */
  26 @Beta
  27 public interface BindingRuntimeTypes extends EffectiveModelContextProvider, RuntimeTypeContainer, Immutable {
  28
  29     Optional<IdentityRuntimeType> findIdentity(QName qname);
  30
  31     Optional<RuntimeType> findSchema(JavaTypeName typeName);
  32
  33     Optional<InputRuntimeType> findRpcInput(QName rpcName);
  34
  35     Optional<OutputRuntimeType> findRpcOutput(QName rpcName);
  36
  37     Optional<YangDataRuntimeType> findYangData(YangDataName templateName);
  38
  39     default @Nullable RuntimeType schemaTreeChild(final Absolute path) {
  40         final var it = path.getNodeIdentifiers().iterator();
  41         var tmp = schemaTreeChild(it.next());
  42         while (it.hasNext() && tmp instanceof RuntimeTypeContainer container) {
  43             tmp = container.schemaTreeChild(it.next());
  44         }
  45         return tmp;
  46     }
  47
  48     /**
  49      * Lookup to all {@link CaseRuntimeType}s related to a {@link ChoiceRuntimeType}. This is important when dealing
  50      * with sharing incurred by Binding Spec's reuse of constructs defined in a {@code grouping}.
  51      *
  52      * <p>
  53      * As an example, consider {@link ChoiceRuntimeType} and {@link CaseRuntimeType} relationship to
  54      * {@link GeneratedType}s in the following model:
  55      * <pre>
  56      *   <code>
  57      *     grouping grp {
  58      *       container foo {
  59      *         choice bar;
  60      *       }
  61      *     }
  62      *
  63      *     container foo {
  64      *       uses grp;
  65      *     }
  66      *
  67      *     container bar {
  68      *       uses grp;
  69      *     }
  70      *
  71      *     augment /foo/foo/bar {
  72      *       case baz
  73      *     }
  74      *
  75      *     augment /bar/foo/bar {
  76      *       case xyzzy;
  77      *     }
  78      *   </code>
  79      * </pre>
  80      * YANG view of what is valid in {@code /foo/foo/bar} differs from what is valid in {@code /bar/foo/bar}, but this
  81      * difference is not reflected in generated Java constructs. More notably, the two augments being in different
  82      * modules. Since {@code choice bar}'s is part of a reusable construct, {@code grouping one}, DataObjects' copy
  83      * builders can propagate them without translating them to the appropriate manifestation -- and they can do nothing
  84      * about that as they lack the complete view of the effective model.
  85      *
  86      * <p>
  87      * This method provides a bridge between a particular instantiation of a {@code choice} to {@link CaseRuntimeType}s
  88      * valid in all instantiations.
  89      *
  90      * @param choiceType A ChoiceRuntimeType
  91      * @return The set of {@link CaseRuntimeType}s known to this instance
  92      * @throws NullPointerException if {@code ChoiceRuntimeType} is null
  93      */
  94     @NonNull Set<CaseRuntimeType> allCaseChildren(ChoiceRuntimeType choiceType);
  95 }