package com.atlassian.maven.plugin.clover.internal;
/*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*/
import org.apache.maven.plugin.AbstractMojo;
import org.apache.maven.plugin.MojoExecutionException;
import org.apache.maven.plugin.logging.Log;
import org.apache.maven.project.MavenProject;
import org.apache.tools.ant.Project;
import org.apache.tools.ant.taskdefs.Taskdef;
import org.codehaus.plexus.resource.ResourceManager;
import org.codehaus.plexus.resource.loader.FileResourceLoader;
import java.io.File;
import java.io.IOException;
import java.util.ArrayList;
import java.util.List;
import com.atlassian.clover.CloverNames;
import com.atlassian.maven.plugin.clover.MvnLogBuildListener;
/**
* Common code for all Clover plugin build Mojos.
*
* @author <a href="mailto:vmassol@apache.org">Vincent Massol</a>
* @author <a href="mailto:npellow@atlassian.com">Nick Pellow</a>
*/
public abstract class AbstractCloverMojo extends AbstractMojo implements CloverConfiguration {
/**
* The directory where the Clover plugin will put all the files it generates during the build process. For
* example the Clover plugin will put instrumented sources somewhere inside this directory.
*
* @parameter default-value="${project.build.directory}/clover"
* @required
*/
protected String cloverOutputDirectory;
/**
* The location of the <a href="http://confluence.atlassian.com/x/EIBOB">Clover database</a>.
*
* @parameter expression="${maven.clover.cloverDatabase}"
*/
private String cloverDatabase;
/**
* The location to store the clover snapshot file. This file needs to persist between builds to enable Clover's
* build optimization feature. If not specified, the snapshot will be stored next to the cloverDatabase.
*
* @parameter expression="${maven.clover.snapshot}"
*/
protected File snapshot;
/**
* If true, then a single cloverDatabase will be used for the entire project.
* This flag will be ignored if a custom cloverDatabase location is specified.
*
* @parameter expression="${maven.clover.singleCloverDatabase}" default-value="false"
*/
private boolean singleCloverDatabase;
/**
* The location of the merged clover database to create when running a report in a multimodule build.
*
* @parameter expression="${maven.clover.cloverMergeDatabase}" default-value="${project.build.directory}/clover/cloverMerge.db"
* @required
*/
private String cloverMergeDatabase;
/**
* A Clover license file to be used by the plugin. The plugin tries to resolve this parameter first as a resource,
* then as a URL, and then as a file location on the filesystem.
* <p/>
* A trial Clover license can be generated <a href="http://www.atlassian.com/ex/GenerateLicense.jspa?product=Clover&version=2">here</a>.
*
* @parameter expression="${maven.clover.licenseLocation}"
* @see #license
*/
protected String licenseLocation;
/**
* The full Clover license String to use. If supplied, this certificate will be used over {@link #licenseLocation}.
* NB. newline chars must be preserved.
* A trial Clover license can be generated <a href="http://www.atlassian.com/ex/GenerateLicense.jspa?product=Clover&version=2">here</a>.
*
* @parameter expression="${maven.clover.license}"
* @see #licenseLocation
*/
protected String license;
/**
* The <a href="http://confluence.atlassian.com/x/O4BOB">Clover flush policy</a> to use.
* Valid values are <code>directed</code>, <code>interval</code> and <code>threaded</code>.
*
* @parameter expression="${maven.clover.flushPolicy}" default-value="threaded"
*/
private String flushPolicy;
/**
* When the Clover Flush Policy is set to "interval" or threaded this value is the minimum period between flush
* operations (in milliseconds).
*
* @parameter expression="${maven.clover.flushInterval}" default-value="500"
*/
private int flushInterval;
/**
* If true we'll wait 2*flushInterval to ensure coverage data is flushed to the Clover database before running
* any query on it.
* <p/>
* <p>Note: The only use case where you would want to turn this off is if you're running your tests in a separate
* JVM. In that case the coverage data will be flushed by default upon the JVM shutdown and there would be no need
* to wait for the data to be flushed. As we can't control whether users want to fork their tests or not, we're
* offering this parameter to them.</p>
*
* @parameter expression="${maven.clover.waitForFlush}" default-value="true"
*/
private boolean waitForFlush;
/**
* Which Java language level Clover shall use to parse sources. Valid values are:
* <ul>
* <li>1.3</li>
* <li>1.4 (introduces 'assert' keyword)</li>
* <li>1.5 ('enum' keyword and generics)</li>
* <li>1.6 (no language changes)</li>
* <li>1.7 (String in switch, try with resources, binary literals, underscores in literals)</li>
* <li>1.8 (lambda expressions, default methods in interfaces)</li>
* </ul>
*
* By default Clover instruments using the highest language level supported.
*
* @parameter expression="${maven.clover.jdk}"
*/
private String jdk;
/**
* The Maven project instance for the executing project.
* <p/>
* <p>Note: This is passed by Maven and must not be configured by the user.</p>
*
* @parameter expression="${project}"
* @required
*/
private MavenProject project;
/**
* Resource manager used to locate any Clover license file provided by the user.
*
* @component
*/
private ResourceManager resourceManager;
/**
* A flag to indicate not to run clover for this execution.
* <p/>
* If set to true, Clover will not be run.
*
* @parameter expression="${maven.clover.skip}" default-value="false"
*/
protected boolean skip;
/**
* If you wish to enable debug level logging in just the Clover plugin, set this to true.
* <p/>
* This is useful for integrating Clover into the build
*
* @parameter expression="${maven.clover.debug}" default-value="false"
*/
protected boolean debug;
/**
* The projects in the reactor for aggregation report.
* <p/>
* <p>Note: This is passed by Maven and must not be configured by the user.</p>
*
* @parameter expression="${reactorProjects}"
* @readonly
*/
private List<MavenProject> reactorProjects;
/**
* {@inheritDoc}
*
* @see org.apache.maven.plugin.AbstractMojo#execute()
*/
public void execute() throws MojoExecutionException {
registerLicenseFile();
}
public void setResourceManager(final ResourceManager resourceManager) {
this.resourceManager = resourceManager;
}
public ResourceManager getResourceManager() {
return this.resourceManager;
}
protected void registerLicenseFile() throws MojoExecutionException {
registerLicenseFile(
this.project,
getResourceManager(),
this.licenseLocation,
getLog(),
this.getClass().getClassLoader(),
this.license);
}
/**
* Registers the license file for Clover runtime by setting the <code>clover.license.path</code> system property.
* If the user has configured the <code>licenseLocation</code> parameter the plugin tries to resolve it first as a
* resource, then as a URL, and then as a file location on the filesystem. If the <code>licenseLocation</code>
* parameter has not been defined by the user we look up a default Clover license in the classpath in
* <code>/clover.license</code>.
* </p>
* Note: We're defining this method as static because it is also required in the report mojo and reporting mojos
* and main mojos cannot share anything right now. See http://jira.codehaus.org/browse/MNG-1886.
*
* @throws MojoExecutionException when the license file cannot be found
*/
public static void registerLicenseFile(final MavenProject project,
final ResourceManager resourceManager,
String licenseLocation,
final Log logger,
final ClassLoader classloader,
final String licenseCert) throws MojoExecutionException {
if (licenseCert != null) {
logger.debug("Full license supplied. Length: '" + licenseCert.length() +
"'. License location: '" + licenseLocation + "' will be ignored.");
System.setProperty(CloverNames.PROP_LICENSE_CERT, licenseCert);
return;
}
logger.debug("Using licenseLocation '" + licenseLocation + "'");
if (licenseLocation == null) {
logger.info("No 'maven.clover.licenseLocation' configured. Using default evaluation license.");
licenseLocation = "/clover.license";
}
final File licenseFile = getResourceAsFile(project, resourceManager, licenseLocation, logger, classloader);
logger.debug("Using license file [" + licenseFile.getPath() + "]");
System.setProperty(CloverNames.PROP_LICENSE_PATH, licenseFile.getPath());
}
public static File getResourceAsFile(final MavenProject project,
final ResourceManager resourceManager,
final String resourceLocation,
final Log logger,
final ClassLoader classloader) throws MojoExecutionException {
logger.debug("Getting resource: '" + resourceLocation + "'");
resourceManager.addSearchPath("url", "");
resourceManager.addSearchPath(FileResourceLoader.ID, project.getFile().getParentFile().getAbsolutePath());
final ClassLoader origLoader = Thread.currentThread().getContextClassLoader();
try {
Thread.currentThread().setContextClassLoader(classloader);
try {
logger.debug("Attempting to load resource from [" + resourceLocation + "] ...");
final File outputFile = File.createTempFile("mvn", "resource");
outputFile.deleteOnExit();
return resourceManager.getResourceAsFile(resourceLocation, outputFile.getPath());
} catch (Exception e) {
throw new MojoExecutionException("Failed to load resource as file [" + resourceLocation + "]", e);
}
} finally {
Thread.currentThread().setContextClassLoader(origLoader);
}
}
/**
* Register the Clover Ant tasks against a fake Ant {{@link Project}} object so that we can the tasks later on.
* This is the Java equivalent of the <code>taskdef</code> call that you would need in your Ant
* <code>build.xml</code> file if you wanted to use the Clover Ant tasks from Ant.
* </p>
* Note: We're defining this method as static because it is also required in the report mojo and reporting mojos
* and main mojos cannot share anything right now. See http://jira.codehaus.org/browse/MNG-1886.
*/
public static void registerCloverAntTasks(final Project antProject, final Log log) {
antProject.addBuildListener(new MvnLogBuildListener(log));
final Taskdef taskdef = (Taskdef) antProject.createTask("taskdef");
taskdef.init();
taskdef.setResource("cloverlib.xml");
taskdef.execute();
}
/**
* Wait 2*'flush interval' milliseconds to ensure that the coverage data have been flushed to the Clover database.
* <p/>
* TODO: This method should not be static but we need it static here because we cannot share code
* between non report mojos and main build mojos. See http://jira.codehaus.org/browse/MNG-1886
*/
public static void waitForFlush(final boolean waitForFlush, final int flushInterval) {
if (waitForFlush) {
try {
Thread.sleep(2 * flushInterval);
} catch (InterruptedException e) {
// Nothing to do... Just go on and try to check for coverage.
}
}
}
/**
* Check if a Clover database exists (either a single module Clover database or an aggregated one).
*
* @return true if a Clover database exists.
*/
protected boolean areCloverDatabasesAvailable() {
boolean shouldRun = false;
final File singleModuleCloverDatabase = new File(resolveCloverDatabase());
final File mergedCloverDatabase = new File(this.cloverMergeDatabase);
if (singleModuleCloverDatabase.exists() || mergedCloverDatabase.exists()) {
shouldRun = true;
}
return shouldRun;
}
public MavenProject getProject() {
return this.project;
}
public boolean getWaitForFlush() {
return this.waitForFlush;
}
public String getJdk() {
return this.jdk;
}
public String getCloverDatabase() {
return cloverDatabase;
}
public String resolveCloverDatabase() {
return new ConfigUtil(this).resolveCloverDatabase();
}
protected String getCloverMergeDatabase() {
return this.cloverMergeDatabase;
}
public int getFlushInterval() {
return this.flushInterval;
}
public String getFlushPolicy() {
return this.flushPolicy;
}
public void setProject(final MavenProject project) {
this.project = project;
}
public void setLicenseLocation(final String licenseLocation) {
this.licenseLocation = licenseLocation;
}
public void setLicense(final String license) {
this.license = license;
}
public List<MavenProject> getReactorProjects() {
return reactorProjects;
}
public boolean isSingleCloverDatabase() {
return this.singleCloverDatabase;
}
protected boolean isLastProjectInReactor() {
final MavenProject lastProject = getReactorProjects().get(getReactorProjects().size() - 1);
final MavenProject thisProject = getProject();
return thisProject.equals(lastProject);
}
/**
* Returns true if the supplied potentialModule project is a module
* of the specified parentProject.
*
* @param parentProject the parent project.
* @param potentialModule the potential moduleproject.
* @return true if the potentialModule is indeed a module of the specified
* parent project.
*/
protected boolean isModuleOfProject(final MavenProject parentProject, final MavenProject potentialModule) {
boolean result = false;
final List<String> modules = parentProject.getModules();
if (modules != null) {
final File parentBaseDir = parentProject.getBasedir();
for (final String module : modules) {
File moduleBaseDir = new File(parentBaseDir, module);
try {
// need these to be canonical paths so we can perform a true equality
// operation and remember <module> is a path and for flat multimodule project
// structures they will be like this: <module>../a-project<module>
final String lhs = potentialModule.getBasedir().getCanonicalPath();
final String rhs = moduleBaseDir.getCanonicalPath();
if (lhs.equals(rhs)) {
result = true;
break;
}
} catch (IOException e) {
// surpress the exception (?)
getLog().error("error encountered trying to resolve canonical module paths");
}
}
}
return result;
}
/**
* Returns all the projects that are modules, or modules of modules, of the
* specified project found witin the reactor.
* <p/>
* The searchLevel parameter controls how many descendent levels of modules
* are returned. With a searchLevels equals to 1, only the immediate modules
* of the specified project are returned.
* <p/>
* A searchLevel equals to 2 returns those module's modules as well.
* <p/>
* A searchLevel equals to -1 returns the entire module hierarchy beneath the
* specified project. Note that this is simply the equivalent to the entire reactor
* if the specified project is the root execution project.
*
* @param project the project to search under
* @param levels the number of descendent levels to return (List<MavenProject>)
* @return the list of module projects.
*/
protected List<MavenProject> getModuleProjects(final MavenProject project, final int levels) {
final List<MavenProject> projects = new ArrayList<MavenProject>();
final boolean infinite = (levels == -1);
if ((getReactorProjects() != null) && (infinite || levels > 0)) {
for (final MavenProject reactorProject : getReactorProjects()) {
if (isModuleOfProject(project, reactorProject)) {
projects.add(reactorProject);
if (project == reactorProject) {
projects.add(project); //CLMVN-78 don't recurse if project is the same as reactorProject.
} else {
projects.addAll(getModuleProjects(reactorProject,
infinite ? levels : levels - 1));
}
}
}
}
return projects;
}
/**
* returns all the projects that are in the reactor build as
* direct or indirect modules of the specified project.
*
* @param project the project to search beneath
* @return the list of modules that are direct or indirect module descendents (List<MavenProject>)
* of the specified project
*/
protected List<MavenProject> getDescendentModuleProjects(final MavenProject project) {
return getModuleProjects(project, -1);
}
}