Page History

...

• The methods are composable. The fromfromTime and asOftoTime methods specify the time range while the withLowerKeyBound and withUpperKeyBound methods specify the key bounds. 

  • If a user applies the same time limit multiple times such as MultiVersionedRangeQuery.withLowerKeyBound(k1).from(t1).from(t2), then the last one wins (it will be translated to MultiVersionedRangeQuery.withLowerKeyBound(k1).from(t2)).

  • Defining a query with time range (empty, t1] will be translated into [0, t1]
  • Defining a query with time range (t1, empty) will be translated into [t1, MAX)
  • A query with no specified time range will be translated into [0, MAX). It means that the query will return all the versions of all the records with specified key range.
• As explained in the javadocs, the query returns all valid records within the specified time range.
  • The fromTime specifies the starting point. There can be records which have been inserted before the fromTime and are valid in the time range. 
  • The toTime specifies the ending point. Records that have been inserted at toTime are returned by the query as well.
• The overall order of the returned records is by Key. The method orderByTimestamp() can make the overall order by timestamp.
  • The order for both key and timestamp is by default ascending. They can be changed by the methods withDescendingKeys() and withDescendingTimestamps() respectively.

...