How ot4i/perf-harness works
Project type and purpose
• This is an open-source, modular Java performance-testing tool (“Perfharness”) that can drive load against HTTP endpoints, JMS brokers (JMS 1.1 & 2.0), IBM MQ (Java & JMS), TCP/IP and other transports.
• It is not a web-application but a command-line library/framework: you invoke a main class with parameters, it spawns threads, drives messages/requests, gathers statistics, and reports results.
File structure
• Top-level Eclipse projects:
• PerfHarness – the core engine and common services (configuration loading, threading, stats, sequencing, command processing)
• HTTPPerfHarness – HTTP transport plug-in (GET, POST, PUT, SOAP, SSL)
• JMSPerfHarness – JMS 1.1 module with multiple provider implementations (WebSphereMQ, QPID, WMB, etc.)
• JakartaJMSPerfHarness – JMS 2.0 module using Jakarta APIs
• MQJavaPerfHarness – pure IBM MQ Java API module
• PerfHarnessPrereqs – external JAR dependencies (IBM MQ client jars, JNDI, connector, etc.)
• samples, docs, build scripts and Ant files under PerfHarness
• Each transport module follows the same package hierarchy:
com.ibm.uk.hursley.perfharness.<transport>
with Provider, Requestor, configuration (.properties) and optional sub-packages (r11, r20, cmd, tcpip).
• The core PerfHarness project contains:
• Config, ControlThread, WorkerThread, ApplicationPropertyMap
• cmd sub-package for pluggable command processors (Socket, LinuxPipe, Dummy)
• sequencing, stats, util sub-packages for pluggable sequencing and statistics collectors
• Build/CI artifacts: Ant build.xml files in each project, sample run-config XMLs, and generated JARs under build/.
README for additional insights
• Describes the four build targets (HTTP, JMS, Jakarta JMS, MQ), prerequisites per module, and how to run from Eclipse or command line.
• Emphasizes modular plug-in architecture and configurable transports via properties and class-path.
Detail without over-splitting
• Every major package boundary (core vs. module)
• Threading boundary (ControlThread vs. WorkerThreads)
• Property/configuration injection points