net.openhft.chronicle.bytes

Class DistributedUniqueTimeProvider

java.lang.Object

net.openhft.chronicle.core.io.SimpleCloseable

net.openhft.chronicle.bytes.DistributedUniqueTimeProvider

All Implemented Interfaces:

Closeable, AutoCloseable, net.openhft.chronicle.core.io.ManagedCloseable, net.openhft.chronicle.core.io.QueryCloseable, net.openhft.chronicle.core.io.ReferenceOwner, net.openhft.chronicle.core.time.TimeProvider

public class DistributedUniqueTimeProvider
extends net.openhft.chronicle.core.io.SimpleCloseable
implements net.openhft.chronicle.core.time.TimeProvider

Timestamps are unique across systems using a predefined hostId

Field Summary

Fields inherited from interface net.openhft.chronicle.core.io.ReferenceOwner

INIT

Method Summary

Modifier and Type	Method and Description
long	currentTimeMicros() Return a unique, monotonically increasing microsecond timestamp where the lowest two digits of the microseconds is the hostId.
long	currentTimeMillis()
long	currentTimeNanos() Return a unique, monotonically increasing nanosecond timestamp where the lowest two digits of the nanoseconds is the hostId.
DistributedUniqueTimeDeduplicator	deduplicator() A deduplicator to help recognise duplicate timestamps for a hostId
static DistributedUniqueTimeProvider	forHostId(int hostId)
DistributedUniqueTimeProvider	hostId(int hostId)
static long	hostIdFor(long timestampWithHostId) Extract the hostId from the timestampWithHostId
static DistributedUniqueTimeProvider	instance()
protected void	performClose()
DistributedUniqueTimeProvider	provider(net.openhft.chronicle.core.time.TimeProvider provider)
static long	timestampFor(long timestampWithHostId) Extract the timestamp in nanoseconds from the timestampWithHostId

Methods inherited from class net.openhft.chronicle.core.io.SimpleCloseable

close, isClosed

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.openhft.chronicle.core.time.TimeProvider

currentTime

Methods inherited from interface net.openhft.chronicle.core.io.ReferenceOwner

referenceId, referenceName, temporary

Methods inherited from interface net.openhft.chronicle.core.io.ManagedCloseable

createdHere, throwExceptionIfClosed, warnAndCloseIfNotClosed

Methods inherited from interface net.openhft.chronicle.core.io.Closeable

closeQuietly, closeQuietly

Methods inherited from interface net.openhft.chronicle.core.io.QueryCloseable

isClosing

Method Detail

instance

public static DistributedUniqueTimeProvider instance()

performClose

protected void performClose()

Overrides:

performClose in class net.openhft.chronicle.core.io.SimpleCloseable

forHostId

public static DistributedUniqueTimeProvider forHostId(int hostId)

hostId

public DistributedUniqueTimeProvider hostId(int hostId)

provider

public DistributedUniqueTimeProvider provider(net.openhft.chronicle.core.time.TimeProvider provider)

currentTimeMillis

public long currentTimeMillis()

Specified by:

currentTimeMillis in interface net.openhft.chronicle.core.time.TimeProvider

Returns:

Ordinary millisecond timestamp

currentTimeMicros

public long currentTimeMicros()
                       throws IllegalStateException

Return a unique, monotonically increasing microsecond timestamp where the lowest two digits of the microseconds is the hostId.

Specified by:

currentTimeMicros in interface net.openhft.chronicle.core.time.TimeProvider

Returns:

the timestamps with hostId as a long

Throws:

IllegalStateException - if the underlying resources have been released/closed

timestampFor

public static long timestampFor(long timestampWithHostId)

Extract the timestamp in nanoseconds from the timestampWithHostId

Parameters:

timestampWithHostId - to extract from

Returns:

the timestamp

hostIdFor

public static long hostIdFor(long timestampWithHostId)

Extract the hostId from the timestampWithHostId

Parameters:

timestampWithHostId - to extract from

Returns:

the hostId

currentTimeNanos

public long currentTimeNanos()
                      throws IllegalStateException

Return a unique, monotonically increasing nanosecond timestamp where the lowest two digits of the nanoseconds is the hostId.

Specified by:

currentTimeNanos in interface net.openhft.chronicle.core.time.TimeProvider

Returns:

the timestamps with hostId as a long

Throws:

IllegalStateException - if the underlying resources have been released/closed

deduplicator

public DistributedUniqueTimeDeduplicator deduplicator()

A deduplicator to help recognise duplicate timestamps for a hostId