It's a benchmarking library, not a general purpose tool. To use it, you must implement test scenarios by yourself.
locust4j-http is a demo and a good start.
Write user test scenarios in Java
Because it's written in Java, you can use all the things in the Java Ecosystem.
Locust4j uses threadpool to execute your code with low overhead.
git clone https://github.com/myzhan/locust4j cd locust4j mvn package
Add this to your Maven project's pom.xml.
<dependency> <groupId>com.github.myzhan</groupId> <artifactId>locust4j</artifactId> <version>1.0.3</version> </dependency>
This file represents all the exposed APIs of Locust4j.
- The task instance is shared across multiply threads, the execute method must be thread-safe.
- Don't catch all exceptions in the execute method, just leave every unexpected exceptions to locust4j.
- When stop-the-world happens in the JVM, you may get wrong response time reported to the master.
- Because of the JIT compiler, Locust4j will run faster as time goes by, which will lead to shorter response time.
Open source licensed under the MIT license (see LICENSE file for details).