Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Java Performance/Scalability Testing Framework
branch: master

change org to codefutures

latest commit bf05b73fdb
Andy Grove authored
Failed to load latest commit information.
src version 2.0.3
.gitignore convert to maven
LICENSE.txt license info
README.md change copyright
jperf.iml Add support for writing csv to file
log4j2.xml jperf now uses slf4j / log4j2
pom.xml change org to codefutures

README.md

JPerf is a simple performance and scalability testing framework for Java. Think of it as JUnit for performance tests.

JPerf is distributed under the Apache License 2.0 (see LICENSE.txt).

The latest version can be downloaded from https://github.com/codefutures/jperf/releases

JPerf can be used programmatically or from the command line to run scalability tests again any class implementing the PerfTest interface.

Programmatic use:

// create config
PerfTestConfig config = JPerf.newConfigBuilder()
    .minThreads(1)
    .maxThreads(10)
    .duration(100)
    .testFactory(() -> new EmptyTest())
    .build();

// run test
JPerf.run(config);

Command-line use:

usage: jperf [-class <arg>] [-duration <arg>] [-increment <arg>] [-max
       <arg>] [-min <arg>]
 -class <arg>       Name of class that implemented org.jperf.PerfTest
 -duration <arg>    The duration in milliseconds (per thread level)
 -increment <arg>   The number of threads to increment by
 -max <arg>         The maximum number of threads to test with
 -min <arg>         The number of threads to start testing with

All arguments are optional, except for 'class'.

Example of command line use:

java -classpath yourclasspathhere org.jperf.JPerf -class org.jperf.noop.NoOpTest

In either case, output similar to the following will be written to stdout.

Running on Nov 9, 2014 11:15:39 AM with config: PerfTestConfig{minThreads=1, maxThreads=10, threadIncrement=1, duration=1000}
With 1 threads there were 200,382,238 samples
With 2 threads there were 390,074,461 samples
With 3 threads there were 304,151,933 samples
With 4 threads there were 277,960,408 samples
With 5 threads there were 231,347,787 samples
With 6 threads there were 180,998,431 samples
With 7 threads there were 172,647,235 samples
With 8 threads there were 145,501,665 samples
With 9 threads there were 135,152,189 samples
With 10 threads there were 124,737,834 samples
Stopping threads
Finished

JPerf has dependencies on the following open source projects:

  • Apache CLI
  • Google Guava

Copyright (C) 2007-2014 CodeFutures

Something went wrong with that request. Please try again.