com.lazerycode.jmeter.mojo

Class ConfigureJMeterMojo

java.lang.Object

org.apache.maven.plugin.AbstractMojo

com.lazerycode.jmeter.mojo.AbstractJMeterMojo

com.lazerycode.jmeter.mojo.ConfigureJMeterMojo

All Implemented Interfaces:

org.apache.maven.plugin.ContextEnabled, org.apache.maven.plugin.Mojo

@Mojo(name="configure",
      defaultPhase=COMPILE)
public class ConfigureJMeterMojo
extends AbstractJMeterMojo

Field Summary

Fields

Modifier and Type	Field and Description
protected static File	customPropertiesDirectory
protected boolean	downloadExtensionDependencies Download all dependencies of files you want to add to lib/ext and copy them to lib/ext too <downloadExtensionDependencies> <true> <downloadExtensionDependencies>
protected boolean	downloadJMeterDependencies Download all transitive dependencies of the JMeter artifacts.
protected boolean	downloadLibraryDependencies Download all dependencies of files you want to add to lib/junit and copy them to lib/junit too <downloadLibraryDependencies> <true> <downloadLibraryDependencies>
static String	JMETER_CONFIG_ARTIFACT_NAME
protected static org.eclipse.aether.artifact.Artifact	jmeterConfigArtifact
protected List<String>	jmeterExtensions A list of artifacts that should be copied into the lib/ext directory e.g.
protected List<String>	junitLibraries A list of artifacts that should be copied into the lib/junit directory e.g.
protected static File	libDirectory
protected static File	libExtDirectory
protected static File	libJUnitDirectory
protected File	propertiesFilesDirectory Path under which .properties files are stored.
protected Map<String,String>	propertiesGlobal JMeter Global Properties that override those given in jmeterProps.
protected Map<String,String>	propertiesJMeter Absolute path to JMeter custom (test dependent) properties file.
protected boolean	propertiesReplacedByCustomFiles Replace the default JMeter properties with any custom properties files supplied.
protected Map<String,String>	propertiesSaveService JMeter Properties that are merged with precedence into default JMeter file in saveservice.properties
protected Map<String,String>	propertiesSystem (Java) System properties set for the test run.
protected Map<String,String>	propertiesUpgrade JMeter Properties that are merged with precedence into default JMeter file in upgrade.properties
protected Map<String,String>	propertiesUser JMeter Properties that are merged with precedence into default JMeter file in user.properties user.properties takes precedence over jmeter.properties
protected String	resultsFileFormat Set the format of the results generated by JMeter Valid values are: xml, csv (XML set by default).
protected boolean	resultsOutputIsCSVFormat

Fields inherited from class com.lazerycode.jmeter.mojo.AbstractJMeterMojo

appendResultsTimestamp, customPropertiesFiles, jmeterDirectory, jMeterProcessJVMSettings, logConfigFilename, logsDirectory, mojoExecution, overrideRootLogLevel, postTestPauseInSeconds, propertiesMap, proxyConfig, remoteConfig, resultsDirectory, resultsFileNameDateFormat, runtimeJarName, settings, skipTests, suppressJMeterOutput, testArgs, testConfigFile, testFilesBuildDirectory, testFilesDirectory, testFilesExcluded, testFilesIncluded, testResultsTimestamp, useMavenProxy, workingDirectory

Fields inherited from interface org.apache.maven.plugin.Mojo

ROLE

Constructor Summary

Constructors

Constructor and Description
ConfigureJMeterMojo()

Method Summary

Methods

Modifier and Type	Method and Description
protected void	configureAdvancedLogging()
protected void	configurePropertiesFiles()
void	doExecute() Configure a local instance of JMeter
protected void	generateJMeterDirectoryTree() Generate the directory tree utilised by JMeter.
protected void	generateTestConfig()
void	setDefaultPluginProperties(String userDirectory)
protected void	setJMeterResultFileFormat()

Methods inherited from class com.lazerycode.jmeter.mojo.AbstractJMeterMojo

execute, initialiseJMeterArgumentsArray, loadMavenProxy

Methods inherited from class org.apache.maven.plugin.AbstractMojo

getLog, getPluginContext, setLog, setPluginContext

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

downloadExtensionDependencies

@Parameter(defaultValue="true")
protected boolean downloadExtensionDependencies

Download all dependencies of files you want to add to lib/ext and copy them to lib/ext too

<downloadExtensionDependencies> <true> <downloadExtensionDependencies>

jmeterExtensions

@Parameter
protected List<String> jmeterExtensions

A list of artifacts that should be copied into the lib/ext directory e.g.

<jmeterExtensions> <artifact>kg.apc:jmeter-plugins:1.3.1</artifact> <jmeterExtensions>

downloadJMeterDependencies

@Parameter(defaultValue="false")
protected boolean downloadJMeterDependencies

Download all transitive dependencies of the JMeter artifacts. (Disabled by default since historically JMeter has depended on artifacts that aren't available in Maven Central)

<downloadJMeterDependencies> <true> <downloadJMeterDependencies>

downloadLibraryDependencies

@Parameter(defaultValue="true")
protected boolean downloadLibraryDependencies

Download all dependencies of files you want to add to lib/junit and copy them to lib/junit too

<downloadLibraryDependencies> <true> <downloadLibraryDependencies>

junitLibraries

@Parameter
protected List<String> junitLibraries

A list of artifacts that should be copied into the lib/junit directory e.g.

<junitLibraries> <artifact>com.lazerycode.junit:junit-test:1.0.0</artifact> <junitLibraries>

propertiesJMeter

@Parameter
protected Map<String,String> propertiesJMeter

Absolute path to JMeter custom (test dependent) properties file.

propertiesSaveService

@Parameter
protected Map<String,String> propertiesSaveService

JMeter Properties that are merged with precedence into default JMeter file in saveservice.properties

propertiesUpgrade

@Parameter
protected Map<String,String> propertiesUpgrade

JMeter Properties that are merged with precedence into default JMeter file in upgrade.properties

propertiesUser

@Parameter
protected Map<String,String> propertiesUser

JMeter Properties that are merged with precedence into default JMeter file in user.properties user.properties takes precedence over jmeter.properties

propertiesGlobal

@Parameter
protected Map<String,String> propertiesGlobal

JMeter Global Properties that override those given in jmeterProps.
This sets local and remote properties (JMeter's definition of global properties is actually remote properties) and overrides any local/remote properties already set

propertiesSystem

@Parameter
protected Map<String,String> propertiesSystem

(Java) System properties set for the test run. Properties are merged with precedence into default JMeter file system.properties

propertiesFilesDirectory

@Parameter(defaultValue="${basedir}/src/test/jmeter")
protected File propertiesFilesDirectory

Path under which .properties files are stored.

propertiesReplacedByCustomFiles

@Parameter(defaultValue="true")
protected boolean propertiesReplacedByCustomFiles

Replace the default JMeter properties with any custom properties files supplied. (If set to false any custom properties files will be merged with the default JMeter properties files, custom properties will overwrite default ones)

resultsFileFormat

@Parameter(defaultValue="xml")
protected String resultsFileFormat

Set the format of the results generated by JMeter Valid values are: xml, csv (XML set by default).

resultsOutputIsCSVFormat

protected boolean resultsOutputIsCSVFormat

JMETER_CONFIG_ARTIFACT_NAME

public static final String JMETER_CONFIG_ARTIFACT_NAME

See Also:

Constant Field Values

jmeterConfigArtifact

protected static org.eclipse.aether.artifact.Artifact jmeterConfigArtifact

customPropertiesDirectory

protected static File customPropertiesDirectory

libDirectory

protected static File libDirectory

libExtDirectory

protected static File libExtDirectory

libJUnitDirectory

protected static File libJUnitDirectory

Constructor Detail

ConfigureJMeterMojo

public ConfigureJMeterMojo()

Method Detail

doExecute

public void doExecute()
               throws org.apache.maven.plugin.MojoExecutionException,
                      org.apache.maven.plugin.MojoFailureException

Configure a local instance of JMeter

Specified by:

doExecute in class AbstractJMeterMojo

Throws:

org.apache.maven.plugin.MojoExecutionException

org.apache.maven.plugin.MojoFailureException

generateJMeterDirectoryTree

protected void generateJMeterDirectoryTree()

Generate the directory tree utilised by JMeter.

configurePropertiesFiles

protected void configurePropertiesFiles()
                                 throws org.apache.maven.plugin.MojoExecutionException,
                                        org.apache.maven.plugin.MojoFailureException

Throws:

org.apache.maven.plugin.MojoExecutionException

org.apache.maven.plugin.MojoFailureException

generateTestConfig

protected void generateTestConfig()
                           throws org.apache.maven.plugin.MojoExecutionException

Throws:

org.apache.maven.plugin.MojoExecutionException

setDefaultPluginProperties

public void setDefaultPluginProperties(String userDirectory)

setJMeterResultFileFormat

protected void setJMeterResultFileFormat()

configureAdvancedLogging

protected void configureAdvancedLogging()
                                 throws org.apache.maven.plugin.MojoFailureException

Throws:

org.apache.maven.plugin.MojoFailureException