com.bigdata.journal

Interface ITimestampService

All Superinterfaces:

IService, Remote

All Known Subinterfaces:

IDistributedTransactionService, ITransactionService

All Known Implementing Classes:

AbstractEmbeddedTransactionService, AbstractHATransactionService, AbstractTransactionService, DelegateTransactionService, DistributedTransactionService, EmbeddedFederation.EmbeddedTransactionServiceImpl, JournalTransactionService, TestDistributedTransactionServiceRestart.MockDistributedTransactionService, TestTransactionService.MockTransactionService

public interface ITimestampService
extends IService

A service for unique timestamps.

Version:

$Id$

Author:

Bryan Thompson

Method Summary

Methods

Modifier and Type	Method and Description
long	nextTimestamp() Return the next unique timestamp.

Methods inherited from interface com.bigdata.service.IService

destroy, getHostname, getServiceIface, getServiceName, getServiceUUID

Method Detail

nextTimestamp

long nextTimestamp()
                   throws IOException

Return the next unique timestamp. Timestamps must be strictly increasing.

Note: This method MUST return strictly increasing values, even when it is invoked by concurrent threads. While other implementations are possible and may be more efficient, one way to insure thread safety is to synchronize on some object such that the implementaiton exhibits a FIFO behavior.

Throws:

IOException - if there is an RMI problem.

See Also:

TimestampServiceUtil.nextTimestamp(ITimestampService)