com.thinkaurelius.titan.diskstorage.log

Class ReadMarker

java.lang.Object

com.thinkaurelius.titan.diskstorage.log.ReadMarker

public class ReadMarker
extends Object

Author:

Matthias Broecheler (me@matthiasb.com)

Method Summary

Methods

Modifier and Type	Method and Description
static ReadMarker	fromIdentifierOrTime(String id, long timestamp, TimeUnit unit) Starts reading the log from the last recorded point in the log for the given id.
static ReadMarker	fromNow() Starts reading the log such that it will start with the first entry written after now.
static ReadMarker	fromTime(long timestamp, TimeUnit unit) Starts reading the log from the given timestamp onward.
String	getIdentifier() Returns the configured identifier of this marker or throws an exception if none exists.
Timepoint	getStartTime(TimestampProvider times) Returns the start time of this marker in microseconds
boolean	hasIdentifier() Whether this read marker has a configured identifier

Methods inherited from class java.lang.Object

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

Method Detail

hasIdentifier

public boolean hasIdentifier()

Whether this read marker has a configured identifier

Returns:

getIdentifier

public String getIdentifier()

Returns the configured identifier of this marker or throws an exception if none exists.

Returns:

getStartTime

public Timepoint getStartTime(TimestampProvider times)

Returns the start time of this marker in microseconds

Returns:

fromNow

public static ReadMarker fromNow()

Starts reading the log such that it will start with the first entry written after now.

Returns:

fromTime

public static ReadMarker fromTime(long timestamp,
                  TimeUnit unit)

Starts reading the log from the given timestamp onward. The specified timestamp is included.

Parameters:

timestamp -

Returns:

fromIdentifierOrTime

public static ReadMarker fromIdentifierOrTime(String id,
                              long timestamp,
                              TimeUnit unit)

Starts reading the log from the last recorded point in the log for the given id. If the log has a record of such an id, it will use it as the starting point. If not, it will start from the given timestamp and set it as the first read record for the given id.

Identified read markers of this kind are useful to continuously read from the log. In the case of failure, the last read record can be recovered for the id and log reading can be resumed from there. Note, that some records might be read twice in that event depending on the guarantees made by a particular implementation.

Parameters:

id -

timestamp -

Returns: