code-generator/maven-sal-api-gen-plugin/src/main/java/org/opendaylight/yangtools/maven/sal/api/gen/plugin/CodeGeneratorImpl.java

   1 /*
   2  * Copyright (c) 2013 Cisco Systems, Inc. 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.maven.sal.api.gen.plugin;
   9
  10 import com.google.common.base.Joiner;
  11 import com.google.common.base.Preconditions;
  12 import com.google.common.collect.ImmutableSet;
  13 import com.google.common.collect.ImmutableSet.Builder;
  14 import org.apache.maven.plugin.logging.Log;
  15 import org.apache.maven.project.MavenProject;
  16 import org.opendaylight.yangtools.binding.generator.util.BindingGeneratorUtil;
  17 import org.opendaylight.yangtools.sal.binding.generator.api.BindingGenerator;
  18 import org.opendaylight.yangtools.sal.binding.generator.impl.BindingGeneratorImpl;
  19 import org.opendaylight.yangtools.sal.binding.model.api.Type;
  20 import org.opendaylight.yangtools.sal.java.api.generator.GeneratorJavaFile;
  21 import org.opendaylight.yangtools.sal.java.api.generator.YangModuleInfoTemplate;
  22 import org.opendaylight.yangtools.yang.binding.BindingMapping;
  23 import org.opendaylight.yangtools.yang.binding.YangModelBindingProvider;
  24 import org.opendaylight.yangtools.yang.model.api.Module;
  25 import org.opendaylight.yangtools.yang.model.api.SchemaContext;
  26 import org.opendaylight.yangtools.yang2sources.spi.BuildContextAware;
  27 import org.opendaylight.yangtools.yang2sources.spi.CodeGenerator;
  28 import org.slf4j.Logger;
  29 import org.slf4j.LoggerFactory;
  30 import org.sonatype.plexus.build.incremental.BuildContext;
  31
  32 import java.io.BufferedWriter;
  33 import java.io.File;
  34 import java.io.IOException;
  35 import java.io.OutputStream;
  36 import java.io.OutputStreamWriter;
  37 import java.io.Writer;
  38 import java.util.Collection;
  39 import java.util.List;
  40 import java.util.Map;
  41 import java.util.Set;
  42
  43 public final class CodeGeneratorImpl implements CodeGenerator, BuildContextAware {
  44     private static final String FS = File.separator;
  45     private BuildContext buildContext;
  46     private File projectBaseDir;
  47     private Map<String, String> additionalConfig;
  48
  49     private static final Logger logger = LoggerFactory.getLogger(CodeGeneratorImpl.class);
  50     private MavenProject mavenProject;
  51     private File resourceBaseDir;
  52
  53     @Override
  54     public Collection<File> generateSources(final SchemaContext context, final File outputDir,
  55             final Set<Module> yangModules) throws IOException {
  56         final File outputBaseDir;
  57
  58         outputBaseDir = outputDir == null ? getDefaultOutputBaseDir() : outputDir;
  59
  60         final BindingGenerator bindingGenerator = new BindingGeneratorImpl();
  61         final List<Type> types = bindingGenerator.generateTypes(context, yangModules);
  62         final GeneratorJavaFile generator = new GeneratorJavaFile(buildContext, types);
  63
  64         File persistentSourcesDir = null;
  65         if (additionalConfig != null) {
  66             String persistenSourcesPath = additionalConfig.get("persistentSourcesDir");
  67             if (persistenSourcesPath != null) {
  68                 persistentSourcesDir = new File(persistenSourcesPath);
  69             }
  70         }
  71         if (persistentSourcesDir == null) {
  72             persistentSourcesDir = new File(projectBaseDir, "src" + FS + "main" + FS + "java");
  73         }
  74
  75         List<File> result = generator.generateToFile(outputBaseDir, persistentSourcesDir);
  76
  77         result.addAll(generateModuleInfos(outputBaseDir, yangModules, context));
  78         return result;
  79     }
  80
  81     private Collection<? extends File> generateModuleInfos(File outputBaseDir, Set<Module> yangModules,
  82                                                            SchemaContext context) {
  83         Builder<File> result = ImmutableSet.builder();
  84         Builder<String> bindingProviders = ImmutableSet.builder();
  85         for (Module module : yangModules) {
  86             Builder<String> currentProvidersBuilder = ImmutableSet.builder();
  87             // TODO: do not mutate parameters, output of a method is defined by its return value
  88             Set<File> moduleInfoProviders = generateYangModuleInfo(outputBaseDir, module, context, currentProvidersBuilder);
  89             ImmutableSet<String> currentProviders = currentProvidersBuilder.build();
  90             logger.info("Adding ModuleInfo providers {}", currentProviders);
  91             bindingProviders.addAll(currentProviders);
  92             result.addAll(moduleInfoProviders);
  93         }
  94
  95         result.add(writeMetaInfServices(resourceBaseDir, YangModelBindingProvider.class, bindingProviders.build()));
  96         return result.build();
  97     }
  98
  99     private File writeMetaInfServices(File outputBaseDir, Class<YangModelBindingProvider> serviceClass,
 100             ImmutableSet<String> services) {
 101         File metainfServicesFolder = new File(outputBaseDir, "META-INF" + File.separator + "services");
 102         metainfServicesFolder.mkdirs();
 103         File serviceFile = new File(metainfServicesFolder, serviceClass.getName());
 104
 105         String src = Joiner.on('\n').join(services);
 106
 107         return writeFile(serviceFile, src);
 108     }
 109
 110     public static final String DEFAULT_OUTPUT_BASE_DIR_PATH = "target" + File.separator + "generated-sources"
 111             + File.separator + "maven-sal-api-gen";
 112
 113     private File getDefaultOutputBaseDir() {
 114         File outputBaseDir;
 115         outputBaseDir = new File(DEFAULT_OUTPUT_BASE_DIR_PATH);
 116         setOutputBaseDirAsSourceFolder(outputBaseDir, mavenProject);
 117         logger.debug("Adding " + outputBaseDir.getPath() + " as compile source root");
 118         return outputBaseDir;
 119     }
 120
 121     private static void setOutputBaseDirAsSourceFolder(File outputBaseDir, MavenProject mavenProject) {
 122         Preconditions.checkNotNull(mavenProject, "Maven project needs to be set in this phase");
 123         mavenProject.addCompileSourceRoot(outputBaseDir.getPath());
 124     }
 125
 126     @Override
 127     public void setLog(Log log) {
 128     }
 129
 130     @Override
 131     public void setAdditionalConfig(Map<String, String> additionalConfiguration) {
 132         this.additionalConfig = additionalConfiguration;
 133     }
 134
 135     @Override
 136     public void setResourceBaseDir(File resourceBaseDir) {
 137         this.resourceBaseDir = resourceBaseDir;
 138     }
 139
 140     @Override
 141     public void setMavenProject(MavenProject project) {
 142         this.mavenProject = project;
 143         this.projectBaseDir = project.getBasedir();
 144     }
 145
 146     @Override
 147     public void setBuildContext(BuildContext buildContext) {
 148         this.buildContext = Preconditions.checkNotNull(buildContext);
 149     }
 150
 151     private Set<File> generateYangModuleInfo(File outputBaseDir, Module module, SchemaContext ctx,
 152             Builder<String> providerSourceSet) {
 153         Builder<File> generatedFiles = ImmutableSet.<File> builder();
 154
 155         final YangModuleInfoTemplate template = new YangModuleInfoTemplate(module, ctx);
 156         String moduleInfoSource = template.generate();
 157         if (moduleInfoSource.isEmpty()) {
 158             throw new IllegalStateException("Generated code should not be empty!");
 159         }
 160         String providerSource = template.generateModelProvider();
 161
 162         final File packageDir = GeneratorJavaFile.packageToDirectory(outputBaseDir,
 163                 BindingGeneratorUtil.moduleNamespaceToPackageName(module));
 164
 165         generatedFiles.add(writeJavaSource(packageDir, BindingMapping.MODULE_INFO_CLASS_NAME, moduleInfoSource));
 166         generatedFiles
 167                 .add(writeJavaSource(packageDir, BindingMapping.MODEL_BINDING_PROVIDER_CLASS_NAME, providerSource));
 168         providerSourceSet.add(template.getModelBindingProviderName());
 169
 170         return generatedFiles.build();
 171
 172     }
 173
 174     private File writeJavaSource(File packageDir, String className, String source) {
 175         if (!packageDir.exists()) {
 176             packageDir.mkdirs();
 177         }
 178         final File file = new File(packageDir, className + ".java");
 179         writeFile(file, source);
 180         return file;
 181     }
 182
 183     private File writeFile(File file, String source) {
 184         try (final OutputStream stream = buildContext.newFileOutputStream(file)) {
 185             try (final Writer fw = new OutputStreamWriter(stream)) {
 186                 try (final BufferedWriter bw = new BufferedWriter(fw)) {
 187                     bw.write(source);
 188                 }
 189             } catch (Exception e) {
 190                 logger.error("Could not write file: {}",file,e);
 191             }
 192         } catch (Exception e) {
 193             logger.error("Could not create file: {}",file,e);
 194         }
 195         return file;
 196     }
 197
 198 }