Using a Pre-Build Script
Complementary to the post-build hook script, you can also create a pre-build hook script that will be run before the invocation of Maven. This can be used to do some preparations for the build.
Default name of Pre-Build script is prebuild
, you can use name prebuild.bsh
or prebuild.groovy
according to chosen script language.
In Pre-Build scripts you can prepare a test resources for your project.
You can also define a user properties which will be added to executed test project by -D
Maven argument.
Here is an example of groovy script:
def userProperties = context.get('userProperties') def server = new MockServer() userProperties.put('serverHost', server.getHost()) userProperties.put('serverPort', server.getPort())
Now you can use it in test project:
<project> <build> <plugins> <plugin> <groupId>org.example</groupId> <artifactId>my-maven-plugin</artifactId> <version>@project.version@</version> <configuration> <server>${serverHost}:${serverPort}</server> </configuration> <executions> .... </executions> </plugin> </plugins> </build> </project>
Using a Post-Build Script
Here is an example of how the Invoker Plugin can be used to run a set of Maven projects and then verify their output with a BeanShell or Groovy script. The name of the script file in this case is verify
- default value is postbuild
.
<project> <build> <plugins> <plugin> <artifactId>maven-invoker-plugin</artifactId> <version>3.8.0</version> <configuration> <debug>true</debug> <projectsDirectory>src/it</projectsDirectory> <preBuildHookScript>setup</preBuildHookScript> <postBuildHookScript>verify</postBuildHookScript> </configuration> <executions> <execution> <id>integration-test</id> <goals> <goal>run</goal> </goals> </execution> </executions> </plugin> </plugins> </build> </project>
Below is an example post-build BeanShell script (verify.bsh
) that checks for the existence of a JAR file after the build has run. If the JAR file does not exist, the script throws an exception which causes the Invoker Plugin to log that the build failed. More precisely, any non-null return value which does not equal true
will be interpreted as a failure condition. And of course, if the script exits abnormally due to an exception, the plugin will flag the corresponding build as a failure, too.
Example verify.bsh
import java.io.*; File file = new File( basedir, "target/my-test-project-1.0-SNAPSHOT.jar" ); if ( !file.isFile() ) { throw new FileNotFoundException( "Could not find generated JAR: " + file ); }
and similar verify.groovy
def file = new File( basedir, "target/my-test-project-1.0-SNAPSHOT.jar" ) assert file.isFile()
Predefined global variables
To allow the scripts to access some useful data about the test project, the following global variables will be defined by the Invoker Plugin before running the script:
Name | Type | Description | Since |
---|---|---|---|
basedir |
java.io.File |
The absolute path to the base directory of the test project. | 1.0 |
localRepositoryPath |
java.io.File |
The absolute path to the local repository used for the Maven invocation on the test project. | 1.3 |
context |
java.util.Map |
The storage of key-value pairs used to pass data from the pre-build hook script to the post-build hook script. | 1.4 |
context.get('userProperties') |
java.util.Properties |
The user properties for executing project | 3.7.0 |
mavenVersion |
java.lang.String |
The version of Maven executing on the test project. | 1.9 |
Additional variables that can be accessed in the hook scripts can be defined through the scriptVariables
parameter in the Invoker Plugin's configuration.