com.trivago.triava.time

Class OffsetTimeSource

java.lang.Object

com.trivago.triava.time.OffsetTimeSource

All Implemented Interfaces:

TimeSource

public class OffsetTimeSource
extends Object
implements TimeSource

A TimeSource that produces times with an offset to the actual time. Target use case for this class is to simulate running at a different time, e.g. when replaying an error scenario.

Author:

cesken

Constructor Summary

Constructors

Constructor and Description
OffsetTimeSource(long startTimeMillis, TimeSource parentTimeSource) Creates a TimeSource that produces times starting with the given startTimeMillis.

Method Summary

Modifier and Type	Method and Description
long	millis() Returns the time in milliseconds.
long	seconds() Returns the time in seconds.
void	shutdown() Shutdown the time source.
long	time(TimeUnit tu) Returns the time in the given time unit.

Methods inherited from class java.lang.Object

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

Constructor Detail

OffsetTimeSource

public OffsetTimeSource(long startTimeMillis,
                        TimeSource parentTimeSource)

Creates a TimeSource that produces times starting with the given startTimeMillis. All times returned are using an offset of "startTimeMillis - now", with now being the time of construction.

Parameters:

startTimeMillis - The start timestamp (artificial "now time")

parentTimeSource - The TimeSource on which the offset will be applied

Method Detail

time

public long time(TimeUnit tu)

Description copied from interface: TimeSource

Returns the time in the given time unit. It is recommended for unsupported TimeUnit values to throw an UnsupportedOperation exception.

Specified by:

time in interface TimeSource

Parameters:

tu - The time unit for the return value

Returns:

time in milliseconds since epoch

seconds

public long seconds()

Description copied from interface: TimeSource

Returns the time in seconds. Convenience method, with the same effect as passing TimeUnit.SECONDS to TimeSource.time(TimeUnit)

Specified by:

seconds in interface TimeSource

Returns:

time in seconds since epoch

millis

public long millis()

Description copied from interface: TimeSource

Returns the time in milliseconds. Convenience method, with the same effect as passing TimeUnit.MILLISECONDS TimeSource.time(TimeUnit)

Specified by:

millis in interface TimeSource

Returns:

time in milliseconds since epoch

shutdown

public void shutdown()

Description copied from interface: TimeSource

Shutdown the time source. Implementations should release all resources they use, like background threads, memory and connections to hardware clocks.

Specified by:

shutdown in interface TimeSource