binding/mdsal-binding-generator/src/main/java/org/opendaylight/mdsal/binding/generator/impl/reactor/ModuleGenerator.java

   1 /*
   2  * Copyright (c) 2021 PANTHEON.tech, 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.mdsal.binding.generator.impl.reactor;
   9
  10 import static com.google.common.base.Verify.verifyNotNull;
  11
  12 import java.util.Map;
  13 import org.eclipse.jdt.annotation.NonNull;
  14 import org.opendaylight.mdsal.binding.generator.impl.reactor.CollisionDomain.Member;
  15 import org.opendaylight.mdsal.binding.model.api.GeneratedType;
  16 import org.opendaylight.mdsal.binding.model.api.JavaTypeName;
  17 import org.opendaylight.mdsal.binding.model.api.type.builder.GeneratedTypeBuilder;
  18 import org.opendaylight.mdsal.binding.model.api.type.builder.GeneratedTypeBuilderBase;
  19 import org.opendaylight.mdsal.binding.model.ri.BindingTypes;
  20 import org.opendaylight.mdsal.binding.spec.naming.BindingMapping;
  21 import org.opendaylight.yangtools.yang.common.AbstractQName;
  22 import org.opendaylight.yangtools.yang.common.QNameModule;
  23 import org.opendaylight.yangtools.yang.model.api.stmt.ChoiceEffectiveStatement;
  24 import org.opendaylight.yangtools.yang.model.api.stmt.DataTreeEffectiveStatement;
  25 import org.opendaylight.yangtools.yang.model.api.stmt.ModuleEffectiveStatement;
  26 import org.opendaylight.yangtools.yang.model.util.SchemaInferenceStack;
  27
  28 /**
  29  * Generator corresponding to a {@code module} statement. These generators are roots for generating types for a
  30  * particular {@link QNameModule} as mapped into the root package.
  31  */
  32 public final class ModuleGenerator extends AbstractCompositeGenerator<ModuleEffectiveStatement> {
  33     private final @NonNull JavaTypeName yangModuleInfo;
  34     private final @NonNull ClassPlacement placement;
  35
  36     /**
  37      * Note that for sake of simplicity of lookup and child mapping, this instance serves as the root for all child
  38      * generators, but mapping to {@link CollisionDomain}s and their {@link Member}s is rather weird. This generator
  39      * actually produces one of <em>secondary</em> members, more precisely the {@link BindingMapping#DATA_ROOT_SUFFIX}
  40      * one. Counter-intuitively the other secondary members live as children of this generator. To support this we have
  41      * also have this field, which is actually the <em>primary</em> derived from the module's name.
  42      */
  43     private final Member prefixMember;
  44
  45     ModuleGenerator(final ModuleEffectiveStatement statement) {
  46         super(statement);
  47         yangModuleInfo = JavaTypeName.create(javaPackage(), BindingMapping.MODULE_INFO_CLASS_NAME);
  48         placement = computePlacement();
  49         prefixMember = placement != ClassPlacement.NONE || haveSecondary()
  50             ? domain().addPrefix(this, new ModuleNamingStrategy(statement.argument())) : null;
  51     }
  52
  53     private @NonNull ClassPlacement computePlacement() {
  54         return statement().findFirstEffectiveSubstatement(DataTreeEffectiveStatement.class).isPresent()
  55             || statement().findFirstEffectiveSubstatement(ChoiceEffectiveStatement.class).isPresent()
  56             ? ClassPlacement.TOP_LEVEL : ClassPlacement.NONE;
  57     }
  58
  59     private boolean haveSecondary() {
  60         for (Generator child : this) {
  61             if (child instanceof AbstractImplicitGenerator) {
  62                 return true;
  63             }
  64         }
  65         return false;
  66     }
  67
  68     @Override
  69     ModuleGenerator currentModule() {
  70         return this;
  71     }
  72
  73     @Override
  74     void pushToInference(final SchemaInferenceStack dataTree) {
  75         // No-op
  76     }
  77
  78     @Override
  79     String createJavaPackage() {
  80         return BindingMapping.getRootPackageName(statement().localQNameModule());
  81     }
  82
  83     @Override
  84     AbstractCompositeGenerator<?> getPackageParent() {
  85         return this;
  86     }
  87
  88     @Override
  89     CollisionDomain parentDomain() {
  90         return domain();
  91     }
  92
  93     @Override
  94     ClassPlacement classPlacement() {
  95         return placement;
  96     }
  97
  98     @Override
  99     Member createMember(final CollisionDomain domain) {
 100         return domain.addSecondary(this, prefixMember, BindingMapping.DATA_ROOT_SUFFIX);
 101     }
 102
 103     @Override
 104     GeneratedType createTypeImpl(final TypeBuilderFactory builderFactory) {
 105         final GeneratedTypeBuilder builder = builderFactory.newGeneratedTypeBuilder(typeName());
 106         builder.setModuleName(statement().argument().getLocalName());
 107         builder.addImplementsType(BindingTypes.DATA_ROOT);
 108
 109         final int usesCount = addUsesInterfaces(builder, builderFactory);
 110         // if we have more than 2 top level uses statements we need to define getImplementedInterface() on the top-level
 111         // DataRoot object
 112         if (usesCount > 1) {
 113             narrowImplementedInterface(builder);
 114         }
 115
 116         addGetterMethods(builder, builderFactory);
 117         builderFactory.addCodegenInformation(statement(), builder);
 118
 119         return builder.build();
 120     }
 121
 122     @NonNull Member getPrefixMember() {
 123         return verifyNotNull(prefixMember);
 124     }
 125
 126     void addQNameConstant(final GeneratedTypeBuilderBase<?> builder, final AbstractQName localName) {
 127         builder.addConstant(BindingTypes.QNAME, BindingMapping.QNAME_STATIC_FIELD_NAME,
 128             Map.entry(yangModuleInfo, localName.getLocalName()));
 129     }
 130 }