com.buschmais.jqassistant.scm.maven.AbstractMojo Maven / Gradle / Ivy
Show all versions of jqassistant-maven-plugin Show documentation
package com.buschmais.jqassistant.scm.maven;
import java.io.File;
import java.util.*;
import java.util.function.Supplier;
import com.buschmais.jqassistant.core.runtime.api.configuration.ConfigurationBuilder;
import com.buschmais.jqassistant.core.runtime.api.plugin.PluginRepository;
import com.buschmais.jqassistant.core.store.api.Store;
import com.buschmais.jqassistant.neo4j.embedded.configuration.Embedded;
import com.buschmais.jqassistant.scm.maven.configuration.Maven;
import com.buschmais.jqassistant.scm.maven.configuration.MavenConfiguration;
import com.buschmais.jqassistant.scm.maven.configuration.source.EmptyConfigSource;
import com.buschmais.jqassistant.scm.maven.configuration.source.MavenProjectConfigSource;
import com.buschmais.jqassistant.scm.maven.configuration.source.MavenPropertiesConfigSource;
import com.buschmais.jqassistant.scm.maven.configuration.source.SettingsConfigSource;
import com.buschmais.jqassistant.scm.maven.provider.CachingStoreProvider;
import com.buschmais.jqassistant.scm.maven.provider.ConfigurationProvider;
import com.buschmais.jqassistant.scm.maven.provider.PluginRepositoryProvider;
import io.smallrye.config.source.yaml.YamlConfigSource;
import org.apache.maven.execution.MavenSession;
import org.apache.maven.plugin.MojoExecution;
import org.apache.maven.plugin.MojoExecutionException;
import org.apache.maven.plugin.MojoFailureException;
import org.apache.maven.plugins.annotations.Component;
import org.apache.maven.plugins.annotations.Parameter;
import org.apache.maven.project.MavenProject;
import org.apache.maven.rtinfo.RuntimeInformation;
import org.eclipse.aether.RepositorySystem;
import org.eclipse.aether.RepositorySystemSession;
import org.eclipse.aether.repository.RemoteRepository;
import org.eclipse.microprofile.config.spi.ConfigSource;
import static java.lang.Thread.currentThread;
import static org.apache.commons.lang3.StringUtils.isNotEmpty;
/**
* Abstract base implementation for analysis mojos.
*/
public abstract class AbstractMojo extends org.apache.maven.plugin.AbstractMojo {
public static final String STORE_DIRECTORY = "jqassistant/store";
private static String createExecutionKey(MojoExecution mojoExecution) {
// Do NOT use a custom class for execution keys, as different modules may use
// different classloaders
return mojoExecution.getGoal() + "@" + mojoExecution.getExecutionId();
}
/**
* The config locations.
*/
@Parameter(property = "jqassistant.configuration.locations")
private List configurationLocations;
@Parameter
private String yaml;
/**
* The Maven Session.
*/
@Parameter(defaultValue = "${session}", readonly = true, required = true)
private MavenSession session;
/**
* The Maven project.
*/
@Parameter(property = "project")
private MavenProject currentProject;
/**
* The current execution.
*/
@Parameter(property = "mojoExecution")
private MojoExecution execution;
/**
* The Maven runtime information.
*/
@Component
private RuntimeInformation runtimeInformation;
@Component
private ConfigurationProvider configurationProvider;
@Component
private PluginRepositoryProvider pluginRepositoryProvider;
/**
* The store repository.
*/
@Component
private CachingStoreProvider cachingStoreProvider;
@Component
private RepositorySystem repositorySystem;
@Parameter(defaultValue = "${repositorySystemSession}", readonly = true, required = true)
private RepositorySystemSession repositorySystemSession;
@Parameter(defaultValue = "${project.remoteProjectRepositories}", readonly = true, required = true)
private List repositories;
@Override
public final void execute() throws MojoExecutionException, MojoFailureException {
if (!runtimeInformation.isMavenVersion("[3.5,)")) {
throw new MojoExecutionException("jQAssistant requires Maven 3.5.x or above.");
}
// Synchronize on this class as multiple instances of the plugin may exist in parallel builds
synchronized (AbstractMojo.class) {
MavenConfiguration configuration = getConfiguration();
if (configuration.skip()) {
getLog().info("Skipping execution.");
} else {
PluginRepository pluginRepository = pluginRepositoryProvider.getPluginRepository(repositorySystem, repositorySystemSession, repositories,
configuration);
MojoExecutionContext mojoExecutionContext = new MojoExecutionContext(session, currentProject, execution, configuration, pluginRepository);
MavenProject rootModule = mojoExecutionContext.getRootModule();
Set executedModules = getExecutedModules(rootModule);
ClassLoader contextClassLoader = currentThread().getContextClassLoader();
currentThread().setContextClassLoader(pluginRepository.getClassLoader());
try {
if (isResetStoreBeforeExecution(configuration) && executedModules.isEmpty()) {
withStore(store -> store.reset(), mojoExecutionContext);
}
execute(mojoExecutionContext, executedModules);
} finally {
currentThread().setContextClassLoader(contextClassLoader);
}
executedModules.add(currentProject);
}
}
}
/**
* Execute the mojo.
*
* @param mojoExecutionContext
* The {@link MojoExecutionContext}.
* @param executedModules
* The already executed modules of the project.
* @throws MojoExecutionException
* If a general execution problem occurs.
* @throws MojoFailureException
* If a failure occurs.
*/
protected abstract void execute(MojoExecutionContext mojoExecutionContext, Set executedModules)
throws MojoExecutionException, MojoFailureException;
/**
* Determine if the store shall be reset before execution of the mojo,can be overwritten by subclasses.
*
* @return `true` if the store shall be reset.
*/
protected boolean isResetStoreBeforeExecution(MavenConfiguration configuration) {
return false;
}
/**
* Determines if the executed MOJO requires enabled connectors, can be overwritten by subclasses.
*
* @return true If connectors must be enabled.
*/
protected boolean isConnectorRequired() {
return false;
}
/**
* Execute an operation with the store.
*
* This method enforces thread safety based on the store factory.
*
* @param storeOperation
* The store.
* @throws MojoExecutionException
* On execution errors.
* @throws MojoFailureException
* On execution failures.
*/
protected final void withStore(StoreOperation storeOperation, MojoExecutionContext mojoExecutionContext)
throws MojoExecutionException, MojoFailureException {
MavenProject rootModule = mojoExecutionContext.getRootModule();
MavenConfiguration configuration = mojoExecutionContext.getConfiguration();
Store store = getStore(mojoExecutionContext, () -> new File(rootModule.getBuild()
.getDirectory(), STORE_DIRECTORY));
try {
storeOperation.run(store);
} finally {
releaseStore(store, configuration.maven());
}
}
/**
* Determine the already executed modules for a given root module.
*
* @param rootModule
* The root module.
* @return The set of already executed modules belonging to the root module.
*/
private Set getExecutedModules(MavenProject rootModule) {
String executionKey = createExecutionKey(execution);
String executedModulesContextKey = AbstractProjectMojo.class.getName() + "#executedModules";
Map> executedProjectsPerExecutionKey = (Map>) rootModule.getContextValue(executedModulesContextKey);
if (executedProjectsPerExecutionKey == null) {
executedProjectsPerExecutionKey = new HashMap<>();
rootModule.setContextValue(executedModulesContextKey, executedProjectsPerExecutionKey);
}
Set executedProjects = executedProjectsPerExecutionKey.get(executionKey);
if (executedProjects == null) {
executedProjects = new HashSet<>();
executedProjectsPerExecutionKey.put(executionKey, executedProjects);
}
return executedProjects;
}
/**
* Determine the store instance to use for the given root module.
*
* @return The store instance.
* @throws MojoExecutionException
* If the store cannot be opened.
*/
private Store getStore(MojoExecutionContext mojoExecutionContext, Supplier storeDirectorySupplier) throws MojoExecutionException {
Object existingStore = cachingStoreProvider.getStore(mojoExecutionContext.getConfiguration()
.store(), storeDirectorySupplier, mojoExecutionContext.getPluginRepository());
if (!Store.class.isAssignableFrom(existingStore.getClass())) {
throw new MojoExecutionException(
"Cannot re-use store instance from reactor. Either declare the plugin as extension or execute Maven using the property -D" + Maven.REUSE_STORE
+ "=false on the command line.");
}
return (Store) existingStore;
}
/**
* Release a store instance.
*
* @param store
* The store instance.
* @param maven
*/
private void releaseStore(Store store, Maven maven) {
if (!maven.reuseStore()) {
cachingStoreProvider.closeStore(store);
}
}
/**
* Retrieve the runtime configuration.
*
* The configuration directory is assumed to be located within the execution root of the Maven session.
*
* @return The {@link MavenConfiguration}.
*/
private MavenConfiguration getConfiguration() {
ConfigurationBuilder configurationBuilder = new ConfigurationBuilder("MojoConfigSource", 110);
if (isConnectorRequired()) {
configurationBuilder.with(Embedded.class, Embedded.CONNECTOR_ENABLED, true);
}
File executionRoot = new File(session.getExecutionRootDirectory());
MavenProjectConfigSource projectConfigSource = new MavenProjectConfigSource(currentProject);
SettingsConfigSource settingsConfigSource = new SettingsConfigSource(session.getSettings());
MavenPropertiesConfigSource projectPropertiesConfigSource = new MavenPropertiesConfigSource(currentProject.getProperties(), "Maven Project Properties");
MavenPropertiesConfigSource userPropertiesConfigSource = new MavenPropertiesConfigSource(session.getUserProperties(), "Maven Session User Properties ");
MavenPropertiesConfigSource systemPropertiesConfigSource = new MavenPropertiesConfigSource(session.getSystemProperties(),
"Maven Session System Properties");
return configurationProvider.getConfiguration(executionRoot, configurationLocations, configurationBuilder.build(), projectConfigSource,
settingsConfigSource, projectPropertiesConfigSource, userPropertiesConfigSource, systemPropertiesConfigSource, getMavenPluginConfiguration());
}
private ConfigSource getMavenPluginConfiguration() {
return isNotEmpty(yaml) ?
new YamlConfigSource("Maven plugin execution configuration", yaml, ConfigurationProvider.ORDINAL_PLUGIN_EXECUTION) :
EmptyConfigSource.INSTANCE;
}
/**
* Defines an operation to execute on an initialized store instance.
*/
protected interface StoreOperation {
/**
* Execute the operation.
*
* @param store
* The store.
* @throws MojoExecutionException
* On execution errors.
* @throws MojoFailureException
* On execution failures.
*/
void run(Store store) throws MojoExecutionException, MojoFailureException;
}
}