使用Kotlin生成JMeter JMX文件缺失guiclass属性无法导入

问题描述 #

我尝试用Kotlin结合JMeter 5.6版本生成JMX文件，代码如下：

const val GUI_CLASS_VAL = "guiclass"

fun main() {
  // Initialize JMeter engine
  val jmeterHome = File("Apps/apache-jmeter-5.6.3")
  val jmeterProperties = File(jmeterHome, "bin/jmeter.properties")
  JMeterUtils.setJMeterHome(jmeterHome.path)
  JMeterUtils.loadJMeterProperties(jmeterProperties.path)
  JMeterUtils.initLocale()

  ...
  // Test Plan
  val testPlan = TestPlan("Test Plan")

  // Test Plan HashTree
  val testPlanTree = ListedHashTree()
  testPlanTree.add(testPlan)
  ...

  // Save to JMX
  SaveService.saveTree(testPlanTree, FileOutputStream("test_plan.jmx"))
}

生成的JMX中TestPlan标签仅包含testname属性：

<?xml version="1.0" encoding="UTF-8"?>
  <jmeterTestPlan version="1.2" properties="5.0" jmeter="5.6.3">
   <hashTree>
    <TestPlan testname="Test Plan">

导入JMeter时报错：

Problem loading XML from:'somePath/test_plan.jmx'. 
Cause:
IllegalArgumentException: guiclass attribute is not found

正确的TestPlan标签需要包含guiclass、testclass等属性：

<TestPlan guiclass="TestPlanGui" testclass="TestPlan" testname="Test Plan">

我试过用testPlan.addParameter(GUI_CLASS_VAL, "TestPlanGui")或testPlan.setProperty(GUI_CLASS_VAL, "TestPlanGui")添加属性，但都无效，请问怎么让生成器为所有元素正确添加这些必要属性？

解决方案 #

问题出在你使用了自定义的字符串常量guiclass，而JMeter内部是通过TestElement类的内置常量来识别这些核心属性的。正确的做法是使用JMeter提供的TestElement.GUI_CLASS和TestElement.TEST_CLASS常量来设置属性，同时确保初始化流程正确加载了JMeter的组件元数据。

修改后的代码如下：

import org.apache.jmeter.testelement.TestElement
import org.apache.jmeter.threads.ThreadGroup
import org.apache.jmeter.control.LoopController
import org.apache.jmeter.save.SaveService
import org.apache.jmeter.util.JMeterUtils
import org.apache.jorphan.collections.ListedHashTree
import java.io.File
import java.io.FileOutputStream

fun main() {
    // 初始化JMeter引擎
    val jmeterHome = File("Apps/apache-jmeter-5.6.3")
    val jmeterProperties = File(jmeterHome, "bin/jmeter.properties")
    JMeterUtils.setJMeterHome(jmeterHome.path)
    JMeterUtils.loadJMeterProperties(jmeterProperties.path)
    JMeterUtils.initLocale()

    // 创建TestPlan并设置必要属性
    val testPlan = org.apache.jmeter.testelement.TestPlan("Test Plan")
    // 设置GUI类和测试类属性（使用JMeter内置常量）
    testPlan.setProperty(TestElement.GUI_CLASS, "org.apache.jmeter.gui.tree.TestPlanGui")
    testPlan.setProperty(TestElement.TEST_CLASS, "org.apache.jmeter.testelement.TestPlan")
    // 配置TestPlan的默认属性
    testPlan.setProperty("TestPlan.functional_mode", false)
    testPlan.setProperty("TestPlan.serialize_threadgroups", false)

    // 构建测试计划的HashTree结构
    val testPlanTree = ListedHashTree()
    val testPlanNode = testPlanTree.add(testPlan)

    // 示例：添加ThreadGroup及LoopController（同样需要设置属性）
    val loopController = LoopController()
    loopController.setProperty(TestElement.GUI_CLASS, "org.apache.jmeter.control.gui.LoopControlPanel")
    loopController.setProperty(TestElement.TEST_CLASS, "org.apache.jmeter.control.LoopController")
    loopController.setLoops(1)
    loopController.setFirst(true)

    val threadGroup = ThreadGroup()
    threadGroup.setProperty(TestElement.GUI_CLASS, "org.apache.jmeter.threads.gui.ThreadGroupGui")
    threadGroup.setProperty(TestElement.TEST_CLASS, "org.apache.jmeter.threads.ThreadGroup")
    threadGroup.setNumThreads(1)
    threadGroup.setRampUp(1)
    threadGroup.setSamplerController(loopController)

    testPlanNode.add(threadGroup)

    // 保存为JMX文件
    SaveService.saveTree(testPlanTree, FileOutputStream("test_plan.jmx"))
}

关键说明 #

• 使用内置常量：必须用TestElement.GUI_CLASS和TestElement.TEST_CLASS来设置属性，这两个常量对应JMX中的guiclass和testclass字段，JMeter的SaveService会优先识别这些内置常量对应的属性。
• 完整类路径：设置GUI类时要使用完整的包名（如org.apache.jmeter.gui.tree.TestPlanGui），确保JMeter能正确关联到对应的可视化组件。
• 全组件覆盖：所有JMeter组件（ThreadGroup、Sampler、Controller等）都需要设置这两个属性，否则导入时同样会触发类似的缺失属性报错。
• 初始化正确性：确保JMeter的home目录和配置文件加载无误，这是JMeter加载组件元数据的基础。

按照上述方式修改后，生成的JMX文件会包含所有必要属性，导入JMeter时即可正常加载。

内容的提问来源于stack exchange，提问作者medy75