com.espertech.esper.client.time

Class CurrentTimeSpanEvent

java.lang.Object

com.espertech.esper.client.time.TimerEvent

com.espertech.esper.client.time.CurrentTimeSpanEvent

All Implemented Interfaces:

Serializable

public final class CurrentTimeSpanEvent
extends TimerEvent
implements Serializable

Event for externally controlling the time within an EPRuntime or EPRuntimeIsolated instance, advancing time over a span of time.

The engine advances time according to the resolution passed in, completing at the target time provided.

When used without a resolution or with a negative or zero value for resolution the engine advances time according to any statement schedules that may be present. If no statement schedules are present, the engine simply advances time to the target time provided.

External clocking must be enabled via TimerControlEvent before this class can be used to externally feed time.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
CurrentTimeSpanEvent(long targetTime) Constructor taking only a target time to advance to.
CurrentTimeSpanEvent(long targetTime, long optionalResolution) Constructor taking a target time to advance to and a resoultion to use to advance time.

Method Summary

Modifier and Type	Method and Description
Long	getOptionalResolution() Returns the resolution for advancing time, or null if none provided.
long	getTargetTime() Returns the target time to advance engine time to.
void	setOptionalResolution(Long optionalResolution) Sets the resolution for advancing time, or provide a null value if no resolution is desired.
void	setTargetTime(long targetTime) Sets the target time to advance engine time to.

Methods inherited from class java.lang.Object

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

Constructor Detail

CurrentTimeSpanEvent

public CurrentTimeSpanEvent(long targetTime)

Constructor taking only a target time to advance to.

Use this constructor to have the engine decide the resolution at which time advances, according to present statement schedules.

Parameters:

targetTime - target time

CurrentTimeSpanEvent

public CurrentTimeSpanEvent(long targetTime,
                            long optionalResolution)

Constructor taking a target time to advance to and a resoultion to use to advance time.

Use this constructor to dictate a resolution at which time advances.

Parameters:

targetTime - target time

optionalResolution - should be a positive value

Method Detail

getTargetTime

public long getTargetTime()

Returns the target time to advance engine time to.

Returns:

target time

setTargetTime

public void setTargetTime(long targetTime)

Sets the target time to advance engine time to.

Parameters:

targetTime - target time

getOptionalResolution

public Long getOptionalResolution()

Returns the resolution for advancing time, or null if none provided.

Returns:

resolution

setOptionalResolution

public void setOptionalResolution(Long optionalResolution)

Sets the resolution for advancing time, or provide a null value if no resolution is desired.

Parameters:

optionalResolution - resolution