ShardRange Class

Reference

Package:: com.microsoft.azure.elasticdb.shard.base

java.lang.Object
- Comparable<ShardRange>
- - com.microsoft.azure.elasticdb.shard.base.ShardRange

public class ShardRange

A range of shard keys between a low key and a high key. The low key is inclusive (part of the range) while the high key is exclusive (not part of the range). The ShardRange class is immutable.

Field Summary

Modifier and Type	Field and Description
final ShardRange	NULL

Constructor Summary

Constructor	Description
ShardRange()
ShardRange(ShardKey low, ShardKey high)	Constructs a shard range from low boundary (inclusive) to high high boundary (exclusive).

Constructor

Description

ShardRange()

ShardRange(ShardKey low, ShardKey high)

Constructs a shard range from low boundary (inclusive) to high high boundary (exclusive).

Method Summary

Modifier and Type	Method and Description
int	compareTo(ShardRange other) Performs comparison between two shard range values.
boolean	contains(ShardKey key) Checks whether the specified key is inside the range.
boolean	contains(ShardRange range) Checks whether the range is inside the range.
boolean	equals(Object obj) Determines whether the specified object is equal to the current object.
boolean	equals(ShardRange other) Performs equality comparison with another given ShardRange.
ShardRange	getFullRange(ShardKeyType keyType) Gets a shard range corresponding to a specified key type.
ShardRange	getFullRangeBinary() Full range that starts from the min value for a key to the max value.
ShardRange	getFullRangeDateTime() Full range that starts from the min value for a key to the max value.
ShardRange	getFullRangeDateTimeOffset() Full range that starts from the min value for a key to the max value.
ShardRange	getFullRangeGuid() Full range that starts from the min value for a key to the max value.
ShardRange	getFullRangeInt32() Full range that starts from the min value for a key to the max value.
ShardRange	getFullRangeInt64() Full range that starts from the min value for a key to the max value.
ShardRange	getFullRangeTimeSpan() Full range that starts from the min value for a key to the max value.
ShardKey	getHigh()
ShardKeyType	getKeyType()
ShardKey	getLow()
int	hashCode() Calculates the hash code for this instance.
ShardRange	intersect(ShardRange range) Returns the intersection of two ranges.
boolean	intersects(ShardRange range) Checks whether the range intersects with the current range.
boolean	opEquality(ShardRange left, ShardRange right) Equality operator.
boolean	opGreaterThan(ShardRange left, ShardRange right) Compares two ShardRange using lexicographic order (greater than).
boolean	opGreaterThanOrEqual(ShardRange left, ShardRange right) Compares two ShardRange using lexicographic order (greater or equal).
boolean	opInequality(ShardRange left, ShardRange right) Inequality operator.
boolean	opLessThan(ShardRange left, ShardRange right) Compares two ShardRange using lexicographic order (less than).
boolean	opLessThanOrEqual(ShardRange left, ShardRange right) Compares two ShardRange using lexicographic order (less or equal).
String	toString() Converts the object to its string representation.

Field Details

NULL

public static final ShardRange NULL= new ShardRange()

Constructor Details

ShardRange

public ShardRange()

ShardRange

public ShardRange(ShardKey low, ShardKey high)

Constructs a shard range from low boundary (inclusive) to high high boundary (exclusive).

Parameters:

low - low boundary (inclusive)

high - high boundary (exclusive)

Method Details

compareTo

public int compareTo(ShardRange other)

Performs comparison between two shard range values.

Parameters:

other - The shard range compared with this object.

Returns:

-1 : if this range's low boundary is less than the other 's low boundary; -1 : if the low boundary values match and the high boundary value of this range is less than the other 's. 1 : if this range's high boundary is greater than the other 's high boundary; 1 : if the low boundary value of this range is higher than other 's low boundary and high boundary value of this range is less than or equal to other 's high boundary . 0 : if this range has the same boundaries as other .

contains

public boolean contains(ShardKey key)

Checks whether the specified key is inside the range.

Parameters:

key - The key to check

Returns:

True if inside, false otherwise

contains

public boolean contains(ShardRange range)

Checks whether the range is inside the range.

Parameters:

range - The range to check.

Returns:

True if inside, false otherwise.

equals

public boolean equals(Object obj)

Determines whether the specified object is equal to the current object.

Parameters:

obj - The object to compare with the current object.

Returns:

True if the specified object is equal to the current object; otherwise, false.

equals

public boolean equals(ShardRange other)

Performs equality comparison with another given ShardRange.

Parameters:

other - ShardRange to compare with.

Returns:

True if same shard range, false otherwise.

getFullRange

public static ShardRange getFullRange(ShardKeyType keyType)

Gets a shard range corresponding to a specified key type.

Parameters:

keyType - Type of key.

Returns:

Full range for given key type.