com.browsermob.api
Interface TransactionStep

public interface TransactionStep

Aggregate information about a particular step in an RBU or VU script. This object contains basic timing information, such as the start and end time, as well as the total number of bytes transfered during this step.

Method Summary

long	getBytes() The total number of bytes received via HTTP requests while this step was active.
java.util.Date	getEnd() Returns the time the step ended, or null if the step has not yet ended.
TransactionStepObject	getFirstObject() Finds the first (chronologically ordered) object associated with this step, or null if there are no objects.
TransactionStepObject	getLastObject() Finds the last (chronologically ordered) object associated with this step, or null if there are no objects.
java.util.List<TransactionStepObject>	getObjects() Returns all objects associated with this step, or an empty list of no objects are.
java.util.Date	getStart() Returns the time the step started.
long	getTimeActive() The time spent actively running the script, such as spent waiting for a page to finish loading.
long	getTimePaused() The time spent actively paused due to an explicit call to pause() by the script author.
java.lang.String	put(java.lang.String name, java.lang.String value) Associates a generic name/value pair with this step.

Method Detail

put

java.lang.String put(java.lang.String name,
                     java.lang.String value)

Associates a generic name/value pair with this step. The name must be unique. If you are putting a value on this step with a previously used name, then the old value will be lost. The name/value pair will be associated with this step's ID when stored in the test results.

Parameters:

name - the unique name of the name/value pair

value - the value to be stored

Returns:

returns null if this is a new name, otherwise returns the old value being replaced

getStart

java.util.Date getStart()

Returns the time the step started.

Returns:

the time the step started.

getEnd

java.util.Date getEnd()

Returns the time the step ended, or null if the step has not yet ended.

Returns:

the time the step ended.

getBytes

long getBytes()

The total number of bytes received via HTTP requests while this step was active. If the step is currently active, this number may grow as additional HTTP requests are made.

Returns:

the number of bytes received.

getTimePaused

long getTimePaused()

The time spent actively paused due to an explicit call to pause() by the script author.

Returns:

the time, in milliseconds, that this step was paused due to a pause() function call.

getTimeActive

long getTimeActive()

The time spent actively running the script, such as spent waiting for a page to finish loading.

Returns:

the time, in milliseconds, that this step was actively running or waiting for a response.

getFirstObject

TransactionStepObject getFirstObject()

Finds the first (chronologically ordered) object associated with this step, or null if there are no objects. Good in conjuction with getLastObject() to determine the total time spent downloading objects for the step.

Returns:

the first object

getLastObject

TransactionStepObject getLastObject()

Finds the last (chronologically ordered) object associated with this step, or null if there are no objects. Good in conjuction with getFirstObject() to determine the total time spent downloading objects for the step.

Returns:

the last object

getObjects

java.util.List<TransactionStepObject> getObjects()

Returns all objects associated with this step, or an empty list of no objects are.

Returns:

all objects