View Source

This is a Maven 2 plugin that allows you to run JMeter tests as part of the build.  I am using this with \[http://jchav.blogspot.com/ JChav\] and \[http://maven.apache.org/continuum/ Continuum\] to automate the running of a suite of JMeter load tests, and publish the results to a web page.  Sorry this is not more polished.  It could use some TLC to make it more user-friendly to actually plug it into a project.  I just thought I'd stick the code out there as quickly as possible and see if anyone is interested in it before I went any further with it.

To build and use the plugin:

Create a local Maven repository, if you don't already have one.

Drop in the attached \[^jmeter-2.2.jar JMeter jar\] and \[^jmeter-2.2.pom POM\].  You do not need to have JMeter separately installed.

Add the jar files that are referenced in the JMeter POM to your local repository, if they are not on ibiblio.

Download the attached \[^maven-jmeter-plugin-src.tar.gz Maven JMeter Plugin source tarball\].  Untar it.

Run "mvn install" to build and install the plugin.

In your project's pom.xml, add a dependency on this plugin:

<dependency>
  <groupId>org.apache.jmeter</groupId>
  <artifactId>maven-jmeter-plugin</artifactId>
  <version>1.0-SNAPSHOT</version>
  <type>plugin</type>
</dependency>

Create a src/test/jmeter directory, and place your JMeter load tests there.
Create a jmeter.properties file in src/test/jmeter. It's fine to just copy the default properties file from the JMeter install if you want.

Optionally configure includes and excludes in your pom.xml for which tests to run. If you don't, it will just run **/*.jmx. For example:

  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.jmeter</groupId>
        <artifactId>maven-jmeter-plugin</artifactId>
        <configuration>
          <includes>
            <include>myTest1.jmx</include>
            <include>myTest2.jmx</include>
          </includes>
        </configuration>
      </plugin>
    </plugins>
  </build>

The default reports directory is 'jmeter-reports' which is created in the base folder ( usually where maven is run from )

Changing the reports directory : Add a reportDir setting to the plugin configuration. for example:

  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.jmeter</groupId>
        <artifactId>maven-jmeter-plugin</artifactId>
        <configuration>
          <includes>
            <include>myTest1.jmx</include>
            <include>myTest2.jmx</include>
          </includes>
          <reportDir>target/jmeter-reports</reportDir>
        </configuration>
      </plugin>
    </plugins>
  </build>

Run "mvn org.apache.jmeter:maven-jmeter-plugin:jmeter" to run the tests.

– Kartikeya Rao