org.apache.iotdb.tsfile.read.common

Class TimeRange

java.lang.Object

org.apache.iotdb.tsfile.read.common.TimeRange

All Implemented Interfaces:

Comparable<TimeRange>

public class TimeRange
extends Object
implements Comparable<TimeRange>

interval [min,max] of long data type

Reference: http://www.java2s.com/Code/Java/Collections-Data-Structure/Anumericalinterval.htm

Constructor Summary

Constructors

Constructor and Description
TimeRange(long min, long max) Initialize a closed interval [min,max].

Method Summary

Modifier and Type	Method and Description
int	compareTo(TimeRange r)
boolean	contains(long time)
boolean	contains(long min, long max)
boolean	contains(TimeRange r) Check whether this TimeRange contains r.
boolean	equals(Object o)
IExpression	getExpression()
boolean	getLeftClose()
long	getMax() Get the upper range boundary.
long	getMin() Get the lower range bundary.
List<TimeRange>	getRemains(List<TimeRange> timeRangesPrev) Get the remaining time ranges in the current ranges but not in timeRangesPrev.
boolean	getRightClose()
int	hashCode()
boolean	intersects(TimeRange r) Here are some examples.
boolean	overlaps(TimeRange rhs) Check if two TimeRanges overlap
void	set(long min, long max) Set a closed interval [min,max].
void	setLeftClose(boolean leftClose)
void	setMax(long max)
void	setMin(long min)
void	setRightClose(boolean rightClose)
static List<TimeRange>	sortAndMerge(List<TimeRange> unionCandidates) Return the union of the given time ranges.
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

TimeRange

public TimeRange(long min,
                 long max)

Initialize a closed interval [min,max].

Parameters:

min - the left endpoint of the closed interval

max - the right endpoint of the closed interval

Method Detail

compareTo

public int compareTo(TimeRange r)

Specified by:

compareTo in interface Comparable<TimeRange>

setMin

public void setMin(long min)

setMax

public void setMax(long max)

contains

public boolean contains(TimeRange r)

Check whether this TimeRange contains r.

Returns:

true if the given range lies in this range, inclusively

contains

public boolean contains(long min,
                        long max)

contains

public boolean contains(long time)

set

public void set(long min,
                long max)

Set a closed interval [min,max].

Parameters:

min - the left endpoint of the closed interval

max - the right endpoint of the closed interval

getMin

public long getMin()

Get the lower range bundary.

Returns:

The lower range boundary.

getMax

public long getMax()

Get the upper range boundary.

Returns:

The upper range boundary.

intersects

public boolean intersects(TimeRange r)

Here are some examples.

[1,3] does not intersect with (4,5].

[1,3) does not intersect with (3,5].

[1,3] does not intersect with [5,6].

[1,3] intersects with [2,5].

[1,3] intersects with (3,5].

[1,3) intersects with (2,5].

Note: this method treats [1,3] and [4,5] as two "intersected" interval even if they are not truly intersected.

Parameters:

r - the given time range

Returns:

true if the current time range "intersects" with the given time range r

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

overlaps

public boolean overlaps(TimeRange rhs)

Check if two TimeRanges overlap

Parameters:

rhs - the given time range

Returns:

true if the current time range overlaps with the given time range rhs

toString

public String toString()

Overrides:

toString in class Object

setLeftClose

public void setLeftClose(boolean leftClose)

setRightClose

public void setRightClose(boolean rightClose)

getLeftClose

public boolean getLeftClose()

getRightClose

public boolean getRightClose()

sortAndMerge

public static List<TimeRange> sortAndMerge(List<TimeRange> unionCandidates)

Return the union of the given time ranges.

Parameters:

unionCandidates - time ranges to be merged

Returns:

the union of time ranges

getRemains

public List<TimeRange> getRemains(List<TimeRange> timeRangesPrev)

Get the remaining time ranges in the current ranges but not in timeRangesPrev.

NOTE the primitive timeRange is always a closed interval [min,max] and only in this function are leftClose and rightClose changed.

Parameters:

timeRangesPrev - time ranges union in ascending order of the start time

Returns:

the remaining time ranges

getExpression

public IExpression getExpression()