【wiki翻译】jmeter-maven-plugin系列之初学者文档

 jmeter-maven-plugin插件下载地址

插件使用环境要求：

 >= JDK 8, Maven >= 3.5.2 and uses Apache JMeter 5.5.

将插件添加到您的pom.xml的构建部分(最佳实践是定义您想要在pom.xml或父pom.xml中使用的Maven JMeter插件的版本)

    [...]
        
            
                
                com.lazerycode.jmeter
                jmeter-maven-plugin
                3.6.0
                
                    
                    
                        configuration
                        
                            configure
                        
                    
                    
                    
                        jmeter-tests
                        
                            jmeter
                        
                    
                    
                    
                        jmeter-check-results
                        
                            results
                        
                    
                
            
            
        
    [...]

插件默认使用JMeter提供的默认属性文件。如果需要覆盖这些文件中的任何一个，只需要在${project.base.directory}/src/test/jmeter中创建一个替换文件即可。

如果在${project.base.directory}/src/test/jmeter中找到以下属性文件，则会使用它们:

• jmeter.properties
• saveservice.properties
• upgrade.properties
• system.properties
• user.properties
• global.properties

插件将复制${project.base.directory}/src/test/jmeter/中保存的所有JMX测试文件目录及所有子目录到${project.build.directory}/jmeter/testFiles。

任何子目录都将被平铺，目录路径将用于创建测试文件名。然后将使用${project.build.directory}/jmeter/testFiles中的所有文件运行测试。

对于其他配置文件，如log4j2.xml，请使用${project.base.directory}/src/test/conf文件夹。

使用命令运行

一旦配置了POM，就可以运行测试了。打开终端/命令提示符，然后输入:

mvn clean verify

JMeter -maven-plugin将运行JMeter测试的过程分解为多个阶段:

运行jmeter测试过程分解

Maven阶段	Jmeter Maven插件目标	描述
汇编（compile）	configure	这将下载所有必需的依赖项，并在目标目录的唯一目录中配置JMeter的本地实例，以运行测试。
集成测试（integration-test）	jmeter	这将利用在编译阶段创建的本地配置的JMeter实例来执行测试。
核实（verify）	results	这将扫描测试运行的结果，并确定构建是否应该失败。

配置JMeter时，配置与执行ID相关联。这个执行ID随后由其他阶段提供，以确保我们运行正确配置的JMeter实例。由于我们在上述文档中建议配置的执行ID，因此我们也将后面阶段的预期执行ID默认为配置。

可以通过如下方式更改默认的执行ID，例如:

  bananas
  
    configure
  

然而，如果你这样做，你将需要修改其他阶段的配置，以便它知道使用哪个执行ID，例如:

  jmeter-tests
  
    jmeter
  
  
    bananas
  

当尝试在命令行上运行特定目标时，理解上述内容很重要。如果您已经运行了一次测试，但是您想再次运行它们，那么您不需要再次运行编译阶段，您可以只运行如下命令即可：

mvn jmeter:jmeter

jmeter目标将始终使用POM中指定的来查找特定的jmeter配置。如果要针对已为其运行配置目标的其他配置运行测试，可以使用以下命令指定要使用的配置:

mvn jmeter:jmeter -DselectConfiguration=configuration

启动JMeter GUI

可以使用以下命令运行JMeter GUI:

mvn jmeter:configure jmeter:gui

gui目标使用当前的执行ID来设置它所选择的配置，而不是使用selectConfiguration属性。这是因为它被设计为独立运行，不需要在POM.xml中进行任何配置。由于在上面的示例中没有指定执行ID，两个命令都将使用默认的Maven执行ID default-cli。
如果希望使用特定配置启动GUI，可以指定相关的Execution ID。如果我们假设已经使用POM.xml中指定的配置的执行ID运行了配置目标，则要加载GUI，则需要运行如下命令：

mvn jmeter:gui@configuration

如果你想预加载一个测试，你可以在命令行中指定：

mvn jmeter:configure jmeter:gui -DguiTestFile=src/test/jmeter/test.jmx

如果你还没有将插件添加到你的项目中，你仍然可以调用它(只要你在你的项目中有一个有效的pom.xml)，使用以下方法:

mvn com.lazerycode.jmeter:jmeter-maven-plugin:configure com.lazerycode.jmeter:jmeter-maven-plugin:gui