Package org.teavm.perf

Class BenchmarkOptions

java.lang.Object

org.teavm.perf.BenchmarkOptions

public class BenchmarkOptions
extends Object

Settings that override settings given by annotations, usually specified via command line. When neither annotations nor these options specify a setting, defaults are used. Defaults are the same as JMH ones, except for iteration count, iteration time and number of forks, which are much smaller. Unlike JVM, code produced by TeaVM needs little warmup: C code is compiled ahead of time, and browsers tier up hot JS and Wasm code within milliseconds. So short warmup is mostly needed to pick batch size and short iterations are sufficient to get stable results, while keeping running time reasonable.

Field Summary

Fields

Modifier and Type	Field	Description
static final int	DEFAULT_FORKS
static final IterationSettings	DEFAULT_MEASUREMENT
static final Set<BenchmarkMode>	DEFAULT_MODES
static final TimeUnit	DEFAULT_TIME_UNIT
static final IterationSettings	DEFAULT_WARMUP

Constructor Summary

Constructors

Constructor	Description
BenchmarkOptions()

Method Summary

Modifier and Type	Method	Description
List<Pattern>	getExcludes()
int	getForks()
List<Pattern>	getIncludes()
IterationSettings	getMeasurement()
Set<BenchmarkMode>	getModes()
int	getOperationsPerInvocation()
Map<String,List<String>>	getParams()
TimeUnit	getTimeUnit()
IterationSettings	getWarmup()
boolean	matches(BenchmarkInfo benchmark)	Checks whether benchmark should run.
int	resolveForks(BenchmarkInfo benchmark)
IterationSettings	resolveMeasurement(BenchmarkInfo benchmark)
Set<BenchmarkMode>	resolveModes(BenchmarkInfo benchmark)
int	resolveOperationsPerInvocation(BenchmarkInfo benchmark)
List<String>	resolveParamValues(ParamInfo param)
TimeUnit	resolveTimeUnit(BenchmarkInfo benchmark)
IterationSettings	resolveWarmup(BenchmarkInfo benchmark)
void	setForks(int forks)
void	setMeasurement(IterationSettings measurement)
void	setModes(Set<BenchmarkMode> modes)
void	setOperationsPerInvocation(int operationsPerInvocation)
void	setTimeUnit(TimeUnit timeUnit)
void	setWarmup(IterationSettings warmup)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

DEFAULT_WARMUP

public static final IterationSettings DEFAULT_WARMUP

DEFAULT_MEASUREMENT

public static final IterationSettings DEFAULT_MEASUREMENT

DEFAULT_FORKS

public static final int DEFAULT_FORKS

See Also:

• Constant Field Values

DEFAULT_MODES

public static final Set<BenchmarkMode> DEFAULT_MODES

DEFAULT_TIME_UNIT

public static final TimeUnit DEFAULT_TIME_UNIT

Constructor Details

BenchmarkOptions

public BenchmarkOptions()

Method Details

getIncludes

public List<Pattern> getIncludes()

getExcludes

public List<Pattern> getExcludes()

getWarmup

public IterationSettings getWarmup()

setWarmup

public void setWarmup(IterationSettings warmup)

getMeasurement

public IterationSettings getMeasurement()

setMeasurement

public void setMeasurement(IterationSettings measurement)

getForks

public int getForks()

setForks

public void setForks(int forks)

getModes

public Set<BenchmarkMode> getModes()

setModes

public void setModes(Set<BenchmarkMode> modes)

getTimeUnit

public TimeUnit getTimeUnit()

setTimeUnit

public void setTimeUnit(TimeUnit timeUnit)

getOperationsPerInvocation

public int getOperationsPerInvocation()

setOperationsPerInvocation

public void setOperationsPerInvocation(int operationsPerInvocation)

getParams

public Map<String,List<String>> getParams()

matches

public boolean matches(BenchmarkInfo benchmark)

Checks whether benchmark should run. Like in JMH, patterns are matched against any part of fully qualified benchmark name.

resolveWarmup

public IterationSettings resolveWarmup(BenchmarkInfo benchmark)

resolveMeasurement

public IterationSettings resolveMeasurement(BenchmarkInfo benchmark)

resolveForks

public int resolveForks(BenchmarkInfo benchmark)

resolveModes

public Set<BenchmarkMode> resolveModes(BenchmarkInfo benchmark)

resolveTimeUnit

public TimeUnit resolveTimeUnit(BenchmarkInfo benchmark)

resolveOperationsPerInvocation

public int resolveOperationsPerInvocation(BenchmarkInfo benchmark)

resolveParamValues

public List<String> resolveParamValues(ParamInfo param)