Package io.nosqlbench.engine.api.activityapi.core

Interface Activity

All Superinterfaces:

ActivityDefObserver, java.lang.Comparable<Activity>, ProgressCapable, StateCapable

All Known Implementing Classes:

SimpleActivity, StandardActivity, StandardActivityType

public interface Activity
extends java.lang.Comparable<Activity>, ActivityDefObserver, ProgressCapable, StateCapable

Provides the components needed to build and run an activity a runtime. The easiest way to build a useful Activity is to extend SimpleActivity.

Method Summary

Modifier and Type	Method	Description
void	closeAutoCloseables()	Close all autocloseables that have been registered with this Activity.
ActionDispenser	getActionDispenserDelegate()
ActivityController	getActivityController()
io.nosqlbench.engine.api.activityimpl.ActivityDef	getActivityDef()
default java.lang.String	getAlias()
java.io.InputStream	getConsoleIn()
java.io.PrintWriter	getConsoleOut()
RateLimiter	getCycleLimiter()	Get the current cycle rate limiter for this activity.
RateLimiter	getCycleRateLimiter(java.util.function.Supplier<? extends RateLimiter> supplier)	Get or create the cycle rate limiter in a safe way.
default java.lang.String	getCycleSummary()
default java.util.function.Function<java.lang.Throwable,java.lang.String>	getErrorNameMapper()	When a driver needs to identify an error uniquely for the purposes of routing it to the correct error handler, or naming it in logs, or naming metrics, override this method in your activity.
ErrorMetrics	getExceptionMetrics()
InputDispenser	getInputDispenserDelegate()
ActivityInstrumentation	getInstrumentation()	Get or create the instrumentation needed for this activity.
OutputDispenser	getMarkerDispenserDelegate()
int	getMaxTries()
MotorDispenser	getMotorDispenserDelegate()
default io.nosqlbench.engine.api.activityimpl.ParameterMap	getParams()
RateLimiter	getPhaseLimiter()	Get the current phase rate limiter for this activity.
RateLimiter	getPhaseRateLimiter(java.util.function.Supplier<? extends RateLimiter> supplier)	Get or create the phase RateLimiter in a concurrent-safe way.
IntPredicateDispenser	getResultFilterDispenserDelegate()
com.codahale.metrics.Timer	getResultTimer()
RunState	getRunState()
long	getStartedAtMillis()
RateLimiter	getStrideLimiter()	Get the current stride rate limiter for this activity.
RateLimiter	getStrideRateLimiter(java.util.function.Supplier<? extends RateLimiter> supplier)	Get or create the stride RateLimiter in a concurrent-safe way.
default void	initActivity()
void	registerAutoCloseable(java.lang.AutoCloseable closeable)	Register an object which should be closed after this activity is shutdown.
void	setActionDispenserDelegate(ActionDispenser actionDispenser)
void	setActivityController(ActivityController activityController)	Provide the activity with the controls needed to stop itself.
void	setConsoleOut(java.io.PrintWriter writer)
void	setCycleLimiter(RateLimiter rateLimiter)	Set the cycle rate limiter for this activity.
void	setInputDispenserDelegate(InputDispenser inputDispenser)
void	setMotorDispenserDelegate(MotorDispenser motorDispenser)
void	setOutputDispenserDelegate(OutputDispenser outputDispenser)
void	setPhaseLimiter(RateLimiter rateLimiter)	Set the phase rate limiter for this activity.
void	setResultFilterDispenserDelegate(IntPredicateDispenser resultFilterDispenser)
void	setRunState(RunState runState)
void	setStrideLimiter(RateLimiter rateLimiter)	Set the stride rate limiter for this activity.
default void	shutdownActivity()

Methods inherited from interface io.nosqlbench.engine.api.activityapi.core.ActivityDefObserver

onActivityDefUpdate

Methods inherited from interface java.lang.Comparable

compareTo

Methods inherited from interface io.nosqlbench.engine.api.activityimpl.input.ProgressCapable

getProgressMeter

Method Details

setActivityController

void setActivityController(ActivityController activityController)

Provide the activity with the controls needed to stop itself.

Parameters:

activityController - The dedicated control interface for this activity

getActivityController

ActivityController getActivityController()

registerAutoCloseable

void registerAutoCloseable(java.lang.AutoCloseable closeable)

Register an object which should be closed after this activity is shutdown.

Parameters:

closeable - An Autocloseable object

getActivityDef

io.nosqlbench.engine.api.activityimpl.ActivityDef getActivityDef()

getAlias

default java.lang.String getAlias()

getParams

default io.nosqlbench.engine.api.activityimpl.ParameterMap getParams()

initActivity

default void initActivity()

closeAutoCloseables

void closeAutoCloseables()

Close all autocloseables that have been registered with this Activity.

getMotorDispenserDelegate

MotorDispenser getMotorDispenserDelegate()

setMotorDispenserDelegate

void setMotorDispenserDelegate(MotorDispenser motorDispenser)

getInputDispenserDelegate

InputDispenser getInputDispenserDelegate()

setInputDispenserDelegate

void setInputDispenserDelegate(InputDispenser inputDispenser)

getActionDispenserDelegate

ActionDispenser getActionDispenserDelegate()

setActionDispenserDelegate

void setActionDispenserDelegate(ActionDispenser actionDispenser)

getResultFilterDispenserDelegate

IntPredicateDispenser getResultFilterDispenserDelegate()

setResultFilterDispenserDelegate

void setResultFilterDispenserDelegate(IntPredicateDispenser resultFilterDispenser)

getMarkerDispenserDelegate

OutputDispenser getMarkerDispenserDelegate()

setOutputDispenserDelegate

void setOutputDispenserDelegate(OutputDispenser outputDispenser)

getRunState

RunState getRunState()

Specified by:

getRunState in interface StateCapable

setRunState

void setRunState(RunState runState)

getStartedAtMillis

long getStartedAtMillis()

shutdownActivity

default void shutdownActivity()

getCycleSummary

default java.lang.String getCycleSummary()

getCycleLimiter

RateLimiter getCycleLimiter()

Get the current cycle rate limiter for this activity. The cycle rate limiter is used to throttle the rate at which cycles are dispatched across all threads in the activity

Returns:

the cycle RateLimiter

setCycleLimiter

void setCycleLimiter(RateLimiter rateLimiter)

Set the cycle rate limiter for this activity. This method should only be used in a non-concurrent context. Otherwise, the supplier version getCycleRateLimiter(Supplier) should be used.

Parameters:

rateLimiter - The cycle RateLimiter for this activity

getCycleRateLimiter

RateLimiter getCycleRateLimiter(java.util.function.Supplier<? extends RateLimiter> supplier)

Get or create the cycle rate limiter in a safe way. Implementations should ensure that this method is synchronized or that each requester gets the same cycle rate limiter for the activity.

Parameters:

supplier - A RateLimiter Supplier

Returns:

An extant or newly created cycle RateLimiter

getStrideLimiter

RateLimiter getStrideLimiter()

Get the current stride rate limiter for this activity. The stride rate limiter is used to throttle the rate at which new strides are dispatched across all threads in an activity.

Returns:

The stride RateLimiter

setStrideLimiter

void setStrideLimiter(RateLimiter rateLimiter)

Set the stride rate limiter for this activity. This method should only be used in a non-concurrent context. Otherwise, the supplier version getStrideRateLimiter(Supplier)} should be used.

Parameters:

rateLimiter - The stride RateLimiter for this activity.

getStrideRateLimiter

RateLimiter getStrideRateLimiter(java.util.function.Supplier<? extends RateLimiter> supplier)

Get or create the stride RateLimiter in a concurrent-safe way. Implementations should ensure that this method is synchronized or that each requester gets the same stride rate limiter for the activity.

Parameters:

supplier - A RateLimiter Supplier

Returns:

An extant or newly created stride RateLimiter

getPhaseLimiter

RateLimiter getPhaseLimiter()

Get the current phase rate limiter for this activity. The phase rate limiter is used to throttle the rate at which new phases are dispatched across all threads in an activity.

Returns:

The stride RateLimiter

getResultTimer

com.codahale.metrics.Timer getResultTimer()

setPhaseLimiter

void setPhaseLimiter(RateLimiter rateLimiter)

Set the phase rate limiter for this activity. This method should only be used in a non-concurrent context. Otherwise, the supplier version getPhaseRateLimiter(Supplier)} should be used.

Parameters:

rateLimiter - The phase RateLimiter for this activity.

getPhaseRateLimiter

RateLimiter getPhaseRateLimiter(java.util.function.Supplier<? extends RateLimiter> supplier)

Get or create the phase RateLimiter in a concurrent-safe way. Implementations should ensure that this method is synchronized or that each requester gets the same phase rate limiter for the activity.

Parameters:

supplier - A RateLimiter Supplier

Returns:

An extant or newly created phase RateLimiter

getInstrumentation

ActivityInstrumentation getInstrumentation()

Get or create the instrumentation needed for this activity. This provides a single place to find and manage, and document instrumentation that is uniform across all activities.

Returns:

A new or existing instrumentation object for this activity.

getConsoleOut

java.io.PrintWriter getConsoleOut()

getConsoleIn

java.io.InputStream getConsoleIn()

setConsoleOut

void setConsoleOut(java.io.PrintWriter writer)

getExceptionMetrics

ErrorMetrics getExceptionMetrics()

getErrorNameMapper

default java.util.function.Function<java.lang.Throwable,java.lang.String> getErrorNameMapper()

When a driver needs to identify an error uniquely for the purposes of routing it to the correct error handler, or naming it in logs, or naming metrics, override this method in your activity.

Returns:

A function that can reliably and safely map an instance of Throwable to a stable name.

getMaxTries

int getMaxTries()