com.bigdata.counters.query

Class TimeRange

java.lang.Object

com.bigdata.counters.query.TimeRange

public class TimeRange
extends Object

Utility class to interpret URL query parameters as a time range. Some examples of supported expressions include:

12m

12 minutes into the available history.

-4h

4 hours before the end of the available history.

The general form is either ([+-]?)([0-9]+)([mhd]).

The implied fromTime is the start of the available history. The implied toTime is the end of the available history. The implied units are TimeUnit.MINUTES.

Some query examples are:

fromTime=-10m&period=Minutes

The last 10 minutes of the available history.

toTime=+4h

The first 4 hours of the available history, with one sample every minute.

toTime=+4h&period=Hours

The first 4 hours of the available history, with one sample every hour.

fromTime=+2h&toTime=+4h

The data from the 2nd hour up to (but not including) the 4th hour of the available history, with one sample every minute.

Version:

$Id$

Author:

Bryan Thompson

Field Summary

Fields

Modifier and Type	Field and Description
long	dur The duration in the specified units.
protected static Pattern	pattern
Boolean	relative
TimeUnit	unit The units in which the duration was specified.

Constructor Summary

Constructors

Constructor and Description
TimeRange(String s)

Method Summary

Methods

Modifier and Type	Method and Description
long	getAdjustedTimestamp(long ts)

Methods inherited from class java.lang.Object

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

Field Detail

relative

public final Boolean relative

unit

public final TimeUnit unit

The units in which the duration was specified.

dur

public final long dur

The duration in the specified units.

pattern

protected static final Pattern pattern

Constructor Detail

TimeRange

public TimeRange(String s)

Method Detail

getAdjustedTimestamp

public long getAdjustedTimestamp(long ts)

Parameters:

ts - A reference timestamp from within the available history.

Returns:

The exclusive upper bound.