com.sun.faban.driver.engine
Class Result

java.lang.Object
  com.sun.faban.driver.Result
      com.sun.faban.driver.engine.Result

public class Result
extends Result

The implementation of the Result abstract class.

Author:

Akara Sucharitakul

Method Summary

double[]	get90thPctResponse() Obtains the 90th percentile of the response time of each operation.
double	get90thPctResponse(String opsName) Obtains the 90th percentile of the response time for a given operation.
double[]	getAvgResponse() Obtains the average response time of each operation.
double	getAvgResponse(String opsName) Obtains the average response time of a given operation.
static Result	getInstance() Obtains the result instance used for programmatic access to the result.
double[]	getMaxResponse() Obtains the maximum response time of each operation.
double	getMaxResponse(String opsName) Obtains the maximum response time of a given operation.
double	getMetric() Obtains the throughput metric the run has achieved.
int[]	getOpsCountSteady() Obtains the number of operations of each type successfully executed during steady state.
int	getOpsCountSteady(String opsName) Obtains the number of operations of a certain type successfully executed during steady state.
int[]	getOpsCountTotal() Obtains the number of operatioins of each type successfully executed during the whole run.
int	getOpsCountTotal(String opsName) Obtains the number of operations of a certain type successfully executed during the whole run.
double[]	getOpsMix() Obtains the actual mix of each operation.
double	getOpsMix(String opsName) Obtains the actual mix of the operation.
String[]	getOpsNames() Obtains the defined operation names, in sequence.
double[]	getResponseSD() Obtains the standard deviation of the response time of each operation.
double	getResponseSD(String opsName) Obtains the standard deviation of the response time for a given operation.
int	getScale() Obtains the scale of the run.
int	getSteadyState() Obtains the steady state time or cycles of the run, dependent on the run control.

Methods inherited from class java.lang.Object

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

Method Detail

getInstance

public static Result getInstance()

Obtains the result instance used for programmatic access to the result.

Returns:

instance The result instance

getSteadyState

public int getSteadyState()

Obtains the steady state time or cycles of the run, dependent on the run control. Times are returned in seconds.

Specified by:

getSteadyState in class Result

Returns:

The run's steady state

getScale

public int getScale()

Obtains the scale of the run.

Specified by:

getScale in class Result

Returns:

The scale of the run.

getMetric

public double getMetric()

Obtains the throughput metric the run has achieved. This is the same as the operation rate or transaction rate.

Specified by:

getMetric in class Result

Returns:

The metric

getOpsNames

public String[] getOpsNames()

Obtains the defined operation names, in sequence.

Specified by:

getOpsNames in class Result

Returns:

The operation names.

getOpsCountSteady

public int getOpsCountSteady(String opsName)

Obtains the number of operations of a certain type successfully executed during steady state.

Specified by:

getOpsCountSteady in class Result

Parameters:

opsName - The name of the operation to query

Returns:

The number of successful operations

getOpsCountSteady

public int[] getOpsCountSteady()

Obtains the number of operations of each type successfully executed during steady state. The index into the array returned corresponds to the index of getOpsNames().

Specified by:

getOpsCountSteady in class Result

Returns:

The number of successful operations for each type

getOpsCountTotal

public int getOpsCountTotal(String opsName)

Obtains the number of operations of a certain type successfully executed during the whole run.

Specified by:

getOpsCountTotal in class Result

Parameters:

opsName - The name of the operation to query

Returns:

The number of successful operations

getOpsCountTotal

public int[] getOpsCountTotal()

Obtains the number of operatioins of each type successfully executed during the whole run. The index into the array returned corresponds to the index of getOpsNames().

Specified by:

getOpsCountTotal in class Result

Returns:

The number of successful operations for each type

getOpsMix

public double getOpsMix(String opsName)

Obtains the actual mix of the operation. The return value ranges between 0 and 1. To obtain the percent mix, multiply the mix by 100.

Specified by:

getOpsMix in class Result

Parameters:

opsName - The name of the operation to query

Returns:

The mix ratio of the operation during steady state.

getOpsMix

public double[] getOpsMix()

Obtains the actual mix of each operation. The return values range between 0 and 1. To obtain the percent mix, multiply the mix by 100. The index into the array returned corresponds to the index of getOpsNames().

Specified by:

getOpsMix in class Result

Returns:

The mix ratio of all operations during steady state.

getAvgResponse

public double getAvgResponse(String opsName)

Obtains the average response time of a given operation. The unit of the response times is reflected by the response time unit setting in the @BenchmarkDriver annotation used to annotate the respective driver. This operation returns NaN if the operation has never been accessed.

Specified by:

getAvgResponse in class Result

Parameters:

opsName - The name of the operation to query

Returns:

The average response time of the operation during steady state

getAvgResponse

public double[] getAvgResponse()

Obtains the average response time of each operation. The unit of the response times is reflected by the response time unit setting in the @BenchmarkDriver annotation used to annotate the respective driver. Returns NaN for an operation if it has never been accessed.

Specified by:

getAvgResponse in class Result

Returns:

The average response time of all operations during steady state

getMaxResponse

public double getMaxResponse(String opsName)

Obtains the maximum response time of a given operation. The unit of the response times is reflected by the response time unit setting in the @BenchmarkDriver annotation used to annotate the respective driver. This operation returns NaN if the operation has never been accessed.

Specified by:

getMaxResponse in class Result

Parameters:

opsName - The name of the operation to query

Returns:

The maximum response time of the operation during steady state

getMaxResponse

public double[] getMaxResponse()

Obtains the maximum response time of each operation. The unit of the response times is reflected by the response time unit setting in the @BenchmarkDriver annotation used to annotate the respective driver. Returns NaN for an operation if it has never been accessed.

Specified by:

getMaxResponse in class Result

Returns:

The maximum response time of all operations during steady state

get90thPctResponse

public double get90thPctResponse(String opsName)

Obtains the 90th percentile of the response time for a given operation. The unit of the response times is reflected by the response time unit setting in the @BenchmarkDriver annotation used to annotate the respective driver. This operation returns NaN if the operation has never been accessed.

Specified by:

get90thPctResponse in class Result

Parameters:

opsName - The name of the operation to query

Returns:

The 90th percentile of the response time of the operation during steady state

get90thPctResponse

public double[] get90thPctResponse()

Obtains the 90th percentile of the response time of each operation. The unit of the response times is reflected by the response time unit setting in the @BenchmarkDriver annotation used to annotate the respective driver. Returns NaN for an operation if it has never been accessed.

Specified by:

get90thPctResponse in class Result

Returns:

The 90th percentile of the response time of all operations during steady state

getResponseSD

public double getResponseSD(String opsName)

Obtains the standard deviation of the response time for a given operation. The unit of the response times is reflected by the response time unit setting in the @BenchmarkDriver annotation used to annotate the respective driver. This operation returns NaN if the operation has never been accessed.

Specified by:

getResponseSD in class Result

Parameters:

opsName - The name of the operation to query

Returns:

The standard deviation of the response time of the operation during steady state

getResponseSD

public double[] getResponseSD()

Obtains the standard deviation of the response time of each operation. The unit of the response times is reflected by the response time unit setting in the @BenchmarkDriver annotation used to annotate the respective driver. Returns NaN for an operation if it has never been accessed.

Specified by:

getResponseSD in class Result

Returns:

The standard deviation of the response time of all operations during steady state