Class IntegrationTestMojo

java.lang.Object
org.apache.maven.plugin.AbstractMojo
org.apache.maven.archetype.mojos.IntegrationTestMojo
All Implemented Interfaces:
org.apache.maven.plugin.ContextEnabled, org.apache.maven.plugin.Mojo

@Mojo(name="integration-test", requiresProject=true) public class IntegrationTestMojo extends org.apache.maven.plugin.AbstractMojo

Execute the archetype integration tests, consisting in generating projects from the current archetype and optionally comparing generated projects with reference copy.

Each IT consists of a sub-directory in src/test/resources/projects containing:

  • a goal.txt file, containing a list of goals to run against the generated project (can be empty, content ignored before maven-archetype-plugin 2.1),
  • an archetype.properties file, containing properties for project generation,
  • an optional reference/ directory containing a reference copy of the expected project created from the IT.

To let the IT create a Maven module below some other Maven project (being generated from another archetype) one can additionally specify an optional archetype.pom.properties file in the parent directory, specifying the archetype's groupId, artifactId and version along with its archetype.properties file, containing properties for project generation. Both files are leveraged to create the parent project for this IT. Parent projects can be nested.

An example structure for such an integration test looks like this

integration test folder structure
File/Directory Description
src/test/resources/projects/it1 Directory for integration test 1
src/test/resources/projects/it1/archetype.pom.properties GAV for the archetype from which to generate the parent
src/test/resources/projects/it1/archetype.properties All required properties for the archetype being specified by archetype.pom.properties on this level
src/test/resources/projects/it1/child Directory for maven module within integration test 1 (this folder's name is not relevant)
src/test/resources/projects/it1/child/goal.txt The file containing the list of goals to be executed against the generated project
src/test/resources/projects/it1/child/archetype.properties All required properties for this project's archetype

Notice that it is expected to be run as part as of a build after the package phase and not directly as a goal from CLI.

  • Field Details

    • archetypeGenerator

      @Component private ArchetypeGenerator archetypeGenerator
    • downloader

      @Component private Downloader downloader
    • invoker

      @Component private org.apache.maven.shared.invoker.Invoker invoker
    • archetypeGenerationConfigurator

      @Component private ArchetypeGenerationConfigurator archetypeGenerationConfigurator
    • project

      @Parameter(defaultValue="${project}", readonly=true, required=true) private org.apache.maven.project.MavenProject project
      The archetype project to execute the integration tests on.
    • session

      @Parameter(defaultValue="${session}", readonly=true, required=true) private org.apache.maven.execution.MavenSession session
    • skip

      @Parameter(property="archetype.test.skip") private boolean skip
      Skip the integration test.
    • testProjectsDirectory

      @Parameter(property="archetype.test.projectsDirectory", defaultValue="${project.build.testOutputDirectory}/projects", required=true) private File testProjectsDirectory
      Directory of test projects
      Since:
      2.2
    • postBuildHookScript

      @Parameter(property="archetype.test.verifyScript", defaultValue="verify") private String postBuildHookScript
      Relative path of a cleanup/verification hook script to run after executing the build. This script may be written with either BeanShell or Groovy. If the file extension is omitted (e.g. verify), the plugin searches for the file by trying out the well-known extensions .bsh and .groovy. If this script exists for a particular project but returns any non-null value different from true or throws an exception, the corresponding build is flagged as a failure.
      Since:
      2.2
    • noLog

      @Parameter(property="archetype.test.noLog", defaultValue="false") private boolean noLog
      Suppress logging to the build.log file.
      Since:
      2.2
    • streamLogs

      @Parameter(property="archetype.test.streamLogs", defaultValue="true") private boolean streamLogs
      Flag used to determine whether the build logs should be output to the normal mojo log.
      Since:
      2.2
    • encoding

      @Parameter(property="encoding", defaultValue="${project.build.sourceEncoding}") private String encoding
      The file encoding for the post-build script.
      Since:
      2.2
    • localRepositoryPath

      @Parameter(property="archetype.test.localRepositoryPath", defaultValue="${settings.localRepository}", required=true) private File localRepositoryPath
      The local repository to run maven instance.
      Since:
      2.2
    • showVersion

      @Parameter(property="archetype.test.showVersion", defaultValue="false") private boolean showVersion
      flag to enable show mvn version used for running its (cli option : -V,--show-version )
      Since:
      2.2
    • ignoreEOLStyle

      @Parameter(property="archetype.test.ignoreEOLStyle", defaultValue="false") private boolean ignoreEOLStyle
      Ignores the EOL encoding for comparing files (default and original behaviour is false).
      Since:
      2.3
    • debug

      @Parameter(property="archetype.test.debug", defaultValue="false") private boolean debug
      Whether to show debug statements in the build output.
      Since:
      2.2
    • filterProperties

      @Parameter private Map<String,String> filterProperties
      A list of additional properties which will be used to filter tokens in settings.xml
      Since:
      2.2
    • settings

      @Parameter(defaultValue="${settings}", required=true, readonly=true) private org.apache.maven.settings.Settings settings
      The current user system settings for use in Maven.
      Since:
      2.2
    • settingsFile

      @Parameter(property="archetype.test.settingsFile") private File settingsFile
      Path to an alternate settings.xml to use for Maven invocation with all ITs. Note that the <localRepository> element of this settings file is always ignored, i.e. the path given by the parameter localRepositoryPath is dominant.
      Since:
      2.2
    • properties

      @Parameter private Map<String,String> properties
      Common set of properties to pass in on each project's command line, via -D parameters.
      Since:
      3.0.2
  • Constructor Details

    • IntegrationTestMojo

      public IntegrationTestMojo()
  • Method Details