com.cinchapi.concourse

Class ForwardingConcourse

Object

Concourse

ForwardingConcourse

All Implemented Interfaces:

AutoCloseable

public abstract class ForwardingConcourse
extends Concourse

An extensible Concourse wrapper that simply forwards method calls to another Concourse instance.

This class is meant to be extended by a subclass that needs to override a subset of methods to provide additional functionality before or after the Concourse method execution. For example, an extension of this class can be used to cache the return value of some Concourse methods and check that cache before performing a database call.

Nested Class Summary

Nested classes/interfaces inherited from class Concourse

Concourse.ConnectionBuilder

Constructor Summary

Constructors

Constructor and Description
ForwardingConcourse(Concourse concourse) Construct a new instance.

Method Summary

Modifier and Type	Method and Description
protected abstract ForwardingConcourse	$this(Concourse concourse) Construct an instance of this ForwardingConcourse using the provided concourse connection as the proxied handle.
void	abort() Abort the current transaction and discard any changes that are currently staged.
<T> long	add(String key, T value) Append key as value in a new record.
<T> Map<Long,Boolean>	add(String key, T value, Collection<Long> records) Atomically append key as value in each of the records where it doesn't exist.
<T> boolean	add(String key, T value, long record) Append key as value in record if and only if it doesn't exist.
Map<String,Map<Object,Set<Long>>>	browse(Collection<String> keys) Return a view of the values from all records that are currently stored for each of the keys.
Map<String,Map<Object,Set<Long>>>	browse(Collection<String> keys, Timestamp timestamp) Return a view of the values from all records that were stored for each of the keys at timestamp.
Map<Object,Set<Long>>	browse(String key) Return a view of the values from all records that are currently stored for key.
Map<Object,Set<Long>>	browse(String key, Timestamp timestamp) Return a view of the values from all records that were stored for key at timestamp.
<T> Map<Timestamp,Set<T>>	chronologize(String key, long record) Return a time series that contains a snapshot of the values stored for key in record after every change made to the field.
<T> Map<Timestamp,Set<T>>	chronologize(String key, long record, Timestamp start) Return a time series between start (inclusive) and the present that contains a snapshot of the values stored for key in record after every change made to the field during the time span.
<T> Map<Timestamp,Set<T>>	chronologize(String key, long record, Timestamp start, Timestamp end) Return a time series between start (inclusive) and end (non-inclusive) that contains a snapshot of the values stored for key in record after every change made to the field during the time span.
void	clear(Collection<Long> records) Atomically remove all the values stored for every key in each of the records.
void	clear(Collection<String> keys, Collection<Long> records) Atomically remove all the values stored for each of the keys in each of the records.
void	clear(Collection<String> keys, long record) Atomically remove all the values stored for each of the keys in record.
void	clear(long record) Atomically remove all the values stored for every key in record.
void	clear(String key, Collection<Long> records) Atomically remove all the values stored for key in each of the records.
void	clear(String key, long record) Atomically remove all the values stored for key in record
boolean	commit() Attempt to permanently commit any changes that are staged in a transaction and return true if and only if all the changes can be applied.
boolean	consolidate(long first, long second, long... remaining) 1) Atomically merge data from the second and remaining records into the first, 2) clear each of the second and remaining records and 3) replace any outgoing links to them with links to the first record.
protected Concourse	copyConnection() Return a new Concourse connection that is connected to the same deployment with the same credentials as this connection.
Set<String>	describe() Return all of the keys in the database.
Map<Long,Set<String>>	describe(Collection<Long> records) For each of the records, return all of the keys that have at least one value.
Map<Long,Set<String>>	describe(Collection<Long> records, Timestamp timestamp) For each of the records, return all the keys that had at least one value at timestamp.
Set<String>	describe(long record) Return all the keys in record that have at least one value.
Set<String>	describe(long record, Timestamp timestamp) Return all the keys in record that had at least one value at timestamp.
Set<String>	describe(Timestamp timestamp) Return all of the keys in the database at timestamp.
<T> Map<String,Map<Diff,Set<T>>>	diff(long record, Timestamp start) Return the net changes made to record since start.
<T> Map<String,Map<Diff,Set<T>>>	diff(long record, Timestamp start, Timestamp end) Return the net changes made to record from start to end.
<T> Map<Diff,Set<T>>	diff(String key, long record, Timestamp start) List the net changes made to key in record since start.
<T> Map<Diff,Set<T>>	diff(String key, long record, Timestamp start, Timestamp end) Return the net changes made to key in record from start to end.
<T> Map<T,Map<Diff,Set<Long>>>	diff(String key, Timestamp start) Return the net changes made to the key field across all records since start.
<T> Map<T,Map<Diff,Set<Long>>>	diff(String key, Timestamp start, Timestamp end) Return the net changes made to the key field across all records from start to end.
void	exit() Terminate the client's session and close this connection.
Set<Long>	find(Criteria criteria) Return the set of records that satisfy the criteria.
Set<Long>	find(Criteria criteria, Order order) Return the set of records that satisfy the criteria.
Set<Long>	find(Criteria criteria, Order order, Page page) Return the set of records that satisfy the criteria.
Set<Long>	find(Criteria criteria, Page page) Return the set of records that satisfy the criteria.
Set<Long>	find(String ccl) Return the set of records that satisfy the ccl filter.
Set<Long>	find(String key, Object value) Return the set of records where key equals value.
Set<Long>	find(String key, Object value, Order order) Return the set of records where key equals value.
Set<Long>	find(String key, Object value, Order order, Page page) Return the set of records where key equals value.
Set<Long>	find(String key, Object value, Page page) Return the set of records where key equals value.
Set<Long>	find(String key, Object value, Timestamp timestamp) Return the set of records where key was equal to value at timestamp.
Set<Long>	find(String key, Object value, Timestamp timestamp, Order order) Return the set of records where key was equal to value at timestamp.
Set<Long>	find(String key, Object value, Timestamp timestamp, Order order, Page page) Return the set of records where key was equal to value at timestamp.
Set<Long>	find(String key, Object value, Timestamp timestamp, Page page) Return the set of records where key was equal to value at timestamp.
Set<Long>	find(String key, Operator operator, Object value) Return the set of records where the key field contains at least one value that satisfies the operator in relation to the value.
Set<Long>	find(String key, Operator operator, Object value, Object value2) Return the set of records where the key field contains at least one value that satisfies the operator in relation to value and value2.
Set<Long>	find(String key, Operator operator, Object value, Object value2, Order order) Return the set of records where the key field contains at least one value that satisfies the operator in relation to value and value2.
Set<Long>	find(String key, Operator operator, Object value, Object value2, Order order, Page page) Return the set of records where the key field contains at least one value that satisfies the operator in relation to value and value2.
Set<Long>	find(String key, Operator operator, Object value, Object value2, Page page) Return the set of records where the key field contains at least one value that satisfies the operator in relation to value and value2.
Set<Long>	find(String key, Operator operator, Object value, Object value2, Timestamp timestamp) Return the set of records where the key field contained at least one value at timestamp that satisfies the operator in relation to value and value2.
Set<Long>	find(String key, Operator operator, Object value, Object value2, Timestamp timestamp, Order order) Return the set of records where the key field contained at least one value at timestamp that satisfies the operator in relation to value and value2.
Set<Long>	find(String key, Operator operator, Object value, Object value2, Timestamp timestamp, Order order, Page page) Return the set of records where the key field contained at least one value at timestamp that satisfies the operator in relation to value and value2.
Set<Long>	find(String key, Operator operator, Object value, Object value2, Timestamp timestamp, Page page) Return the set of records where the key field contained at least one value at timestamp that satisfies the operator in relation to value and value2.
Set<Long>	find(String key, Operator operator, Object value, Order order) Return the set of records where the key field contains at least one value that satisfies the operator in relation to the value.
Set<Long>	find(String key, Operator operator, Object value, Order order, Page page) Return the set of records where the key field contains at least one value that satisfies the operator in relation to the value.
Set<Long>	find(String key, Operator operator, Object value, Page page) Return the set of records where the key field contains at least one value that satisfies the operator in relation to the value.
Set<Long>	find(String key, Operator operator, Object value, Timestamp timestamp) Return the set of records where the key field contained at least one value at that satisfies the operator in relation to the value.
Set<Long>	find(String key, Operator operator, Object value, Timestamp timestamp, Order order) Return the set of records where the key field contained at least one value at that satisfies the operator in relation to the value.
Set<Long>	find(String key, Operator operator, Object value, Timestamp timestamp, Order order, Page page) Return the set of records where the key field contained at least one value at that satisfies the operator in relation to the value.
Set<Long>	find(String key, Operator operator, Object value, Timestamp timestamp, Page page) Return the set of records where the key field contained at least one value at that satisfies the operator in relation to the value.
Set<Long>	find(String ccl, Order order) Return the set of records that satisfy the ccl filter.
Set<Long>	find(String ccl, Order order, Page page) Return the set of records that satisfy the ccl filter.
Set<Long>	find(String ccl, Page page) Return the set of records that satisfy the ccl filter.
Set<Long>	find(String key, String operator, Object value) Return the set of records where the key field contains at least one value that satisfies the operator in relation to the value.
Set<Long>	find(String key, String operator, Object value, Object value2) Return the set of records where the key field contains at least one value that satisfies the operator in relation to value and value2.
Set<Long>	find(String key, String operator, Object value, Object value2, Order order) Return the set of records where the key field contains at least one value that satisfies the operator in relation to value and value2.
Set<Long>	find(String key, String operator, Object value, Object value2, Order order, Page page) Return the set of records where the key field contains at least one value that satisfies the operator in relation to value and value2.
Set<Long>	find(String key, String operator, Object value, Object value2, Page page) Return the set of records where the key field contains at least one value that satisfies the operator in relation to value and value2.
Set<Long>	find(String key, String operator, Object value, Object value2, Timestamp timestamp) Return the set of records where the key field contained at least one value at timestamp that satisfies the operator in relation to value and value2.
Set<Long>	find(String key, String operator, Object value, Object value2, Timestamp timestamp, Order order) Return the set of records where the key field contained at least one value at timestamp that satisfies the operator in relation to value and value2.
Set<Long>	find(String key, String operator, Object value, Object value2, Timestamp timestamp, Order order, Page page) Return the set of records where the key field contained at least one value at timestamp that satisfies the operator in relation to value and value2.
Set<Long>	find(String key, String operator, Object value, Object value2, Timestamp timestamp, Page page) Return the set of records where the key field contained at least one value at timestamp that satisfies the operator in relation to value and value2.
Set<Long>	find(String key, String operator, Object value, Order order) Return the set of records where the key field contains at least one value that satisfies the operator in relation to the value.
Set<Long>	find(String key, String operator, Object value, Order order, Page page) Return the set of records where the key field contains at least one value that satisfies the operator in relation to the value.
Set<Long>	find(String key, String operator, Object value, Page page) Return the set of records where the key field contains at least one value that satisfies the operator in relation to the value.
Set<Long>	find(String key, String operator, Object value, Timestamp timestamp) Return the set of records where the key field contained at least one value at timestamp that satisfies the operator in relation to the value.
Set<Long>	find(String key, String operator, Object value, Timestamp timestamp, Order order) Return the set of records where the key field contained at least one value at timestamp that satisfies the operator in relation to the value.
Set<Long>	find(String key, String operator, Object value, Timestamp timestamp, Order order, Page page) Return the set of records where the key field contained at least one value at timestamp that satisfies the operator in relation to the value.
Set<Long>	find(String key, String operator, Object value, Timestamp timestamp, Page page) Return the set of records where the key field contained at least one value at timestamp that satisfies the operator in relation to the value.
<T> long	findOrAdd(String key, T value) Return the unique record where key equals value, or throw a DuplicateEntryException if multiple records match the condition.
long	findOrInsert(Criteria criteria, String json) Return the unique record that matches the criteria, if one exist or throw a DuplicateEntryException if multiple records match.
long	findOrInsert(String ccl, String json) Return the unique record that matches the ccl filter, if one exist or throw a DuplicateEntryException if multiple records match.
<T> Map<Long,Map<String,T>>	get(Collection<String> keys, Collection<Long> records) For each of the keys in each of the records, return the stored value that was most recently added.
<T> Map<Long,Map<String,T>>	get(Collection<String> keys, Collection<Long> records, Order order) For each of the keys in each of the records, return the stored value that was most recently added.
<T> Map<Long,Map<String,T>>	get(Collection<String> keys, Collection<Long> records, Order order, Page page) For each of the keys in each of the records, return the stored value that was most recently added.
<T> Map<Long,Map<String,T>>	get(Collection<String> keys, Collection<Long> records, Page page) For each of the keys in each of the records, return the stored value that was most recently added.
<T> Map<Long,Map<String,T>>	get(Collection<String> keys, Collection<Long> records, Timestamp timestamp) For each of the keys in each of the records, return the stored value that was most recently added at timestamp.
<T> Map<Long,Map<String,T>>	get(Collection<String> keys, Collection<Long> records, Timestamp timestamp, Order order) For each of the keys in each of the records, return the stored value that was most recently added at timestamp.
<T> Map<Long,Map<String,T>>	get(Collection<String> keys, Collection<Long> records, Timestamp timestamp, Order order, Page page) For each of the keys in each of the records, return the stored value that was most recently added at timestamp.
<T> Map<Long,Map<String,T>>	get(Collection<String> keys, Collection<Long> records, Timestamp timestamp, Page page) For each of the keys in each of the records, return the stored value that was most recently added at timestamp.
<T> Map<Long,Map<String,T>>	get(Collection<String> keys, Criteria criteria) For each of the keys in every record that matches the criteria, return the stored value that was most recently added.
<T> Map<Long,Map<String,T>>	get(Collection<String> keys, Criteria criteria, Order order) For each of the keys in every record that matches the criteria, return the stored value that was most recently added.
<T> Map<Long,Map<String,T>>	get(Collection<String> keys, Criteria criteria, Order order, Page page) For each of the keys in every record that matches the criteria, return the stored value that was most recently added.
<T> Map<Long,Map<String,T>>	get(Collection<String> keys, Criteria criteria, Page page) For each of the keys in every record that matches the criteria, return the stored value that was most recently added.
<T> Map<Long,Map<String,T>>	get(Collection<String> keys, Criteria criteria, Timestamp timestamp) For each of the keys in every record that matches the criteria, return the stored value that was most recently added at timestamp.
<T> Map<Long,Map<String,T>>	get(Collection<String> keys, Criteria criteria, Timestamp timestamp, Order order) For each of the keys in every record that matches the criteria, return the stored value that was most recently added at timestamp.
<T> Map<Long,Map<String,T>>	get(Collection<String> keys, Criteria criteria, Timestamp timestamp, Order order, Page page) For each of the keys in every record that matches the criteria, return the stored value that was most recently added at timestamp.
<T> Map<Long,Map<String,T>>	get(Collection<String> keys, Criteria criteria, Timestamp timestamp, Page page) For each of the keys in every record that matches the criteria, return the stored value that was most recently added at timestamp.
<T> Map<String,T>	get(Collection<String> keys, long record) For each of the keys in record, return the stored value that was most recently added.
<T> Map<String,T>	get(Collection<String> keys, long record, Timestamp timestamp) For each of the keys in record, return the stored value that was most recently added at timestamp.
<T> Map<Long,Map<String,T>>	get(Collection<String> keys, String ccl) For each of the keys in every record that matches the ccl filter, return the stored value that was most recently added.
<T> Map<Long,Map<String,T>>	get(Collection<String> keys, String ccl, Order order) For each of the keys in every record that matches the ccl filter, return the stored value that was most recently added.
<T> Map<Long,Map<String,T>>	get(Collection<String> keys, String ccl, Order order, Page page) For each of the keys in every record that matches the ccl filter, return the stored value that was most recently added.
<T> Map<Long,Map<String,T>>	get(Collection<String> keys, String ccl, Page page) For each of the keys in every record that matches the ccl filter, return the stored value that was most recently added.
<T> Map<Long,Map<String,T>>	get(Collection<String> keys, String ccl, Timestamp timestamp) For each of the keys in every record that matches the ccl filter, return the stored value that was most recently added at timestamp.
<T> Map<Long,Map<String,T>>	get(Collection<String> keys, String ccl, Timestamp timestamp, Order order) For each of the keys in every record that matches the ccl filter, return the stored value that was most recently added at timestamp.
<T> Map<Long,Map<String,T>>	get(Collection<String> keys, String ccl, Timestamp timestamp, Order order, Page page) For each of the keys in every record that matches the ccl filter, return the stored value that was most recently added at timestamp.
<T> Map<Long,Map<String,T>>	get(Collection<String> keys, String ccl, Timestamp timestamp, Page page) For each of the keys in every record that matches the ccl filter, return the stored value that was most recently added at timestamp.
<T> Map<Long,Map<String,T>>	get(Criteria criteria) For every key in every record that matches the criteria, return the stored value that was most recently added.
<T> Map<Long,Map<String,T>>	get(Criteria criteria, Order order) For every key in every record that matches the criteria, return the stored value that was most recently added.
<T> Map<Long,Map<String,T>>	get(Criteria criteria, Order order, Page page) For every key in every record that matches the criteria, return the stored value that was most recently added.
<T> Map<Long,Map<String,T>>	get(Criteria criteria, Page page) For every key in every record that matches the criteria, return the stored value that was most recently added.
<T> Map<Long,Map<String,T>>	get(Criteria criteria, Timestamp timestamp) For every key in every record that matches the criteria, return the stored value that was most recently added at timestamp .
<T> Map<Long,Map<String,T>>	get(Criteria criteria, Timestamp timestamp, Order order) For every key in every record that matches the criteria, return the stored value that was most recently added at timestamp .
<T> Map<Long,Map<String,T>>	get(Criteria criteria, Timestamp timestamp, Order order, Page page) For every key in every record that matches the criteria, return the stored value that was most recently added at timestamp .
<T> Map<Long,Map<String,T>>	get(Criteria criteria, Timestamp timestamp, Page page) For every key in every record that matches the criteria, return the stored value that was most recently added at timestamp .
<T> Map<Long,Map<String,T>>	get(String ccl) For every key in every record that matches the ccl filter, return the stored value that was most recently added.
<T> Map<Long,T>	get(String key, Collection<Long> records) For each of the records, return the stored value in the key field that was most recently added.
<T> Map<Long,T>	get(String key, Collection<Long> records, Order order) For each of the records, return the stored value in the key field that was most recently added.
<T> Map<Long,T>	get(String key, Collection<Long> records, Order order, Page page) For each of the records, return the stored value in the key field that was most recently added.
<T> Map<Long,T>	get(String key, Collection<Long> records, Page page) For each of the records, return the stored value in the key field that was most recently added.
<T> Map<Long,T>	get(String key, Collection<Long> records, Timestamp timestamp) For each of the records, return the stored value in the key field that was most recently added at timestamp
<T> Map<Long,T>	get(String key, Collection<Long> records, Timestamp timestamp, Order order) For each of the records, return the stored value in the key field that was most recently added at timestamp
<T> Map<Long,T>	get(String key, Collection<Long> records, Timestamp timestamp, Order order, Page page) For each of the records, return the stored value in the key field that was most recently added at timestamp
<T> Map<Long,T>	get(String key, Collection<Long> records, Timestamp timestamp, Page page) For each of the records, return the stored value in the key field that was most recently added at timestamp
<T> Map<Long,T>	get(String key, Criteria criteria) For every record that matches the criteria, return the stored value in the key field that was most recently added.
<T> Map<Long,T>	get(String key, Criteria criteria, Order order) For every record that matches the criteria, return the stored value in the key field that was most recently added.
<T> Map<Long,T>	get(String key, Criteria criteria, Order order, Page page) For every record that matches the criteria, return the stored value in the key field that was most recently added.
<T> Map<Long,T>	get(String key, Criteria criteria, Page page) For every record that matches the criteria, return the stored value in the key field that was most recently added.
<T> Map<Long,T>	get(String key, Criteria criteria, Timestamp timestamp) For every record that matches the criteria, return the stored value in the key field that was most recently added at timestamp.
<T> Map<Long,T>	get(String key, Criteria criteria, Timestamp timestamp, Order order) For every record that matches the criteria, return the stored value in the key field that was most recently added at timestamp.
<T> Map<Long,T>	get(String key, Criteria criteria, Timestamp timestamp, Order order, Page page) For every record that matches the criteria, return the stored value in the key field that was most recently added at timestamp.
<T> Map<Long,T>	get(String key, Criteria criteria, Timestamp timestamp, Page page) For every record that matches the criteria, return the stored value in the key field that was most recently added at timestamp.
<T> T	get(String key, long record) Return the stored value that was most recently added for key in record.
<T> T	get(String key, long record, Timestamp timestamp) Return the stored value that was most recently added for key in record at timestamp.
<T> Map<Long,Map<String,T>>	get(String ccl, Order order) For every key in every record that matches the ccl filter, return the stored value that was most recently added.
<T> Map<Long,Map<String,T>>	get(String ccl, Order order, Page page) For every key in every record that matches the ccl filter, return the stored value that was most recently added.
<T> Map<Long,Map<String,T>>	get(String ccl, Page page) For every key in every record that matches the ccl filter, return the stored value that was most recently added.
<T> Map<Long,T>	get(String key, String ccl) For every record that matches the ccl filter, return the stored value in the key field that was most recently added.
<T> Map<Long,T>	get(String key, String ccl, Order order) For every record that matches the ccl filter, return the stored value in the key field that was most recently added.
<T> Map<Long,T>	get(String key, String ccl, Order order, Page page) For every record that matches the ccl filter, return the stored value in the key field that was most recently added.
<T> Map<Long,T>	get(String key, String ccl, Page page) For every record that matches the ccl filter, return the stored value in the key field that was most recently added.
<T> Map<Long,T>	get(String key, String ccl, Timestamp timestamp) For every record that matches the ccl filter, return the stored value in the key field that was most recently added at timestamp.
<T> Map<Long,T>	get(String key, String ccl, Timestamp timestamp, Order order) For every record that matches the ccl filter, return the stored value in the key field that was most recently added at timestamp.
<T> Map<Long,T>	get(String key, String ccl, Timestamp timestamp, Order order, Page page) For every record that matches the ccl filter, return the stored value in the key field that was most recently added at timestamp.
<T> Map<Long,T>	get(String key, String ccl, Timestamp timestamp, Page page) For every record that matches the ccl filter, return the stored value in the key field that was most recently added at timestamp.
<T> Map<Long,Map<String,T>>	get(String ccl, Timestamp timestamp) For every key in every record that matches the ccl filter, return the stored value that was most recently added.
<T> Map<Long,Map<String,T>>	get(String ccl, Timestamp timestamp, Order order) For every key in every record that matches the ccl filter, return the stored value that was most recently added.
<T> Map<Long,Map<String,T>>	get(String ccl, Timestamp timestamp, Order order, Page page) For every key in every record that matches the ccl filter, return the stored value that was most recently added.
<T> Map<Long,Map<String,T>>	get(String ccl, Timestamp timestamp, Page page) For every key in every record that matches the ccl filter, return the stored value that was most recently added.
String	getServerEnvironment() Return the name of the connected environment.
String	getServerVersion() Return the version of the connected server.
Set<Long>	insert(String json) Atomically insert the key/value associations from the json string into as many new records as necessary.
Map<Long,Boolean>	insert(String json, Collection<Long> records) Atomically insert the key/value associations from the json object into each of the records, if possible.
boolean	insert(String json, long record) Atomically insert the key/value associations from the json object into record, if possible.
Set<Long>	inventory() Return all the records that have current or historical data.
<T> T	invokePlugin(String id, String method, Object... args) Invoke method using args within the plugin identified by id.
String	jsonify(Collection<Long> records) Atomically dump the data in each of the records as a JSON array of objects.
String	jsonify(Collection<Long> records, boolean identifier) Atomically dump the data in each of the records as a JSON array of objects and optionally include a special identifier key that contains the record id for each of the dumped objects.
String	jsonify(Collection<Long> records, Timestamp timestamp) Atomically dump the data in each of the records at timestamp as a JSON array of objects.
String	jsonify(Collection<Long> records, Timestamp timestamp, boolean identifier) Atomically dump the data in each of the records at timestamp as a JSON array of objects and optionally include a special identifier key that contains the record id for each of the dumped objects.
String	jsonify(long record) Atomically dump all the data in record as a JSON object.
String	jsonify(long record, boolean identifier) Atomically dump all the data in record as a JSON object and optionally include a special identifier key that contains the record id.
String	jsonify(long record, Timestamp timestamp) Atomically dump all the data in record at timestamp as a JSON object.
String	jsonify(long record, Timestamp timestamp, boolean identifier) Atomically dump all the data in record at timestamp as a JSON object and optionally include a special identifier key that contains the record id.
Map<Long,Boolean>	link(String key, Collection<Long> destinations, long source) Append links from key in source to each of the destinations.
boolean	link(String key, long destination, long source) Append a link from key in source to destination.
<T> Map<Long,Map<String,Set<T>>>	navigate(Collection<String> keys, Collection<Long> records) Traverse the document-graph along each of the navigation keys, starting at each of the records and return the data contained at each of the destinations.
<T> Map<Long,Map<String,Set<T>>>	navigate(Collection<String> keys, Collection<Long> records, Timestamp timestamp) Traverse the document-graph at timestamp along each of the navigation keys, starting at each of the records and return the data contained at each of the destinations at timestamp.
<T> Map<Long,Map<String,Set<T>>>	navigate(Collection<String> keys, Criteria criteria) Traverse the document-graph along each of the navigation keys, starting at each of the records that match the criteria and return the data contained at each of the destinations.
<T> Map<Long,Map<String,Set<T>>>	navigate(Collection<String> keys, Criteria criteria, Timestamp timestamp) Traverse the document-graph at timestamp along each of the navigation keys, starting at each of the records that matched the criteria and return the data contained at each of the destinations at timestamp.
<T> Map<Long,Map<String,Set<T>>>	navigate(Collection<String> keys, long record) Traverse the document-graph along each of the navigation keys, starting at record and return the data contained at each of the destinations.
<T> Map<Long,Map<String,Set<T>>>	navigate(Collection<String> keys, long record, Timestamp timestamp) Traverse the document-graph at timestamp along each of the navigation keys, starting at record and return the data contained at each of the destinations at timestamp.
<T> Map<Long,Map<String,Set<T>>>	navigate(Collection<String> keys, String ccl) Traverse the document-graph along each of the navigation keys, starting at each of the records that match the criteria and return the data contained at each of the destinations.
<T> Map<Long,Map<String,Set<T>>>	navigate(Collection<String> keys, String ccl, Timestamp timestamp) Traverse the document-graph at timestamp along each of the navigation keys, starting at each of the records that matched the criteria and return the data contained at each of the destinations at timestamp.
<T> Map<Long,Set<T>>	navigate(String key, Collection<Long> records) Return all values stored for key in each of the records.
<T> Map<Long,Set<T>>	navigate(String key, Collection<Long> records, Timestamp timestamp) Return all values stored for key in each of the records at timestamp.Navigates through the key splited with dot(.) operator.
<T> Map<Long,Set<T>>	navigate(String key, Criteria criteria) Return all the values stored for key in every record that matches the Criteria filter.
<T> Map<Long,Set<T>>	navigate(String key, Criteria criteria, Timestamp timestamp) Return all the values stored for key in every record that matches the Criteria filter.
<T> Map<Long,Set<T>>	navigate(String key, long record) Return all the values stored for key in record.Iterates through the key splitted with dot(.) operator.
<T> Map<Long,Set<T>>	navigate(String key, long record, Timestamp timestamp) Return all the values stored for key in record at timestamp.
<T> Map<Long,Set<T>>	navigate(String key, String ccl) Return all the values stored for key in every record that matches the ccl filter.
<T> Map<Long,Set<T>>	navigate(String key, String ccl, Timestamp timestamp) Return all the values stored for key in every record that matches the ccl filter.
boolean	ping() Test the connection to the server.
Map<Long,Boolean>	ping(Collection<Long> records) Atomically check to see if each of the records currently contains any data.
boolean	ping(long record) Check to see if record currently contains any data.
<T> void	reconcile(String key, long record, Collection<T> values) Make the necessary changes to the data stored for key in record so that it contains the exact same values as the specified collection.
<T> Map<Long,Boolean>	remove(String key, T value, Collection<Long> records) Atomically remove key as value from each of the records where it currently exists.
<T> boolean	remove(String key, T value, long record) Remove key as value from record if it currently exists.
void	revert(Collection<String> keys, Collection<Long> records, Timestamp timestamp) Atomically revert each of the keys in each of the records to their state at timestamp by creating new revisions that undo the net changes that have occurred since timestamp.
void	revert(Collection<String> keys, long record, Timestamp timestamp) Atomically revert each of the keys in record to their state at timestamp by creating new revisions that undo the net changes that have occurred since timestamp.
void	revert(String key, Collection<Long> records, Timestamp timestamp) Atomically revert key in each of the records to its state at timestamp by creating new revisions that undo the net changes that have occurred since timestamp.
void	revert(String key, long record, Timestamp timestamp) Atomically revert key in record to its state at timestamp by creating new revisions that undo the net changes that have occurred since timestamp.
Map<Timestamp,List<String>>	review(long record) Return a list all the changes ever made to record.
Map<Timestamp,List<String>>	review(long record, Timestamp start) Return a list all the changes made to record since start (inclusive).
Map<Timestamp,List<String>>	review(long record, Timestamp start, Timestamp end) Return a list all the changes made to record between start (inclusive) and end (non-inclusive).
Map<Timestamp,List<String>>	review(String key, long record) Return a list all the changes ever made to the key field in record
Map<Timestamp,List<String>>	review(String key, long record, Timestamp start) Return a list of all the changes made to the key field in record since start (inclusive).
Map<Timestamp,List<String>>	review(String key, long record, Timestamp start, Timestamp end) Return a list of all the changes made to the key field in record between start (inclusive) and end (non-inclusive).
Set<Long>	search(String key, String query) Perform a full text search for query against the key field and return the records that contain a String or Tag value that matches.
<T> Map<Long,Map<String,Set<T>>>	select(Collection<Long> records) Return all the data that is currently stored in each of the records.
<T> Map<Long,Map<String,Set<T>>>	select(Collection<Long> records, Order order) Return all the data that is currently stored in each of the records.
<T> Map<Long,Map<String,Set<T>>>	select(Collection<Long> records, Order order, Page page) Return all the data that is currently stored in each of the records.
<T> Map<Long,Map<String,Set<T>>>	select(Collection<Long> records, Page page) Return all the data that is currently stored in each of the records.
<T> Map<Long,Map<String,Set<T>>>	select(Collection<Long> records, Timestamp timestamp) Return all the data that was stored in each of the records at timestamp.
<T> Map<Long,Map<String,Set<T>>>	select(Collection<Long> records, Timestamp timestamp, Order order) Return all the data that was stored in each of the records at timestamp.
<T> Map<Long,Map<String,Set<T>>>	select(Collection<Long> records, Timestamp timestamp, Order order, Page page) Return all the data that was stored in each of the records at timestamp.
<T> Map<Long,Map<String,Set<T>>>	select(Collection<Long> records, Timestamp timestamp, Page page) Return all the data that was stored in each of the records at timestamp.
<T> Map<Long,Map<String,Set<T>>>	select(Collection<String> keys, Collection<Long> records) Return all the values stored for each of the keys in each of the records.
<T> Map<Long,Map<String,Set<T>>>	select(Collection<String> keys, Collection<Long> records, Order order) Return all the values stored for each of the keys in each of the records.
<T> Map<Long,Map<String,Set<T>>>	select(Collection<String> keys, Collection<Long> records, Order order, Page page) Return all the values stored for each of the keys in each of the records.
<T> Map<Long,Map<String,Set<T>>>	select(Collection<String> keys, Collection<Long> records, Page page) Return all the values stored for each of the keys in each of the records.
<T> Map<Long,Map<String,Set<T>>>	select(Collection<String> keys, Collection<Long> records, Timestamp timestamp) Return all the values stored for each of the keys in each of the records at timestamp.
<T> Map<Long,Map<String,Set<T>>>	select(Collection<String> keys, Collection<Long> records, Timestamp timestamp, Order order) Return all the values stored for each of the keys in each of the records at timestamp.
<T> Map<Long,Map<String,Set<T>>>	select(Collection<String> keys, Collection<Long> records, Timestamp timestamp, Order order, Page page) Return all the values stored for each of the keys in each of the records at timestamp.
<T> Map<Long,Map<String,Set<T>>>	select(Collection<String> keys, Collection<Long> records, Timestamp timestamp, Page page) Return all the values stored for each of the keys in each of the records at timestamp.
<T> Map<Long,Map<String,Set<T>>>	select(Collection<String> keys, Criteria criteria) Return all the values stored for each of the keys in every record that matches the criteria.
<T> Map<Long,Map<String,Set<T>>>	select(Collection<String> keys, Criteria criteria, Order order) Return all the values stored for each of the keys in every record that matches the criteria.
<T> Map<Long,Map<String,Set<T>>>	select(Collection<String> keys, Criteria criteria, Order order, Page page) Return all the values stored for each of the keys in every record that matches the criteria.
<T> Map<Long,Map<String,Set<T>>>	select(Collection<String> keys, Criteria criteria, Page page) Return all the values stored for each of the keys in every record that matches the criteria.
<T> Map<Long,Map<String,Set<T>>>	select(Collection<String> keys, Criteria criteria, Timestamp timestamp) Return all the values stored for each of the keys at timestamp in every record that matches the criteria
<T> Map<Long,Map<String,Set<T>>>	select(Collection<String> keys, Criteria criteria, Timestamp timestamp, Order order) Return all the values stored for each of the keys at timestamp in every record that matches the criteria
<T> Map<Long,Map<String,Set<T>>>	select(Collection<String> keys, Criteria criteria, Timestamp timestamp, Order order, Page page) Return all the values stored for each of the keys at timestamp in every record that matches the criteria
<T> Map<Long,Map<String,Set<T>>>	select(Collection<String> keys, Criteria criteria, Timestamp timestamp, Page page) Return all the values stored for each of the keys at timestamp in every record that matches the criteria
<T> Map<String,Set<T>>	select(Collection<String> keys, long record) Return all the values stored for each of the keys in record.
<T> Map<String,Set<T>>	select(Collection<String> keys, long record, Timestamp timestamp) Return all the values stored for each of the keys in record at timestamp.
<T> Map<Long,Map<String,Set<T>>>	select(Collection<String> keys, String ccl) Return all the values stored for each of the keys in every record that matches the ccl filter.
<T> Map<Long,Map<String,Set<T>>>	select(Collection<String> keys, String ccl, Order order) Return all the values stored for each of the keys in every record that matches the ccl filter.
<T> Map<Long,Map<String,Set<T>>>	select(Collection<String> keys, String ccl, Order order, Page page) Return all the values stored for each of the keys in every record that matches the ccl filter.
<T> Map<Long,Map<String,Set<T>>>	select(Collection<String> keys, String ccl, Page page) Return all the values stored for each of the keys in every record that matches the ccl filter.
<T> Map<Long,Map<String,Set<T>>>	select(Collection<String> keys, String ccl, Timestamp timestamp) Return all the values stored for each of the keys at timestamp in every record that matches the ccl filter.
<T> Map<Long,Map<String,Set<T>>>	select(Collection<String> keys, String ccl, Timestamp timestamp, Order order) Return all the values stored for each of the keys at timestamp in every record that matches the ccl filter.
<T> Map<Long,Map<String,Set<T>>>	select(Collection<String> keys, String ccl, Timestamp timestamp, Order order, Page page) Return all the data from every record that matches criteria.
<T> Map<Long,Map<String,Set<T>>>	select(Collection<String> keys, String ccl, Timestamp timestamp, Page page) Return all the data from every record that matches criteria.
<T> Map<Long,Map<String,Set<T>>>	select(Criteria criteria) Return all the data from every record that matches criteria.
<T> Map<Long,Map<String,Set<T>>>	select(Criteria criteria, Order order) Return all the data from every record that matches criteria.
<T> Map<Long,Map<String,Set<T>>>	select(Criteria criteria, Order order, Page page) Return all the data from every record that matches criteria.
<T> Map<Long,Map<String,Set<T>>>	select(Criteria criteria, Page page) Return all the data from every record that matches criteria.
<T> Map<Long,Map<String,Set<T>>>	select(Criteria criteria, Timestamp timestamp) Return all the data at timestamp from every record that matches the criteria.
<T> Map<Long,Map<String,Set<T>>>	select(Criteria criteria, Timestamp timestamp, Order order) Return all the data at timestamp from every record that matches the criteria.
<T> Map<Long,Map<String,Set<T>>>	select(Criteria criteria, Timestamp timestamp, Order order, Page page) Return all the data at timestamp from every record that matches the criteria.
<T> Map<Long,Map<String,Set<T>>>	select(Criteria criteria, Timestamp timestamp, Page page) Return all the data at timestamp from every record that matches the criteria.
<T> Map<String,Set<T>>	select(long record) Return all the data from record.
<T> Map<String,Set<T>>	select(long record, Timestamp timestamp) Return all the data from record at timestamp.
<T> Map<Long,Map<String,Set<T>>>	select(String ccl) Return all the data from every record that matches ccl filter.
<T> Map<Long,Set<T>>	select(String key, Collection<Long> records) Return all values stored for key in each of the records.
<T> Map<Long,Set<T>>	select(String key, Collection<Long> records, Order order) Return all values stored for key in each of the records.
<T> Map<Long,Set<T>>	select(String key, Collection<Long> records, Order order, Page page) Return all values stored for key in each of the records.
<T> Map<Long,Set<T>>	select(String key, Collection<Long> records, Page page) Return all values stored for key in each of the records.
<T> Map<Long,Set<T>>	select(String key, Collection<Long> records, Timestamp timestamp) Return all values stored for key in each of the records at timestamp.
<T> Map<Long,Set<T>>	select(String key, Collection<Long> records, Timestamp timestamp, Order order) Return all values stored for key in each of the records at timestamp.
<T> Map<Long,Set<T>>	select(String key, Collection<Long> records, Timestamp timestamp, Order order, Page page) Return all values stored for key in each of the records at timestamp.
<T> Map<Long,Set<T>>	select(String key, Collection<Long> records, Timestamp timestamp, Page page) Return all values stored for key in each of the records at timestamp.
<T> Map<Long,Set<T>>	select(String key, Criteria criteria) Return all the values stored for key in every record that matches the criteria.
<T> Map<Long,Set<T>>	select(String key, Criteria criteria, Order order) Return all the values stored for key in every record that matches the criteria.
<T> Map<Long,Set<T>>	select(String key, Criteria criteria, Order order, Page page) Return all the values stored for key in every record that matches the criteria.
<T> Map<Long,Set<T>>	select(String key, Criteria criteria, Page page) Return all the values stored for key in every record that matches the criteria.
<T> Map<Long,Set<T>>	select(String key, Criteria criteria, Timestamp timestamp) Return all the values stored for key at timestamp in every record that matches the criteria.
<T> Map<Long,Set<T>>	select(String key, Criteria criteria, Timestamp timestamp, Order order) Return all the values stored for key at timestamp in every record that matches the criteria.
<T> Map<Long,Set<T>>	select(String key, Criteria criteria, Timestamp timestamp, Order order, Page page) Return all the values stored for key at timestamp in every record that matches the criteria.
<T> Map<Long,Set<T>>	select(String key, Criteria criteria, Timestamp timestamp, Page page) Return all the values stored for key at timestamp in every record that matches the criteria.
<T> Set<T>	select(String key, long record) Return all the values stored for key in record.
<T> Set<T>	select(String key, long record, Timestamp timestamp) Return all the values stored for key in record at timestamp.
<T> Map<Long,Map<String,Set<T>>>	select(String ccl, Order order) Return all the data from every record that matches ccl filter.
<T> Map<Long,Map<String,Set<T>>>	select(String ccl, Order order, Page page) Return all the data from every record that matches ccl filter.
<T> Map<Long,Map<String,Set<T>>>	select(String ccl, Page page) Return all the data from every record that matches ccl filter.
<T> Map<Long,Set<T>>	select(String key, String ccl) Return all the values stored for key in every record that matches the ccl filter.
<T> Map<Long,Set<T>>	select(String key, String ccl, Order order) Return all the values stored for key in every record that matches the ccl filter.
<T> Map<Long,Set<T>>	select(String key, String ccl, Order order, Page page) Return all the values stored for key in every record that matches the ccl filter.
<T> Map<Long,Set<T>>	select(String key, String ccl, Page page) Return all the values stored for key in every record that matches the ccl filter.
<T> Map<Long,Set<T>>	select(String key, String ccl, Timestamp timestamp) Return all the values stored for key at timestamp in every record that matches the ccl filter.
<T> Map<Long,Set<T>>	select(String key, String ccl, Timestamp timestamp, Order order) Return all the values stored for key at timestamp in every record that matches the ccl filter.
<T> Map<Long,Set<T>>	select(String key, String ccl, Timestamp timestamp, Order order, Page page) Return all the values stored for key at timestamp in every record that matches the ccl filter.
<T> Map<Long,Set<T>>	select(String key, String ccl, Timestamp timestamp, Page page) Return all the values stored for key at timestamp in every record that matches the ccl filter.
<T> Map<Long,Map<String,Set<T>>>	select(String ccl, Timestamp timestamp) Return all the data at timestamp from every record that matches the ccl filter.
<T> Map<Long,Map<String,Set<T>>>	select(String ccl, Timestamp timestamp, Order order) Return all the data at timestamp from every record that matches the ccl filter.
<T> Map<Long,Map<String,Set<T>>>	select(String ccl, Timestamp timestamp, Order order, Page page) Return all the data at timestamp from every record that matches the ccl filter.
<T> Map<Long,Map<String,Set<T>>>	select(String ccl, Timestamp timestamp, Page page) Return all the data at timestamp from every record that matches the ccl filter.
void	set(String key, Object value, Collection<Long> records) In each of the records, atomically remove all the values stored for key and then add key as value in the respective record.
<T> void	set(String key, T value, long record) Atomically remove all the values stored for key in record and add then key as value.
void	stage() Start a new transaction.
Timestamp	time() Return a Timestamp that represents the current instant according to the server.
Timestamp	time(String phrase) Return the Timestamp, according to the server, that corresponds to the instant described by the phrase.
Map<Long,Map<String,Set<Long>>>	trace(Collection<Long> records) Locate and return all the incoming links to each of the records.
Map<Long,Map<String,Set<Long>>>	trace(Collection<Long> records, Timestamp timestamp) Locate and return all the incoming links to each of the records.
Map<String,Set<Long>>	trace(long record) Locate and return all the incoming links to record.
Map<String,Set<Long>>	trace(long record, Timestamp timestamp) Locate and return all the incoming links to record at timestamp.
boolean	unlink(String key, long destination, long source) If it exists, remove the link from key in source to destination.
boolean	verify(String key, Object value, long record) Return true if value is stored for key in record.
boolean	verify(String key, Object value, long record, Timestamp timestamp) Return true if value was stored for key in record at timestamp.
boolean	verifyAndSwap(String key, Object expected, long record, Object replacement) Atomically replace expected with replacement for key in record if and only if expected is currently stored in the field.
void	verifyOrSet(String key, Object value, long record) Atomically verify that key equals expected in record or set it as such.

Methods inherited from class Concourse

at, audit, audit, audit, audit, audit, audit, calculate, calculate, close, connect, connect, connect, connect, connect, connect, connectWithPrefs, connectWithPrefs, consolidate, copyExistingConnection, find, find, find, find, find, find, find, find, find, find, find, find, findOrInsert, findOrInsert, findOrInsert, findOrInsert, findOrInsert, findOrInsert, findOrInsert, get, get, get, get, get, get, get, get, get, get, get, get, get, get, get, get, get, get, insert, insert, insert, insert, insert, insert, insert, manage, navigate, navigate, reconcile, select, select, select, select, select, select, select, select, select, select, select, select, select, select, select, select, select, select, select, select, select, select, stage, time, time, trace, trace

Methods inherited from class Object

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

Constructor Detail

ForwardingConcourse

public ForwardingConcourse(Concourse concourse)

Construct a new instance.

Parameters:

concourse -

Method Detail

abort

public void abort()

Description copied from class: Concourse

Abort the current transaction and discard any changes that are currently staged.

After returning, the driver will return to autocommit mode and all subsequent changes will be committed immediately.

Calling this method when the driver is not in staging mode is a no-op.

Specified by:

abort in class Concourse

add

public <T> long add(String key,
                    T value)

Description copied from class: Concourse

Append key as value in a new record.

Specified by:

add in class Concourse

Parameters:

key - the field name

value - the value to add

Returns:

the new record id

add

public <T> Map<Long,Boolean> add(String key,
                                 T value,
                                 Collection<Long> records)

Description copied from class: Concourse

Atomically append key as value in each of the records where it doesn't exist.

Specified by:

add in class Concourse

Parameters:

key - the field name

value - the value to add

records - a collection of record ids where an attempt is made to add the data

Returns:

a Map associating each record id to a boolean that indicates if the data was added

add

public <T> boolean add(String key,
                       T value,
                       long record)

Description copied from class: Concourse

Append key as value in record if and only if it doesn't exist.

Specified by:

add in class Concourse

Parameters:

key - the field name

value - the value to add

record - the record id where an attempt is made to add the data

Returns:

a boolean that indicates if the data was added

browse

public Map<String,Map<Object,Set<Long>>> browse(Collection<String> keys)

Description copied from class: Concourse

Return a view of the values from all records that are currently stored for each of the keys.

Specified by:

browse in class Concourse

Parameters:

keys - a collection of field names

Returns:

a Map associating each of the keys to a another Map associating each indexed value to the Set of records that contain that value in the key field

browse

public Map<String,Map<Object,Set<Long>>> browse(Collection<String> keys,
                                                Timestamp timestamp)

Description copied from class: Concourse

Return a view of the values from all records that were stored for each of the keys at timestamp.

Specified by:

browse in class Concourse

Parameters:

keys - a collection of field names

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a Map associating each of the keys to a another Map associating each indexed value to the Set of records that contained that value in the key field at timestamp

browse

public Map<Object,Set<Long>> browse(String key)

Description copied from class: Concourse

Return a view of the values from all records that are currently stored for key.

Specified by:

browse in class Concourse

Parameters:

key - the field name

Returns:

a Map associating each indexed value to the Set of records that contain that value in the key field

browse

public Map<Object,Set<Long>> browse(String key,
                                    Timestamp timestamp)

Description copied from class: Concourse

Return a view of the values from all records that were stored for key at timestamp.

Specified by:

browse in class Concourse

Parameters:

key - the field name

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a Map associating each indexed value to the Set of records that contained that value in the key field at timestamp

chronologize

public <T> Map<Timestamp,Set<T>> chronologize(String key,
                                              long record)

Description copied from class: Concourse

Return a time series that contains a snapshot of the values stored for key in record after every change made to the field.

Specified by:

chronologize in class Concourse

Parameters:

key - the field name

record - the record id

Returns:

a Map associating the Timestamp of each change to the Set of values that were stored in the field after that change

chronologize

public <T> Map<Timestamp,Set<T>> chronologize(String key,
                                              long record,
                                              Timestamp start)

Description copied from class: Concourse

Return a time series between start (inclusive) and the present that contains a snapshot of the values stored for key in record after every change made to the field during the time span.

Specified by:

chronologize in class Concourse

Parameters:

key - the field name

record - the record id

start - the first possible Timestamp to include in the time series – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a Map associating the Timestamp of each change to the Set of values that were stored in the field after that change

chronologize

public <T> Map<Timestamp,Set<T>> chronologize(String key,
                                              long record,
                                              Timestamp start,
                                              Timestamp end)

Description copied from class: Concourse

Return a time series between start (inclusive) and end (non-inclusive) that contains a snapshot of the values stored for key in record after every change made to the field during the time span.

Specified by:

chronologize in class Concourse

Parameters:

key - the field name

record - the record id

start - the first possible Timestamp to include in the time series – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

end - the Timestamp that should be greater than every timestamp in the time series – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a Map associating the Timestamp of each change to the Set of values that were stored in the field after that change

clear

public void clear(Collection<Long> records)

Description copied from class: Concourse

Atomically remove all the values stored for every key in each of the records.

Specified by:

clear in class Concourse

Parameters:

records - a collection of record ids

clear

public void clear(Collection<String> keys,
                  Collection<Long> records)

Description copied from class: Concourse

Atomically remove all the values stored for each of the keys in each of the records.

Specified by:

clear in class Concourse

Parameters:

keys - a collection of field names

records - a collection of record ids.

clear

public void clear(Collection<String> keys,
                  long record)

Description copied from class: Concourse

Atomically remove all the values stored for each of the keys in record.

Specified by:

clear in class Concourse

Parameters:

keys - a collection of field names

record - the record id

clear

public void clear(long record)

Description copied from class: Concourse

Atomically remove all the values stored for every key in record.

Specified by:

clear in class Concourse

Parameters:

record - the record id

clear

public void clear(String key,
                  Collection<Long> records)

Description copied from class: Concourse

Atomically remove all the values stored for key in each of the records.

Specified by:

clear in class Concourse

Parameters:

key - the field name

records - a collection of record ids

clear

public void clear(String key,
                  long record)

Description copied from class: Concourse

Atomically remove all the values stored for key in record

Specified by:

clear in class Concourse

Parameters:

key - the field name

record - the record id

commit

public boolean commit()

Description copied from class: Concourse

Attempt to permanently commit any changes that are staged in a transaction and return true if and only if all the changes can be applied. Otherwise, returns false and all the changes are discarded.

After returning, the driver will return to autocommit mode and all subsequent changes will be committed immediately.

This method will return false if it is called when the driver is not in staging mode.

Specified by:

commit in class Concourse

Returns:

true if all staged changes are committed, otherwise false

consolidate

public boolean consolidate(long first,
                           long second,
                           long... remaining)

Description copied from class: Concourse

1) Atomically merge data from the second and remaining records into the first, 2) clear each of the second and remaining records and 3) replace any outgoing links to them with links to the first record.

This method effectively combines the data across the first, second and remaining records within the first one in an additive manner and replaces all references to the second and remaining records with a reference to the first across the document-graph.

NOTE: This method consolidates the present state of the records. Each of the input record's history is unaffected.

Specified by:

consolidate in class Concourse

Returns:

a boolean that indicates whether the operation is successful; this method will generally succeed if there are no relevant intermittent state changes, but may fail if consolidating the data would result in integrity constraints being violated (e.g. a circular link being created because the first record links to one of the second or remaining records)

describe

public Set<String> describe()

Description copied from class: Concourse

Return all of the keys in the database.

Specified by:

describe in class Concourse

Returns:

a Set of keys in the database

describe

public Map<Long,Set<String>> describe(Collection<Long> records)

Description copied from class: Concourse

For each of the records, return all of the keys that have at least one value.

Specified by:

describe in class Concourse

Parameters:

records - a collection of record ids

Returns:

a Map associating each of the records to the Set of keys in that record

describe

public Map<Long,Set<String>> describe(Collection<Long> records,
                                      Timestamp timestamp)

Description copied from class: Concourse

For each of the records, return all the keys that had at least one value at timestamp.

Specified by:

describe in class Concourse

Parameters:

records - a collection of record ids

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a Map associating each of the records to the Set of keys that were in that record at timestamp

describe

public Set<String> describe(long record)

Description copied from class: Concourse

Return all the keys in record that have at least one value.

Specified by:

describe in class Concourse

Parameters:

record - the record id

Returns:

the Set of keys in record

describe

public Set<String> describe(long record,
                            Timestamp timestamp)

Description copied from class: Concourse

Return all the keys in record that had at least one value at timestamp.

Specified by:

describe in class Concourse

Parameters:

record - the record id

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

the Set of keys that were in record at timestamp

describe

public Set<String> describe(Timestamp timestamp)

Description copied from class: Concourse

Return all of the keys in the database at timestamp.

Specified by:

describe in class Concourse

Returns:

a Set of keys in the database at timestamp

diff

public <T> Map<String,Map<Diff,Set<T>>> diff(long record,
                                             Timestamp start)

Description copied from class: Concourse

Return the net changes made to record since start.

If you begin with the state of the record at start and re-apply all the changes in the diff, you'll re-create the state of the record at the present.

Unlike the audit method, diff does not necessarily reflect ALL the changes made to record during the time span.

Specified by:

diff in class Concourse

Parameters:

record - the record id

start - the base timestamp from which the diff is calculated

Returns:

a Map associating each key in the record to another Map associating a change description to the Set of values that fit the description (i.e. {"key": {ADDED: ["value1", "value2"], REMOVED: ["value3", "value4"]}} )

diff

public <T> Map<String,Map<Diff,Set<T>>> diff(long record,
                                             Timestamp start,
                                             Timestamp end)

Description copied from class: Concourse

Return the net changes made to record from start to end.

If you begin with the state of the record at start and re-apply all the changes in the diff, you'll re-create the state of the same record at end.

Unlike the audit method, diff does not necessarily reflect ALL the changes made to record during the time span.

Specified by:

diff in class Concourse

Parameters:

record - the record id

start - the base timestamp from which the diff is calculated

end - the comparison timestamp to which the diff is calculated

Returns:

a Map associating each key in the record to another Map associating a change description to the Set of values that fit the description (i.e. {"key": {ADDED: ["value1", "value2"], REMOVED: ["value3", "value4"]}} )

diff

public <T> Map<Diff,Set<T>> diff(String key,
                                 long record,
                                 Timestamp start)

Description copied from class: Concourse

List the net changes made to key in record since start.

If you begin with the state of the field at start and re-apply all the changes in the diff, you'll re-create the state of the same field at the present.

Specified by:

diff in class Concourse

Parameters:

key - the field name

record - the record id

start - the base timestamp from which the diff is calculated

Returns:

a Map associating a change description to the Set of values that fit the description (i.e. {ADDED: ["value1", "value2"], REMOVED: ["value3", "value4"]} )

diff

public <T> Map<Diff,Set<T>> diff(String key,
                                 long record,
                                 Timestamp start,
                                 Timestamp end)

Description copied from class: Concourse

Return the net changes made to key in record from start to end.

If you begin with the state of the field at start and re-apply all the changes in the diff, you'll re-create the state of the same field at end.

Specified by:

diff in class Concourse

Parameters:

key - the field name

record - the record id

start - the base timestamp from which the diff is calculated

end - the comparison timestamp to which the diff is calculated

Returns:

a Map associating a change description to the Set of values that fit the description (i.e. {ADDED: ["value1", "value2"], REMOVED: ["value3", "value4"]} )

diff

public <T> Map<T,Map<Diff,Set<Long>>> diff(String key,
                                           Timestamp start)

Description copied from class: Concourse

Return the net changes made to the key field across all records since start.

If you begin with the state of the inverted index for key at start and re-apply all the changes in the diff, you'll re-create the state of the same index at the present.

Unlike the audit method, diff does not necessarily reflect ALL the changes made to key in record during the time span.

Specified by:

diff in class Concourse

Parameters:

key - the field name

start - the base timestamp from which the diff is calculated

Returns:

a Map associating each value stored for key across all records to another Map that associates a change description to the Set of records where the description applies to that value in the key field (i.e. {"value1": {ADDED: [1, 2], REMOVED: [3, 4]}} )

diff

public <T> Map<T,Map<Diff,Set<Long>>> diff(String key,
                                           Timestamp start,
                                           Timestamp end)

Description copied from class: Concourse

Return the net changes made to the key field across all records from start to end.

If you begin with the state of the inverted index for key at start and re-apply all the changes in the diff, you'll re-create the state of the same index at end.

Unlike the audit method, diff does not necessarily return ALL the changes made to key in record during the time span.

Specified by:

diff in class Concourse

Parameters:

key - the field name

start - the base timestamp from which the diff is calculated

end - the comparison timestamp to which the diff is calculated

Returns:

a Map associating each value stored for key across all records to another Map that associates a change description to the Set of records where the description applies to that value in the key field (i.e. {"value1": {ADDED: [1, 2], REMOVED: [3, 4]}} )

exit

public void exit()

Description copied from class: Concourse

Terminate the client's session and close this connection.

Specified by:

exit in class Concourse

find

public Set<Long> find(Criteria criteria)

Description copied from class: Concourse

Return the set of records that satisfy the criteria.

Specified by:

find in class Concourse

Parameters:

criteria - a Criteria that contains a well-formed filter for the desired records

Returns:

the records that match the criteria

find

public Set<Long> find(Criteria criteria,
                      Order order)

Description copied from class: Concourse

Return the set of records that satisfy the criteria.

Specified by:

find in class Concourse

Parameters:

criteria - a Criteria that contains a well-formed filter for the desired records

order - an Order specification that describes how the result set should be sorted

Returns:

the records that match the criteria

find

public Set<Long> find(Criteria criteria,
                      Order order,
                      Page page)

Description copied from class: Concourse

Return the set of records that satisfy the criteria.

Specified by:

find in class Concourse

Parameters:

criteria - a Criteria that contains a well-formed filter for the desired records

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

the records that match the criteria

find

public Set<Long> find(Criteria criteria,
                      Page page)

Description copied from class: Concourse

Return the set of records that satisfy the criteria.

Specified by:

find in class Concourse

Parameters:

criteria - a Criteria that contains a well-formed filter for the desired records

page - a {@link Page) specification that describes the page of the result set to return

Returns:

the records that match the criteria

find

public Set<Long> find(String ccl)

Description copied from class: Concourse

Return the set of records that satisfy the ccl filter.

Specified by:

find in class Concourse

Parameters:

ccl - a well-formed criteria expressed using the Concourse Criteria Language

Returns:

the records that match the criteria

find

public Set<Long> find(String key,
                      Object value)

Description copied from class: Concourse

Return the set of records where key equals value.

This method is a shortcut for calling Concourse.find(String, Operator, Object) with Operator.EQUALS.

Specified by:

find in class Concourse

Parameters:

key - the field name

value - the value that must exist in the key field for the record to match

Returns:

the records where key = value

find

public Set<Long> find(String key,
                      Object value,
                      Order order)

Description copied from class: Concourse

Return the set of records where key equals value.

This method is a shortcut for calling Concourse.find(String, Operator, Object) with Operator.EQUALS.

Specified by:

find in class Concourse

Parameters:

key - the field name

value - the value that must exist in the key field for the record to match

order - an Order specification that describes how the result set should be sorted

Returns:

the records where key = value

find

public Set<Long> find(String key,
                      Object value,
                      Order order,
                      Page page)

Description copied from class: Concourse

Return the set of records where key equals value.

This method is a shortcut for calling Concourse.find(String, Operator, Object) with Operator.EQUALS.

Specified by:

find in class Concourse

Parameters:

key - the field name

value - the value that must exist in the key field for the record to match

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

the records where key = value

find

public Set<Long> find(String key,
                      Object value,
                      Page page)

Description copied from class: Concourse

Return the set of records where key equals value.

This method is a shortcut for calling Concourse.find(String, Operator, Object) with Operator.EQUALS.

Specified by:

find in class Concourse

Parameters:

key - the field name

value - the value that must exist in the key field for the record to match

page - a {@link Page) specification that describes the page of the result set to return

Returns:

the records where key = value

find

public Set<Long> find(String key,
                      Object value,
                      Timestamp timestamp)

Description copied from class: Concourse

Return the set of records where key was equal to value at timestamp.

This method is a shortcut for calling Concourse.find(String, Operator, Object, Timestamp) with Operator.EQUALS.

Specified by:

find in class Concourse

Parameters:

key - the field name

value - the value that must exist in the key field for the record to match

timestamp - a Timestamp that represents the historical instant to use when checking for matches – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

the records where key was equal to value at timestamp

find

public Set<Long> find(String key,
                      Object value,
                      Timestamp timestamp,
                      Order order)

Description copied from class: Concourse

Return the set of records where key was equal to value at timestamp.

This method is a shortcut for calling Concourse.find(String, Operator, Object, Timestamp) with Operator.EQUALS.

Specified by:

find in class Concourse

Parameters:

key - the field name

value - the value that must exist in the key field for the record to match

timestamp - a Timestamp that represents the historical instant to use when checking for matches – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

Returns:

the records where key was equal to value at timestamp

find

public Set<Long> find(String key,
                      Object value,
                      Timestamp timestamp,
                      Order order,
                      Page page)

Description copied from class: Concourse

Return the set of records where key was equal to value at timestamp.

This method is a shortcut for calling Concourse.find(String, Operator, Object, Timestamp) with Operator.EQUALS.

Specified by:

find in class Concourse

Parameters:

key - the field name

value - the value that must exist in the key field for the record to match

timestamp - a Timestamp that represents the historical instant to use when checking for matches – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

the records where key was equal to value at timestamp

find

public Set<Long> find(String key,
                      Object value,
                      Timestamp timestamp,
                      Page page)

Description copied from class: Concourse

Return the set of records where key was equal to value at timestamp.

This method is a shortcut for calling Concourse.find(String, Operator, Object, Timestamp) with Operator.EQUALS.

Specified by:

find in class Concourse

Parameters:

key - the field name

value - the value that must exist in the key field for the record to match

timestamp - a Timestamp that represents the historical instant to use when checking for matches – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

page - a {@link Page) specification that describes the page of the result set to return

Returns:

the records where key was equal to value at timestamp

find

public Set<Long> find(String key,
                      Operator operator,
                      Object value)

Description copied from class: Concourse

Return the set of records where the key field contains at least one value that satisfies the operator in relation to the value.

Specified by:

find in class Concourse

Parameters:

key - the field name

operator - the Operator to use when comparing the specified value to those stored across the key field while determining which records are matches

value - the comparison value for the operator

Returns:

the records that match the criteria

find

public Set<Long> find(String key,
                      Operator operator,
                      Object value,
                      Object value2)

Description copied from class: Concourse

Return the set of records where the key field contains at least one value that satisfies the operator in relation to value and value2.

Specified by:

find in class Concourse

Parameters:

key - the field name

operator - the Operator to use when comparing the specified values to those stored across the key field while determining which records are matches

value - the first comparison value for the operator

value2 - the second comparison value for the operator

Returns:

the records that match the criteria

find

public Set<Long> find(String key,
                      Operator operator,
                      Object value,
                      Object value2,
                      Order order)

Description copied from class: Concourse

Return the set of records where the key field contains at least one value that satisfies the operator in relation to value and value2.

Specified by:

find in class Concourse

Parameters:

key - the field name

operator - the Operator to use when comparing the specified values to those stored across the key field while determining which records are matches

value - the first comparison value for the operator

value2 - the second comparison value for the operator

order - an Order specification that describes how the result set should be sorted

Returns:

the records that match the criteria

find

public Set<Long> find(String key,
                      Operator operator,
                      Object value,
                      Object value2,
                      Order order,
                      Page page)

Description copied from class: Concourse

Return the set of records where the key field contains at least one value that satisfies the operator in relation to value and value2.

Specified by:

find in class Concourse

Parameters:

key - the field name

operator - the Operator to use when comparing the specified values to those stored across the key field while determining which records are matches

value - the first comparison value for the operator

value2 - the second comparison value for the operator

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

the records that match the criteria

find

public Set<Long> find(String key,
                      Operator operator,
                      Object value,
                      Object value2,
                      Page page)

Description copied from class: Concourse

Return the set of records where the key field contains at least one value that satisfies the operator in relation to value and value2.

Specified by:

find in class Concourse

Parameters:

key - the field name

operator - the Operator to use when comparing the specified values to those stored across the key field while determining which records are matches

value - the first comparison value for the operator

value2 - the second comparison value for the operator

page - a {@link Page) specification that describes the page of the result set to return

Returns:

the records that match the criteria

find

public Set<Long> find(String key,
                      Operator operator,
                      Object value,
                      Object value2,
                      Timestamp timestamp)

Description copied from class: Concourse

Return the set of records where the key field contained at least one value at timestamp that satisfies the operator in relation to value and value2.

Specified by:

find in class Concourse

Parameters:

key - the field name

operator - the Operator to use when comparing the specified values to those stored across the key field while determining which records are matches

value - the first comparison value for the operator

value2 - the second comparison value for the operator

timestamp - a Timestamp that represents the historical instant to use when checking for matches – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

the records that match the criteria

find

public Set<Long> find(String key,
                      Operator operator,
                      Object value,
                      Object value2,
                      Timestamp timestamp,
                      Order order)

Description copied from class: Concourse

Return the set of records where the key field contained at least one value at timestamp that satisfies the operator in relation to value and value2.

Specified by:

find in class Concourse

Parameters:

key - the field name

operator - the Operator to use when comparing the specified values to those stored across the key field while determining which records are matches

value - the first comparison value for the operator

value2 - the second comparison value for the operator

timestamp - a Timestamp that represents the historical instant to use when checking for matches – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

Returns:

the records that match the criteria

find

public Set<Long> find(String key,
                      Operator operator,
                      Object value,
                      Object value2,
                      Timestamp timestamp,
                      Order order,
                      Page page)

Description copied from class: Concourse

Return the set of records where the key field contained at least one value at timestamp that satisfies the operator in relation to value and value2.

Specified by:

find in class Concourse

Parameters:

key - the field name

operator - the Operator to use when comparing the specified values to those stored across the key field while determining which records are matches

value - the first comparison value for the operator

value2 - the second comparison value for the operator

timestamp - a Timestamp that represents the historical instant to use when checking for matches – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

the records that match the criteria

find

public Set<Long> find(String key,
                      Operator operator,
                      Object value,
                      Object value2,
                      Timestamp timestamp,
                      Page page)

Description copied from class: Concourse

Return the set of records where the key field contained at least one value at timestamp that satisfies the operator in relation to value and value2.

Specified by:

find in class Concourse

Parameters:

key - the field name

operator - the Operator to use when comparing the specified values to those stored across the key field while determining which records are matches

value - the first comparison value for the operator

value2 - the second comparison value for the operator

timestamp - a Timestamp that represents the historical instant to use when checking for matches – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

page - a {@link Page) specification that describes the page of the result set to return

Returns:

the records that match the criteria

find

public Set<Long> find(String key,
                      Operator operator,
                      Object value,
                      Order order)

Description copied from class: Concourse

Return the set of records where the key field contains at least one value that satisfies the operator in relation to the value.

Specified by:

find in class Concourse

Parameters:

key - the field name

operator - the Operator to use when comparing the specified value to those stored across the key field while determining which records are matches

value - the comparison value for the operator

order - an Order specification that describes how the result set should be sorted

Returns:

the records that match the criteria

find

public Set<Long> find(String key,
                      Operator operator,
                      Object value,
                      Order order,
                      Page page)

Description copied from class: Concourse

Return the set of records where the key field contains at least one value that satisfies the operator in relation to the value.

Specified by:

find in class Concourse

Parameters:

key - the field name

operator - the Operator to use when comparing the specified value to those stored across the key field while determining which records are matches

value - the comparison value for the operator

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

the records that match the criteria

find

public Set<Long> find(String key,
                      Operator operator,
                      Object value,
                      Page page)

Description copied from class: Concourse

Return the set of records where the key field contains at least one value that satisfies the operator in relation to the value.

Specified by:

find in class Concourse

Parameters:

key - the field name

operator - the Operator to use when comparing the specified value to those stored across the key field while determining which records are matches

value - the comparison value for the operator

page - a {@link Page) specification that describes the page of the result set to return

Returns:

the records that match the criteria

find

public Set<Long> find(String key,
                      Operator operator,
                      Object value,
                      Timestamp timestamp)

Description copied from class: Concourse

Return the set of records where the key field contained at least one value at that satisfies the operator in relation to the value.

Specified by:

find in class Concourse

Parameters:

key - the field name

operator - the Operator to use when comparing the specified value to those stored across the key field while determining which records are matches

value - the comparison value for the operator

timestamp - a Timestamp that represents the historical instant to use when checking for matches – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

the records that match the criteria

find

public Set<Long> find(String key,
                      Operator operator,
                      Object value,
                      Timestamp timestamp,
                      Order order)

Description copied from class: Concourse

Return the set of records where the key field contained at least one value at that satisfies the operator in relation to the value.

Specified by:

find in class Concourse

Parameters:

key - the field name

operator - the Operator to use when comparing the specified value to those stored across the key field while determining which records are matches

value - the comparison value for the operator

timestamp - a Timestamp that represents the historical instant to use when checking for matches – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

Returns:

the records that match the criteria

find

public Set<Long> find(String key,
                      Operator operator,
                      Object value,
                      Timestamp timestamp,
                      Order order,
                      Page page)

Description copied from class: Concourse

Return the set of records where the key field contained at least one value at that satisfies the operator in relation to the value.

Specified by:

find in class Concourse

Parameters:

key - the field name

operator - the Operator to use when comparing the specified value to those stored across the key field while determining which records are matches

value - the comparison value for the operator

timestamp - a Timestamp that represents the historical instant to use when checking for matches – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

the records that match the criteria

find

public Set<Long> find(String key,
                      Operator operator,
                      Object value,
                      Timestamp timestamp,
                      Page page)

Description copied from class: Concourse

Return the set of records where the key field contained at least one value at that satisfies the operator in relation to the value.

Specified by:

find in class Concourse

Parameters:

key - the field name

operator - the Operator to use when comparing the specified value to those stored across the key field while determining which records are matches

value - the comparison value for the operator

timestamp - a Timestamp that represents the historical instant to use when checking for matches – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

page - a {@link Page) specification that describes the page of the result set to return

Returns:

the records that match the criteria

find

public Set<Long> find(String ccl,
                      Order order)

Description copied from class: Concourse

Return the set of records that satisfy the ccl filter.

Specified by:

find in class Concourse

Parameters:

ccl - a well-formed criteria expressed using the Concourse Criteria Language

order - an Order specification that describes how the result set should be sorted

Returns:

the records that match the criteria

find

public Set<Long> find(String ccl,
                      Order order,
                      Page page)

Description copied from class: Concourse

Return the set of records that satisfy the ccl filter.

Specified by:

find in class Concourse

Parameters:

ccl - a well-formed criteria expressed using the Concourse Criteria Language

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

the records that match the criteria

find

public Set<Long> find(String ccl,
                      Page page)

Description copied from class: Concourse

Return the set of records that satisfy the ccl filter.

Specified by:

find in class Concourse

Parameters:

ccl - a well-formed criteria expressed using the Concourse Criteria Language

page - a {@link Page) specification that describes the page of the result set to return

Returns:

the records that match the criteria

find

public Set<Long> find(String key,
                      String operator,
                      Object value)

Description copied from class: Concourse

Return the set of records where the key field contains at least one value that satisfies the operator in relation to the value.

Specified by:

find in class Concourse

Parameters:

key - the field name

operator - a valid description of an Operator to use when comparing the specified value to those stored across the key field while determining which records are matches

value - the comparison value for the operator

Returns:

the records that match the criteria

find

public Set<Long> find(String key,
                      String operator,
                      Object value,
                      Object value2)

Description copied from class: Concourse

Return the set of records where the key field contains at least one value that satisfies the operator in relation to value and value2.

Specified by:

find in class Concourse

Parameters:

key - the field name

operator - a valid description of an Operator to use when comparing the specified value to those stored across the key field while determining which records are matches

value - the first comparison value for the operator

value2 - the second comparison value for the operator

Returns:

the records that match the criteria

find

public Set<Long> find(String key,
                      String operator,
                      Object value,
                      Object value2,
                      Order order)

Description copied from class: Concourse

Return the set of records where the key field contains at least one value that satisfies the operator in relation to value and value2.

Specified by:

find in class Concourse

Parameters:

key - the field name

operator - a valid description of an Operator to use when comparing the specified value to those stored across the key field while determining which records are matches

value - the first comparison value for the operator

value2 - the second comparison value for the operator

order - an Order specification that describes how the result set should be sorted

Returns:

the records that match the criteria

find

public Set<Long> find(String key,
                      String operator,
                      Object value,
                      Object value2,
                      Order order,
                      Page page)

Description copied from class: Concourse

Return the set of records where the key field contains at least one value that satisfies the operator in relation to value and value2.

Specified by:

find in class Concourse

Parameters:

key - the field name

operator - a valid description of an Operator to use when comparing the specified value to those stored across the key field while determining which records are matches

value - the first comparison value for the operator

value2 - the second comparison value for the operator

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

the records that match the criteria

find

public Set<Long> find(String key,
                      String operator,
                      Object value,
                      Object value2,
                      Page page)

Description copied from class: Concourse

Return the set of records where the key field contains at least one value that satisfies the operator in relation to value and value2.

Specified by:

find in class Concourse

Parameters:

key - the field name

operator - a valid description of an Operator to use when comparing the specified value to those stored across the key field while determining which records are matches

value - the first comparison value for the operator

value2 - the second comparison value for the operator

page - a {@link Page) specification that describes the page of the result set to return

Returns:

the records that match the criteria

find

public Set<Long> find(String key,
                      String operator,
                      Object value,
                      Object value2,
                      Timestamp timestamp)

Description copied from class: Concourse

Return the set of records where the key field contained at least one value at timestamp that satisfies the operator in relation to value and value2.

Specified by:

find in class Concourse

Parameters:

key - the field name

operator - a valid description of an Operator to use when comparing the specified value to those stored across the key field while determining which records are matches

value - the first comparison value for the operator

value2 - the second comparison value for the operator

timestamp - a Timestamp that represents the historical instant to use when checking for matches – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

the records that match the criteria

find

public Set<Long> find(String key,
                      String operator,
                      Object value,
                      Object value2,
                      Timestamp timestamp,
                      Order order)

Description copied from class: Concourse

Return the set of records where the key field contained at least one value at timestamp that satisfies the operator in relation to value and value2.

Specified by:

find in class Concourse

Parameters:

key - the field name

operator - a valid description of an Operator to use when comparing the specified value to those stored across the key field while determining which records are matches

value - the first comparison value for the operator

value2 - the second comparison value for the operator

timestamp - a Timestamp that represents the historical instant to use when checking for matches – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

Returns:

the records that match the criteria

find

public Set<Long> find(String key,
                      String operator,
                      Object value,
                      Object value2,
                      Timestamp timestamp,
                      Order order,
                      Page page)

Description copied from class: Concourse

Return the set of records where the key field contained at least one value at timestamp that satisfies the operator in relation to value and value2.

Specified by:

find in class Concourse

Parameters:

key - the field name

operator - a valid description of an Operator to use when comparing the specified value to those stored across the key field while determining which records are matches

value - the first comparison value for the operator

value2 - the second comparison value for the operator

timestamp - a Timestamp that represents the historical instant to use when checking for matches – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

the records that match the criteria

find

public Set<Long> find(String key,
                      String operator,
                      Object value,
                      Object value2,
                      Timestamp timestamp,
                      Page page)

Description copied from class: Concourse

Return the set of records where the key field contained at least one value at timestamp that satisfies the operator in relation to value and value2.

Specified by:

find in class Concourse

Parameters:

key - the field name

operator - a valid description of an Operator to use when comparing the specified value to those stored across the key field while determining which records are matches

value - the first comparison value for the operator

value2 - the second comparison value for the operator

timestamp - a Timestamp that represents the historical instant to use when checking for matches – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

page - a {@link Page) specification that describes the page of the result set to return

Returns:

the records that match the criteria

find

public Set<Long> find(String key,
                      String operator,
                      Object value,
                      Order order)

Description copied from class: Concourse

Return the set of records where the key field contains at least one value that satisfies the operator in relation to the value.

Specified by:

find in class Concourse

Parameters:

key - the field name

operator - a valid description of an Operator to use when comparing the specified value to those stored across the key field while determining which records are matches

value - the comparison value for the operator

order - an Order specification that describes how the result set should be sorted

Returns:

the records that match the criteria

find

public Set<Long> find(String key,
                      String operator,
                      Object value,
                      Order order,
                      Page page)

Description copied from class: Concourse

Return the set of records where the key field contains at least one value that satisfies the operator in relation to the value.

Specified by:

find in class Concourse

Parameters:

key - the field name

operator - a valid description of an Operator to use when comparing the specified value to those stored across the key field while determining which records are matches

value - the comparison value for the operator

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

the records that match the criteria

find

public Set<Long> find(String key,
                      String operator,
                      Object value,
                      Page page)

Description copied from class: Concourse

Return the set of records where the key field contains at least one value that satisfies the operator in relation to the value.

Specified by:

find in class Concourse

Parameters:

key - the field name

operator - a valid description of an Operator to use when comparing the specified value to those stored across the key field while determining which records are matches

value - the comparison value for the operator

page - a {@link Page) specification that describes the page of the result set to return

Returns:

the records that match the criteria

find

public Set<Long> find(String key,
                      String operator,
                      Object value,
                      Timestamp timestamp)

Description copied from class: Concourse

Return the set of records where the key field contained at least one value at timestamp that satisfies the operator in relation to the value.

Specified by:

find in class Concourse

Parameters:

key - the field name

operator - a valid description of an Operator to use when comparing the specified value to those stored across the key field while determining which records are matches

value - the comparison value for the operator

timestamp - a Timestamp that represents the historical instant to use when checking for matches – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

the records that match the criteria

find

public Set<Long> find(String key,
                      String operator,
                      Object value,
                      Timestamp timestamp,
                      Order order)

Description copied from class: Concourse

Return the set of records where the key field contained at least one value at timestamp that satisfies the operator in relation to the value.

Specified by:

find in class Concourse

Parameters:

key - the field name

operator - a valid description of an Operator to use when comparing the specified value to those stored across the key field while determining which records are matches

value - the comparison value for the operator

timestamp - a Timestamp that represents the historical instant to use when checking for matches – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

Returns:

the records that match the criteria

find

public Set<Long> find(String key,
                      String operator,
                      Object value,
                      Timestamp timestamp,
                      Order order,
                      Page page)

Description copied from class: Concourse

Return the set of records where the key field contained at least one value at timestamp that satisfies the operator in relation to the value.

Specified by:

find in class Concourse

Parameters:

key - the field name

operator - a valid description of an Operator to use when comparing the specified value to those stored across the key field while determining which records are matches

value - the comparison value for the operator

timestamp - a Timestamp that represents the historical instant to use when checking for matches – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

the records that match the criteria

find

public Set<Long> find(String key,
                      String operator,
                      Object value,
                      Timestamp timestamp,
                      Page page)

Description copied from class: Concourse

Return the set of records where the key field contained at least one value at timestamp that satisfies the operator in relation to the value.

Specified by:

find in class Concourse

Parameters:

key - the field name

operator - a valid description of an Operator to use when comparing the specified value to those stored across the key field while determining which records are matches

value - the comparison value for the operator

timestamp - a Timestamp that represents the historical instant to use when checking for matches – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

page - a {@link Page) specification that describes the page of the result set to return

Returns:

the records that match the criteria

findOrAdd

public <T> long findOrAdd(String key,
                          T value)
                   throws DuplicateEntryException

Description copied from class: Concourse

Return the unique record where key equals value, or throw a DuplicateEntryException if multiple records match the condition. If no record matches, add key as value into an new record and return the id.

This method can be used to simulate a unique index because it atomically checks for a condition and only adds data if that condition isn't currently satisfied.

Specified by:

findOrAdd in class Concourse

Parameters:

key - the field name

value - the value that must exist in the key field of a single record for that record to match or the value that is added to the key field in a new record if no existing record matches the condition

Returns:

the unique record where key = value, if one exist or the record where the key as value is added

Throws:

DuplicateEntryException

findOrInsert

public long findOrInsert(Criteria criteria,
                         String json)
                  throws DuplicateEntryException

Description copied from class: Concourse

Return the unique record that matches the criteria, if one exist or throw a DuplicateEntryException if multiple records match. If no record matches, Concourse.insert(String) the json into a new record and return the id.

This method can be used to simulate a unique index because it atomically checks for a condition and only inserts data if that condition isn't currently satisfied.

Specified by:

findOrInsert in class Concourse

Parameters:

criteria - a Criteria that contains a well-formed filter for the desired record

Returns:

the unique record that matches criteria, if one exist or the record where the json data is inserted

Throws:

DuplicateEntryException

findOrInsert

public long findOrInsert(String ccl,
                         String json)
                  throws DuplicateEntryException

Description copied from class: Concourse

Return the unique record that matches the ccl filter, if one exist or throw a DuplicateEntryException if multiple records match. If no record matches, Concourse.insert(String) the json into a new record and return the id.

This method can be used to simulate a unique index because it atomically checks for a condition and only inserts data if that condition isn't currently satisfied.

Specified by:

findOrInsert in class Concourse

Parameters:

ccl - a well-formed criteria expressed using the Concourse Criteria Language

json - a JSON blob describing a single object

Returns:

the unique record that matches ccl string, if one exist or the record where the json data is inserted

Throws:

DuplicateEntryException

get

public <T> Map<Long,Map<String,T>> get(Collection<String> keys,
                                       Collection<Long> records)

Description copied from class: Concourse

For each of the keys in each of the records, return the stored value that was most recently added.

Specified by:

get in class Concourse

Parameters:

keys - a collection of field names

records - a collection of record ids

Returns:

a Map associating each of the records to another Map associating each of the keys to the freshest value in the field

get

public <T> Map<Long,Map<String,T>> get(Collection<String> keys,
                                       Collection<Long> records,
                                       Order order)

Description copied from class: Concourse

For each of the keys in each of the records, return the stored value that was most recently added.

Specified by:

get in class Concourse

Parameters:

keys - a collection of field names

records - a collection of record ids

order - an Order specification that describes how the result set should be sorted

Returns:

a Map associating each of the records to another Map associating each of the keys to the freshest value in the field

get

public <T> Map<Long,Map<String,T>> get(Collection<String> keys,
                                       Collection<Long> records,
                                       Order order,
                                       Page page)

Description copied from class: Concourse

For each of the keys in each of the records, return the stored value that was most recently added.

Specified by:

get in class Concourse

Parameters:

keys - a collection of field names

records - a collection of record ids

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the records to another Map associating each of the keys to the freshest value in the field

get

public <T> Map<Long,Map<String,T>> get(Collection<String> keys,
                                       Collection<Long> records,
                                       Page page)

Description copied from class: Concourse

For each of the keys in each of the records, return the stored value that was most recently added.

Specified by:

get in class Concourse

Parameters:

keys - a collection of field names

records - a collection of record ids

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the records to another Map associating each of the keys to the freshest value in the field

get

public <T> Map<Long,Map<String,T>> get(Collection<String> keys,
                                       Collection<Long> records,
                                       Timestamp timestamp)

Description copied from class: Concourse

For each of the keys in each of the records, return the stored value that was most recently added at timestamp.

Specified by:

get in class Concourse

Parameters:

keys - a collection of field names

records - a collection of record ids

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a Map associating each of the records to another Map associating each of the keys to the freshest value in the field at timestamp

get

public <T> Map<Long,Map<String,T>> get(Collection<String> keys,
                                       Collection<Long> records,
                                       Timestamp timestamp,
                                       Order order)

Description copied from class: Concourse

For each of the keys in each of the records, return the stored value that was most recently added at timestamp.

Specified by:

get in class Concourse

Parameters:

keys - a collection of field names

records - a collection of record ids

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

Returns:

a Map associating each of the records to another Map associating each of the keys to the freshest value in the field at timestamp

get

public <T> Map<Long,Map<String,T>> get(Collection<String> keys,
                                       Collection<Long> records,
                                       Timestamp timestamp,
                                       Order order,
                                       Page page)

Description copied from class: Concourse

For each of the keys in each of the records, return the stored value that was most recently added at timestamp.

Specified by:

get in class Concourse

Parameters:

keys - a collection of field names

records - a collection of record ids

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the records to another Map associating each of the keys to the freshest value in the field at timestamp

get

public <T> Map<Long,Map<String,T>> get(Collection<String> keys,
                                       Collection<Long> records,
                                       Timestamp timestamp,
                                       Page page)

Description copied from class: Concourse

For each of the keys in each of the records, return the stored value that was most recently added at timestamp.

Specified by:

get in class Concourse

Parameters:

keys - a collection of field names

records - a collection of record ids

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the records to another Map associating each of the keys to the freshest value in the field at timestamp

get

public <T> Map<Long,Map<String,T>> get(Collection<String> keys,
                                       Criteria criteria)

Description copied from class: Concourse

For each of the keys in every record that matches the criteria, return the stored value that was most recently added.

Specified by:

get in class Concourse

Parameters:

keys - a collection of field names

criteria - a Criteria that contains a well-formed filter for the desired records

Returns:

a Map associating each of the matching records to another Map associating each of the keys to the freshest value in the field

get

public <T> Map<Long,Map<String,T>> get(Collection<String> keys,
                                       Criteria criteria,
                                       Order order)

Description copied from class: Concourse

For each of the keys in every record that matches the criteria, return the stored value that was most recently added.

Specified by:

get in class Concourse

Parameters:

keys - a collection of field names

criteria - a Criteria that contains a well-formed filter for the desired records

order - an Order specification that describes how the result set should be sorted

Returns:

a Map associating each of the matching records to another Map associating each of the keys to the freshest value in the field

get

public <T> Map<Long,Map<String,T>> get(Collection<String> keys,
                                       Criteria criteria,
                                       Order order,
                                       Page page)

Description copied from class: Concourse

For each of the keys in every record that matches the criteria, return the stored value that was most recently added.

Specified by:

get in class Concourse

Parameters:

keys - a collection of field names

criteria - a Criteria that contains a well-formed filter for the desired records

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to another Map associating each of the keys to the freshest value in the field

get

public <T> Map<Long,Map<String,T>> get(Collection<String> keys,
                                       Criteria criteria,
                                       Page page)

Description copied from class: Concourse

For each of the keys in every record that matches the criteria, return the stored value that was most recently added.

Specified by:

get in class Concourse

Parameters:

keys - a collection of field names

criteria - a Criteria that contains a well-formed filter for the desired records

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to another Map associating each of the keys to the freshest value in the field

get

public <T> Map<Long,Map<String,T>> get(Collection<String> keys,
                                       Criteria criteria,
                                       Timestamp timestamp)

Description copied from class: Concourse

For each of the keys in every record that matches the criteria, return the stored value that was most recently added at timestamp.

Specified by:

get in class Concourse

Parameters:

keys - a collection of field names

criteria - a Criteria that contains a well-formed filter for the desired records

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a Map associating each of the matching records to another Map associating each of the keys to the freshest value in the field at timestamp

get

public <T> Map<Long,Map<String,T>> get(Collection<String> keys,
                                       Criteria criteria,
                                       Timestamp timestamp,
                                       Order order)

Description copied from class: Concourse

For each of the keys in every record that matches the criteria, return the stored value that was most recently added at timestamp.

Specified by:

get in class Concourse

Parameters:

keys - a collection of field names

criteria - a Criteria that contains a well-formed filter for the desired records

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

Returns:

a Map associating each of the matching records to another Map associating each of the keys to the freshest value in the field at timestamp

get

public <T> Map<Long,Map<String,T>> get(Collection<String> keys,
                                       Criteria criteria,
                                       Timestamp timestamp,
                                       Order order,
                                       Page page)

Description copied from class: Concourse

For each of the keys in every record that matches the criteria, return the stored value that was most recently added at timestamp.

Specified by:

get in class Concourse

Parameters:

keys - a collection of field names

criteria - a Criteria that contains a well-formed filter for the desired records

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to another Map associating each of the keys to the freshest value in the field at timestamp

get

public <T> Map<Long,Map<String,T>> get(Collection<String> keys,
                                       Criteria criteria,
                                       Timestamp timestamp,
                                       Page page)

Description copied from class: Concourse

For each of the keys in every record that matches the criteria, return the stored value that was most recently added at timestamp.

Specified by:

get in class Concourse

Parameters:

keys - a collection of field names

criteria - a Criteria that contains a well-formed filter for the desired records

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to another Map associating each of the keys to the freshest value in the field at timestamp

get

public <T> Map<String,T> get(Collection<String> keys,
                             long record)

Description copied from class: Concourse

For each of the keys in record, return the stored value that was most recently added.

Specified by:

get in class Concourse

Parameters:

keys - a collection of field names

record - the record id

Returns:

a Map associating each of the keys to the freshest value in the field

get

public <T> Map<String,T> get(Collection<String> keys,
                             long record,
                             Timestamp timestamp)

Description copied from class: Concourse

For each of the keys in record, return the stored value that was most recently added at timestamp.

Specified by:

get in class Concourse

Parameters:

keys - a collection of field names

record - the record id

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a Map associating each of the keys to the freshest value in the field at timestamp

get

public <T> Map<Long,Map<String,T>> get(Collection<String> keys,
                                       String ccl)

Description copied from class: Concourse

For each of the keys in every record that matches the ccl filter, return the stored value that was most recently added.

Specified by:

get in class Concourse

Parameters:

keys - a collection of field names

ccl - a well-formed criteria expressed using the Concourse Criteria Language

Returns:

a Map associating each of the matching records to another Map associating each of the keys to the freshest value in the field

get

public <T> Map<Long,Map<String,T>> get(Collection<String> keys,
                                       String ccl,
                                       Order order)

Description copied from class: Concourse

For each of the keys in every record that matches the ccl filter, return the stored value that was most recently added.

Specified by:

get in class Concourse

Parameters:

keys - a collection of field names

ccl - a well-formed criteria expressed using the Concourse Criteria Language

order - an Order specification that describes how the result set should be sorted

Returns:

a Map associating each of the matching records to another Map associating each of the keys to the freshest value in the field

get

public <T> Map<Long,Map<String,T>> get(Collection<String> keys,
                                       String ccl,
                                       Order order,
                                       Page page)

Description copied from class: Concourse

For each of the keys in every record that matches the ccl filter, return the stored value that was most recently added.

Specified by:

get in class Concourse

Parameters:

keys - a collection of field names

ccl - a well-formed criteria expressed using the Concourse Criteria Language

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to another Map associating each of the keys to the freshest value in the field

get

public <T> Map<Long,Map<String,T>> get(Collection<String> keys,
                                       String ccl,
                                       Page page)

Description copied from class: Concourse

For each of the keys in every record that matches the ccl filter, return the stored value that was most recently added.

Specified by:

get in class Concourse

Parameters:

keys - a collection of field names

ccl - a well-formed criteria expressed using the Concourse Criteria Language

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to another Map associating each of the keys to the freshest value in the field

get

public <T> Map<Long,Map<String,T>> get(Collection<String> keys,
                                       String ccl,
                                       Timestamp timestamp)

Description copied from class: Concourse

For each of the keys in every record that matches the ccl filter, return the stored value that was most recently added at timestamp.

Specified by:

get in class Concourse

Parameters:

keys - a collection of field names

ccl - a well-formed criteria expressed using the Concourse Criteria Language

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a Map associating each of the matching records to another Map associating each of the keys to the freshest value in the field at timestamp

get

public <T> Map<Long,Map<String,T>> get(Collection<String> keys,
                                       String ccl,
                                       Timestamp timestamp,
                                       Order order)

Description copied from class: Concourse

For each of the keys in every record that matches the ccl filter, return the stored value that was most recently added at timestamp.

Specified by:

get in class Concourse

Parameters:

keys - a collection of field names

ccl - a well-formed criteria expressed using the Concourse Criteria Language

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

Returns:

a Map associating each of the matching records to another Map associating each of the keys to the freshest value in the field at timestamp

get

public <T> Map<Long,Map<String,T>> get(Collection<String> keys,
                                       String ccl,
                                       Timestamp timestamp,
                                       Order order,
                                       Page page)

Description copied from class: Concourse

For each of the keys in every record that matches the ccl filter, return the stored value that was most recently added at timestamp.

Specified by:

get in class Concourse

Parameters:

keys - a collection of field names

ccl - a well-formed criteria expressed using the Concourse Criteria Language

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to another Map associating each of the keys to the freshest value in the field at timestamp

get

public <T> Map<Long,Map<String,T>> get(Collection<String> keys,
                                       String ccl,
                                       Timestamp timestamp,
                                       Page page)

Description copied from class: Concourse

For each of the keys in every record that matches the ccl filter, return the stored value that was most recently added at timestamp.

Specified by:

get in class Concourse

Parameters:

keys - a collection of field names

ccl - a well-formed criteria expressed using the Concourse Criteria Language

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to another Map associating each of the keys to the freshest value in the field at timestamp

get

public <T> Map<Long,Map<String,T>> get(Criteria criteria)

Description copied from class: Concourse

For every key in every record that matches the criteria, return the stored value that was most recently added.

Specified by:

get in class Concourse

Parameters:

criteria - a Criteria that contains a well-formed filter for the desired records

Returns:

a Map associating each of the matching records to another Map associating each of the record's keys to the freshest value in the field

get

public <T> Map<Long,Map<String,T>> get(Criteria criteria,
                                       Order order)

Description copied from class: Concourse

For every key in every record that matches the criteria, return the stored value that was most recently added.

Specified by:

get in class Concourse

Parameters:

criteria - a Criteria that contains a well-formed filter for the desired records

order - an Order specification that describes how the result set should be sorted

Returns:

a Map associating each of the matching records to another Map associating each of the record's keys to the freshest value in the field

get

public <T> Map<Long,Map<String,T>> get(Criteria criteria,
                                       Order order,
                                       Page page)

Description copied from class: Concourse

For every key in every record that matches the criteria, return the stored value that was most recently added.

Specified by:

get in class Concourse

Parameters:

criteria - a Criteria that contains a well-formed filter for the desired records

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to another Map associating each of the record's keys to the freshest value in the field

get

public <T> Map<Long,Map<String,T>> get(Criteria criteria,
                                       Page page)

Description copied from class: Concourse

For every key in every record that matches the criteria, return the stored value that was most recently added.

Specified by:

get in class Concourse

Parameters:

criteria - a Criteria that contains a well-formed filter for the desired records

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to another Map associating each of the record's keys to the freshest value in the field

get

public <T> Map<Long,Map<String,T>> get(Criteria criteria,
                                       Timestamp timestamp)

Description copied from class: Concourse

For every key in every record that matches the criteria, return the stored value that was most recently added at timestamp .

Specified by:

get in class Concourse

Parameters:

criteria - a Criteria that contains a well-formed filter for the desired records

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a Map associating each of the matching records to another Map associating each of the record's keys to the freshest value in the field at timestamp

get

public <T> Map<Long,Map<String,T>> get(Criteria criteria,
                                       Timestamp timestamp,
                                       Order order)

Description copied from class: Concourse

For every key in every record that matches the criteria, return the stored value that was most recently added at timestamp .

Specified by:

get in class Concourse

Parameters:

criteria - a Criteria that contains a well-formed filter for the desired records

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

Returns:

a Map associating each of the matching records to another Map associating each of the record's keys to the freshest value in the field at timestamp

get

public <T> Map<Long,Map<String,T>> get(Criteria criteria,
                                       Timestamp timestamp,
                                       Order order,
                                       Page page)

Description copied from class: Concourse

For every key in every record that matches the criteria, return the stored value that was most recently added at timestamp .

Specified by:

get in class Concourse

Parameters:

criteria - a Criteria that contains a well-formed filter for the desired records

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to another Map associating each of the record's keys to the freshest value in the field at timestamp

get

public <T> Map<Long,Map<String,T>> get(Criteria criteria,
                                       Timestamp timestamp,
                                       Page page)

Description copied from class: Concourse

For every key in every record that matches the criteria, return the stored value that was most recently added at timestamp .

Specified by:

get in class Concourse

Parameters:

criteria - a Criteria that contains a well-formed filter for the desired records

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to another Map associating each of the record's keys to the freshest value in the field at timestamp

get

public <T> Map<Long,Map<String,T>> get(String ccl)

Description copied from class: Concourse

For every key in every record that matches the ccl filter, return the stored value that was most recently added.

Specified by:

get in class Concourse

Parameters:

ccl - a well-formed criteria expressed using the Concourse Criteria Language

Returns:

a Map associating each of the matching records to another Map associating each of the record's keys to the freshest value in the field

get

public <T> Map<Long,T> get(String key,
                           Collection<Long> records)

Description copied from class: Concourse

For each of the records, return the stored value in the key field that was most recently added.

Specified by:

get in class Concourse

Parameters:

key - the field name

records - a collection of record ids

Returns:

a Map associating each of the records to the freshest value in the key field

get

public <T> Map<Long,T> get(String key,
                           Collection<Long> records,
                           Order order)

Description copied from class: Concourse

For each of the records, return the stored value in the key field that was most recently added.

Specified by:

get in class Concourse

Parameters:

key - the field name

records - a collection of record ids

order - an Order specification that describes how the result set should be sorted

Returns:

a Map associating each of the records to the freshest value in the key field

get

public <T> Map<Long,T> get(String key,
                           Collection<Long> records,
                           Order order,
                           Page page)

Description copied from class: Concourse

For each of the records, return the stored value in the key field that was most recently added.

Specified by:

get in class Concourse

Parameters:

key - the field name

records - a collection of record ids

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the records to the freshest value in the key field

get

public <T> Map<Long,T> get(String key,
                           Collection<Long> records,
                           Page page)

Description copied from class: Concourse

For each of the records, return the stored value in the key field that was most recently added.

Specified by:

get in class Concourse

Parameters:

key - the field name

records - a collection of record ids

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the records to the freshest value in the key field

get

public <T> Map<Long,T> get(String key,
                           Collection<Long> records,
                           Timestamp timestamp)

Description copied from class: Concourse

For each of the records, return the stored value in the key field that was most recently added at timestamp

Specified by:

get in class Concourse

Parameters:

key - the field name

records - a collection of record ids

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a Map associating each of the records to the freshest value in the key field at timestamp

get

public <T> Map<Long,T> get(String key,
                           Collection<Long> records,
                           Timestamp timestamp,
                           Order order)

Description copied from class: Concourse

For each of the records, return the stored value in the key field that was most recently added at timestamp

Specified by:

get in class Concourse

Parameters:

key - the field name

records - a collection of record ids

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

Returns:

a Map associating each of the records to the freshest value in the key field at timestamp

get

public <T> Map<Long,T> get(String key,
                           Collection<Long> records,
                           Timestamp timestamp,
                           Order order,
                           Page page)

Description copied from class: Concourse

For each of the records, return the stored value in the key field that was most recently added at timestamp

Specified by:

get in class Concourse

Parameters:

key - the field name

records - a collection of record ids

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the records to the freshest value in the key field at timestamp

get

public <T> Map<Long,T> get(String key,
                           Collection<Long> records,
                           Timestamp timestamp,
                           Page page)

Description copied from class: Concourse

For each of the records, return the stored value in the key field that was most recently added at timestamp

Specified by:

get in class Concourse

Parameters:

key - the field name

records - a collection of record ids

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the records to the freshest value in the key field at timestamp

get

public <T> Map<Long,T> get(String key,
                           Criteria criteria)

Description copied from class: Concourse

For every record that matches the criteria, return the stored value in the key field that was most recently added.

Specified by:

get in class Concourse

Parameters:

key - the field name

criteria - a Criteria that contains a well-formed filter for the desired records

Returns:

a Map associating each of the matching records to the freshest value in the key field

get

public <T> Map<Long,T> get(String key,
                           Criteria criteria,
                           Order order)

Description copied from class: Concourse

For every record that matches the criteria, return the stored value in the key field that was most recently added.

Specified by:

get in class Concourse

Parameters:

key - the field name

criteria - a Criteria that contains a well-formed filter for the desired records

order - an Order specification that describes how the result set should be sorted

Returns:

a Map associating each of the matching records to the freshest value in the key field

get

public <T> Map<Long,T> get(String key,
                           Criteria criteria,
                           Order order,
                           Page page)

Description copied from class: Concourse

For every record that matches the criteria, return the stored value in the key field that was most recently added.

Specified by:

get in class Concourse

Parameters:

key - the field name

criteria - a Criteria that contains a well-formed filter for the desired records

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to the freshest value in the key field

get

public <T> Map<Long,T> get(String key,
                           Criteria criteria,
                           Page page)

Description copied from class: Concourse

For every record that matches the criteria, return the stored value in the key field that was most recently added.

Specified by:

get in class Concourse

Parameters:

key - the field name

criteria - a Criteria that contains a well-formed filter for the desired records

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to the freshest value in the key field

get

public <T> Map<Long,T> get(String key,
                           Criteria criteria,
                           Timestamp timestamp)

Description copied from class: Concourse

For every record that matches the criteria, return the stored value in the key field that was most recently added at timestamp.

Specified by:

get in class Concourse

Parameters:

key - the field name

criteria - a Criteria that contains a well-formed filter for the desired records

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a Map associating each of the matching records to the freshest value in the key field

get

public <T> Map<Long,T> get(String key,
                           Criteria criteria,
                           Timestamp timestamp,
                           Order order)

Description copied from class: Concourse

For every record that matches the criteria, return the stored value in the key field that was most recently added at timestamp.

Specified by:

get in class Concourse

Parameters:

key - the field name

criteria - a Criteria that contains a well-formed filter for the desired records

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

Returns:

a Map associating each of the matching records to the freshest value in the key field

get

public <T> Map<Long,T> get(String key,
                           Criteria criteria,
                           Timestamp timestamp,
                           Order order,
                           Page page)

Description copied from class: Concourse

For every record that matches the criteria, return the stored value in the key field that was most recently added at timestamp.

Specified by:

get in class Concourse

Parameters:

key - the field name

criteria - a Criteria that contains a well-formed filter for the desired records

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to the freshest value in the key field

get

public <T> Map<Long,T> get(String key,
                           Criteria criteria,
                           Timestamp timestamp,
                           Page page)

Description copied from class: Concourse

For every record that matches the criteria, return the stored value in the key field that was most recently added at timestamp.

Specified by:

get in class Concourse

Parameters:

key - the field name

criteria - a Criteria that contains a well-formed filter for the desired records

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to the freshest value in the key field

get

public <T> T get(String key,
                 long record)

Description copied from class: Concourse

Return the stored value that was most recently added for key in record. If the field is empty, return null.

Specified by:

get in class Concourse

Parameters:

key - the field name

record - the record id

Returns:

the freshest value in the field

get

public <T> T get(String key,
                 long record,
                 Timestamp timestamp)

Description copied from class: Concourse

Return the stored value that was most recently added for key in record at timestamp. If the field was empty at timestamp, return null.

Specified by:

get in class Concourse

Parameters:

key - the field name

record - the record id

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

the freshest value in the field at timestamp

get

public <T> Map<Long,Map<String,T>> get(String ccl,
                                       Order order)

Description copied from class: Concourse

For every key in every record that matches the ccl filter, return the stored value that was most recently added.

Specified by:

get in class Concourse

Parameters:

ccl - a well-formed criteria expressed using the Concourse Criteria Language

order - an Order specification that describes how the result set should be sorted

Returns:

a Map associating each of the matching records to another Map associating each of the record's keys to the freshest value in the field

get

public <T> Map<Long,Map<String,T>> get(String ccl,
                                       Order order,
                                       Page page)

Description copied from class: Concourse

For every key in every record that matches the ccl filter, return the stored value that was most recently added.

Specified by:

get in class Concourse

Parameters:

ccl - a well-formed criteria expressed using the Concourse Criteria Language

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to another Map associating each of the record's keys to the freshest value in the field

get

public <T> Map<Long,Map<String,T>> get(String ccl,
                                       Page page)

Description copied from class: Concourse

For every key in every record that matches the ccl filter, return the stored value that was most recently added.

Specified by:

get in class Concourse

Parameters:

ccl - a well-formed criteria expressed using the Concourse Criteria Language

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to another Map associating each of the record's keys to the freshest value in the field

get

public <T> Map<Long,T> get(String key,
                           String ccl)

Description copied from class: Concourse

For every record that matches the ccl filter, return the stored value in the key field that was most recently added.

This method is syntactic sugar for Concourse.get(String, Criteria). The only difference is that this method takes a in-process Criteria building sequence for convenience.

Specified by:

get in class Concourse

Parameters:

key - the field name

ccl - a well-formed criteria expressed using the Concourse Criteria Language

Returns:

a Map associating each of the matching records to the freshest value in the key field

get

public <T> Map<Long,T> get(String key,
                           String ccl,
                           Order order)

Description copied from class: Concourse

For every record that matches the ccl filter, return the stored value in the key field that was most recently added.

This method is syntactic sugar for Concourse.get(String, Criteria). The only difference is that this method takes a in-process Criteria building sequence for convenience.

Specified by:

get in class Concourse

Parameters:

key - the field name

ccl - a well-formed criteria expressed using the Concourse Criteria Language

order - an Order specification that describes how the result set should be sorted

Returns:

a Map associating each of the matching records to the freshest value in the key field

get

public <T> Map<Long,T> get(String key,
                           String ccl,
                           Order order,
                           Page page)

Description copied from class: Concourse

For every record that matches the ccl filter, return the stored value in the key field that was most recently added.

This method is syntactic sugar for Concourse.get(String, Criteria). The only difference is that this method takes a in-process Criteria building sequence for convenience.

Specified by:

get in class Concourse

Parameters:

key - the field name

ccl - a well-formed criteria expressed using the Concourse Criteria Language

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to the freshest value in the key field

get

public <T> Map<Long,T> get(String key,
                           String ccl,
                           Page page)

Description copied from class: Concourse

For every record that matches the ccl filter, return the stored value in the key field that was most recently added.

This method is syntactic sugar for Concourse.get(String, Criteria). The only difference is that this method takes a in-process Criteria building sequence for convenience.

Specified by:

get in class Concourse

Parameters:

key - the field name

ccl - a well-formed criteria expressed using the Concourse Criteria Language

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to the freshest value in the key field

get

public <T> Map<Long,T> get(String key,
                           String ccl,
                           Timestamp timestamp)

Description copied from class: Concourse

For every record that matches the ccl filter, return the stored value in the key field that was most recently added at timestamp.

This method is syntactic sugar for Concourse.get(String, Criteria, Timestamp). The only difference is that this method takes a in-process Criteria building sequence for convenience.

Specified by:

get in class Concourse

Parameters:

key - the field name

ccl - a well-formed criteria expressed using the Concourse Criteria Language

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a Map associating each of the matching records to the freshest value in the key field at timestamp

get

public <T> Map<Long,T> get(String key,
                           String ccl,
                           Timestamp timestamp,
                           Order order)

Description copied from class: Concourse

For every record that matches the ccl filter, return the stored value in the key field that was most recently added at timestamp.

This method is syntactic sugar for Concourse.get(String, Criteria, Timestamp). The only difference is that this method takes a in-process Criteria building sequence for convenience.

Specified by:

get in class Concourse

Parameters:

key - the field name

ccl - a well-formed criteria expressed using the Concourse Criteria Language

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

Returns:

a Map associating each of the matching records to the freshest value in the key field at timestamp

get

public <T> Map<Long,T> get(String key,
                           String ccl,
                           Timestamp timestamp,
                           Order order,
                           Page page)

Description copied from class: Concourse

For every record that matches the ccl filter, return the stored value in the key field that was most recently added at timestamp.

This method is syntactic sugar for Concourse.get(String, Criteria, Timestamp). The only difference is that this method takes a in-process Criteria building sequence for convenience.

Specified by:

get in class Concourse

Parameters:

key - the field name

ccl - a well-formed criteria expressed using the Concourse Criteria Language

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to the freshest value in the key field at timestamp

get

public <T> Map<Long,T> get(String key,
                           String ccl,
                           Timestamp timestamp,
                           Page page)

Description copied from class: Concourse

For every record that matches the ccl filter, return the stored value in the key field that was most recently added at timestamp.

This method is syntactic sugar for Concourse.get(String, Criteria, Timestamp). The only difference is that this method takes a in-process Criteria building sequence for convenience.

Specified by:

get in class Concourse

Parameters:

key - the field name

ccl - a well-formed criteria expressed using the Concourse Criteria Language

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to the freshest value in the key field at timestamp

get

public <T> Map<Long,Map<String,T>> get(String ccl,
                                       Timestamp timestamp)

Description copied from class: Concourse

For every key in every record that matches the ccl filter, return the stored value that was most recently added.

Specified by:

get in class Concourse

Parameters:

ccl - a well-formed criteria expressed using the Concourse Criteria Language

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a Map associating each of the matching records to another Map associating each of the record's keys to the freshest value in the field

get

public <T> Map<Long,Map<String,T>> get(String ccl,
                                       Timestamp timestamp,
                                       Order order)

Description copied from class: Concourse

For every key in every record that matches the ccl filter, return the stored value that was most recently added.

Specified by:

get in class Concourse

Parameters:

ccl - a well-formed criteria expressed using the Concourse Criteria Language

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

Returns:

a Map associating each of the matching records to another Map associating each of the record's keys to the freshest value in the field

get

public <T> Map<Long,Map<String,T>> get(String ccl,
                                       Timestamp timestamp,
                                       Order order,
                                       Page page)

Description copied from class: Concourse

For every key in every record that matches the ccl filter, return the stored value that was most recently added.

Specified by:

get in class Concourse

Parameters:

ccl - a well-formed criteria expressed using the Concourse Criteria Language

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to another Map associating each of the record's keys to the freshest value in the field

get

public <T> Map<Long,Map<String,T>> get(String ccl,
                                       Timestamp timestamp,
                                       Page page)

Description copied from class: Concourse

For every key in every record that matches the ccl filter, return the stored value that was most recently added.

Specified by:

get in class Concourse

Parameters:

ccl - a well-formed criteria expressed using the Concourse Criteria Language

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to another Map associating each of the record's keys to the freshest value in the field

getServerEnvironment

public String getServerEnvironment()

Description copied from class: Concourse

Return the name of the connected environment.

Specified by:

getServerEnvironment in class Concourse

Returns:

the server environment to which this client is connected

getServerVersion

public String getServerVersion()

Description copied from class: Concourse

Return the version of the connected server.

Specified by:

getServerVersion in class Concourse

Returns:

the server version

insert

public Set<Long> insert(String json)

Description copied from class: Concourse

Atomically insert the key/value associations from the json string into as many new records as necessary.

If the json string contains a top-level array (of objects), this method will insert each of the objects in a new and distinct record. The Set that is returned will contain the ids of all those records. On the other hand, if the json string contains a single top-level object, this method will insert that object in a single new record. The Set that is returned will only contain the id of that record.

Regardless of whether the top-level element is an object or an array, each object in the json string contains one or more keys, each of which maps to a JSON primitive or an array of JSON primitives (e.g. no nested objects or arrays).

Specified by:

insert in class Concourse

Parameters:

json - a valid json string with either a top-level object or array

Returns:

a Set that contains one or more records ids where the objects in json are inserted, respectively

insert

public Map<Long,Boolean> insert(String json,
                                Collection<Long> records)

Description copied from class: Concourse

Atomically insert the key/value associations from the json object into each of the records, if possible.

An insert will fail for a given record if any of the key/value associations in the json object currently exist in that record (e.g. adding the key/value association would fail).

The json must contain a top-level object that contains one or more keys, each of which maps to a JSON primitive or an array of JSON primitives (e.g. no nested objects or arrays).

Specified by:

insert in class Concourse

Parameters:

json - a valid json string containing a top-level object

records - a collection of record ids

Returns:

a Map associating each record id to a boolean that indicates if the json was successfully inserted in that record

insert

public boolean insert(String json,
                      long record)

Description copied from class: Concourse

Atomically insert the key/value associations from the json object into record, if possible.

The insert will fail if any of the key/value associations in the json object currently exist in record (e.g. adding the key/value association would fail).

The json must contain a JSON object that contains one or more keys, each of which maps to a JSON primitive or an array of JSON primitives.

Specified by:

insert in class Concourse

Parameters:

json - json a valid json string containing a top-level object

record - the record id

Returns:

true if the json is inserted into record

inventory

public Set<Long> inventory()

Description copied from class: Concourse

Return all the records that have current or historical data.

Specified by:

inventory in class Concourse

Returns:

a Set containing the ids of records that have current or historical data

invokePlugin

public <T> T invokePlugin(String id,
                          String method,
                          Object... args)

Description copied from class: Concourse

Invoke method using args within the plugin identified by id.

There must be a class named id available in Concourse Server via a plugin distribution. The method must also be accessible within the class.

If the plugin throws any Exception, it'll be re-thrown here as a RuntimeException.

Specified by:

invokePlugin in class Concourse

Parameters:

id - the fully qualified name of the plugin class (e.g. com.cinchapi.plugin.PluginClass)

method - the name of the method within the pluginClass

args - the arguments to pass to the method

Returns:

the result returned from the plugin

jsonify

public String jsonify(Collection<Long> records)

Description copied from class: Concourse

Atomically dump the data in each of the records as a JSON array of objects.

Specified by:

jsonify in class Concourse

Parameters:

records - a collection of record ids

Returns:

a JSON array of objects, each of which contains the data in the one of the records, respectively

jsonify

public String jsonify(Collection<Long> records,
                      boolean identifier)

Description copied from class: Concourse

Atomically dump the data in each of the records as a JSON array of objects and optionally include a special identifier key that contains the record id for each of the dumped objects.

Specified by:

jsonify in class Concourse

Parameters:

records - a collection of record ids

identifier - a boolean that indicates whether to include a special key (Constants.JSON_RESERVED_IDENTIFIER_NAME) that maps to the record id in each of the dumped objects

Returns:

a JSON array of objects, each of which contains the data in the one of the records, respectively

jsonify

public String jsonify(Collection<Long> records,
                      Timestamp timestamp)

Description copied from class: Concourse

Atomically dump the data in each of the records at timestamp as a JSON array of objects.

Specified by:

jsonify in class Concourse

Parameters:

records - a collection of record ids

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a JSON array of objects, each of which contains the data in the one of the records at timestamp, respectively

jsonify

public String jsonify(Collection<Long> records,
                      Timestamp timestamp,
                      boolean identifier)

Description copied from class: Concourse

Atomically dump the data in each of the records at timestamp as a JSON array of objects and optionally include a special identifier key that contains the record id for each of the dumped objects.

Specified by:

jsonify in class Concourse

Parameters:

records - a collection of record ids

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

identifier - a boolean that indicates whether to include a special key (Constants.JSON_RESERVED_IDENTIFIER_NAME) that maps to the record id in each of the dumped objects

Returns:

a JSON array of objects, each of which contains the data in the one of the records at timestamp, respectively

jsonify

public String jsonify(long record)

Description copied from class: Concourse

Atomically dump all the data in record as a JSON object.

Specified by:

jsonify in class Concourse

Parameters:

record - the record id

Returns:

a JSON object that contains all the data in record

jsonify

public String jsonify(long record,
                      boolean identifier)

Description copied from class: Concourse

Atomically dump all the data in record as a JSON object and optionally include a special identifier key that contains the record id.

Specified by:

jsonify in class Concourse

Parameters:

record - the record id

identifier - a boolean that indicates whether to include a special key (Constants.JSON_RESERVED_IDENTIFIER_NAME) that maps to the record id in each of the dumped objects

Returns:

a JSON object that contains all the data in record

jsonify

public String jsonify(long record,
                      Timestamp timestamp)

Description copied from class: Concourse

Atomically dump all the data in record at timestamp as a JSON object.

Specified by:

jsonify in class Concourse

Parameters:

record - the record id

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a JSON object that contains all the data in record at timestamp

jsonify

public String jsonify(long record,
                      Timestamp timestamp,
                      boolean identifier)

Description copied from class: Concourse

Atomically dump all the data in record at timestamp as a JSON object and optionally include a special identifier key that contains the record id.

Specified by:

jsonify in class Concourse

Parameters:

record - the record id

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

identifier - a boolean that indicates whether to include a special key (Constants.JSON_RESERVED_IDENTIFIER_NAME) that maps to the record id in each of the dumped objects

Returns:

a JSON object that contains all the data in record at timestamp

link

public Map<Long,Boolean> link(String key,
                              Collection<Long> destinations,
                              long source)

Description copied from class: Concourse

Append links from key in source to each of the destinations.

Specified by:

link in class Concourse

Parameters:

key - the field name

destinations - a collection of ids for the records where each of the links points, respectively

source - the id of the record where each of the links originate

Returns:

a Map associating the ids for each of the destinations to a boolean that indicates whether the link was successfully added

link

public boolean link(String key,
                    long destination,
                    long source)

Description copied from class: Concourse

Append a link from key in source to destination.

Specified by:

link in class Concourse

Parameters:

key - the field name

destination - the id of the record where the link points

source - the id of the record where the link originates

Returns:

true if the link is added

navigate

public <T> Map<Long,Map<String,Set<T>>> navigate(Collection<String> keys,
                                                 Collection<Long> records)

Description copied from class: Concourse

Traverse the document-graph along each of the navigation keys, starting at each of the records and return the data contained at each of the destinations.

Specified by:

navigate in class Concourse

Parameters:

keys - a collection of navigation keys

records - a collection of record ids from which the navigation starts

Returns:

a Map associating each of the destination records to another Map associating each of the destination keys to a Set containing all the values stored in the respective fields

See Also:

https://docs.cinchapi.com/concourse/guide/glossary/#navigation-key

navigate

public <T> Map<Long,Map<String,Set<T>>> navigate(Collection<String> keys,
                                                 Collection<Long> records,
                                                 Timestamp timestamp)

Description copied from class: Concourse

Traverse the document-graph at timestamp along each of the navigation keys, starting at each of the records and return the data contained at each of the destinations at timestamp.

Specified by:

navigate in class Concourse

Parameters:

keys - a collection of navigation keys

records - a collection of record ids from which the navigation starts

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a Map associating each of the destination records to another Map associating each of the destination keys to a Set containing all the values stored in the respective fields at timestamp

See Also:

https://docs.cinchapi.com/concourse/guide/glossary/#navigation-key

navigate

public <T> Map<Long,Map<String,Set<T>>> navigate(Collection<String> keys,
                                                 Criteria criteria)

Description copied from class: Concourse

Traverse the document-graph along each of the navigation keys, starting at each of the records that match the criteria and return the data contained at each of the destinations.

Specified by:

navigate in class Concourse

Parameters:

keys - a collection of navigation keys

criteria - a Criteria that contains a well-formed filter for the desired records

Returns:

a Map associating each of the destination records to another Map associating each of the destination keys to a Set containing all the values stored in the respective fields

See Also:

https://docs.cinchapi.com/concourse/guide/glossary/#navigation-key

navigate

public <T> Map<Long,Map<String,Set<T>>> navigate(Collection<String> keys,
                                                 Criteria criteria,
                                                 Timestamp timestamp)

Description copied from class: Concourse

Traverse the document-graph at timestamp along each of the navigation keys, starting at each of the records that matched the criteria and return the data contained at each of the destinations at timestamp.

Specified by:

navigate in class Concourse

Parameters:

keys - a collection of navigation keys

criteria - a Criteria that contains a well-formed filter for the desired records

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a Map associating each of the destination records to another Map associating each of the destination keys to a Set containing all the values stored in the respective fields at timestamp

See Also:

https://docs.cinchapi.com/concourse/guide/glossary/#navigation-key

navigate

public <T> Map<Long,Map<String,Set<T>>> navigate(Collection<String> keys,
                                                 long record)

Description copied from class: Concourse

Traverse the document-graph along each of the navigation keys, starting at record and return the data contained at each of the destinations.

Specified by:

navigate in class Concourse

Parameters:

keys - a collection of navigation keys

record - the record id from which the navigation starts

Returns:

a Map associating each of the destination records to another Map associating each of the destination keys to a Set containing all the values stored in the respective fields

See Also:

https://docs.cinchapi.com/concourse/guide/glossary/#navigation-key

navigate

public <T> Map<Long,Map<String,Set<T>>> navigate(Collection<String> keys,
                                                 long record,
                                                 Timestamp timestamp)

Description copied from class: Concourse

Traverse the document-graph at timestamp along each of the navigation keys, starting at record and return the data contained at each of the destinations at timestamp.

Specified by:

navigate in class Concourse

Parameters:

keys - a collection of navigation keys

record - the record id from which the navigation starts

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a Map associating each of the destination records to another Map associating each of the destination keys to a Set containing all the values stored in the respective fields at timestamp

See Also:

https://docs.cinchapi.com/concourse/guide/glossary/#navigation-key

navigate

public <T> Map<Long,Map<String,Set<T>>> navigate(Collection<String> keys,
                                                 String ccl)

Description copied from class: Concourse

Traverse the document-graph along each of the navigation keys, starting at each of the records that match the criteria and return the data contained at each of the destinations.

Specified by:

navigate in class Concourse

Parameters:

keys - a collection of navigation keys

Returns:

a Map associating each of the destination records to another Map associating each of the destination keys to a Set containing all the values stored in the respective fields

See Also:

https://docs.cinchapi.com/concourse/guide/glossary/#navigation-key

navigate

public <T> Map<Long,Map<String,Set<T>>> navigate(Collection<String> keys,
                                                 String ccl,
                                                 Timestamp timestamp)

Description copied from class: Concourse

Traverse the document-graph at timestamp along each of the navigation keys, starting at each of the records that matched the criteria and return the data contained at each of the destinations at timestamp.

Specified by:

navigate in class Concourse

Parameters:

keys - a collection of navigation keys

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a Map associating each of the destination records to another Map associating each of the destination keys to a Set containing all the values stored in the respective fields at timestamp

See Also:

https://docs.cinchapi.com/concourse/guide/glossary/#navigation-key

navigate

public <T> Map<Long,Set<T>> navigate(String key,
                                     Collection<Long> records)

Description copied from class: Concourse

Return all values stored for key in each of the records. Navigates through the key splited with dot(.) operator. Iterates only if the key has a link as value which points to another record.

Specified by:

navigate in class Concourse

Parameters:

key - the field name

records - a collection of record ids

Returns:

a Map associating each of the records to a Set containing all the values stored in the respective field

navigate

public <T> Map<Long,Set<T>> navigate(String key,
                                     Collection<Long> records,
                                     Timestamp timestamp)

Description copied from class: Concourse

Return all values stored for key in each of the records at timestamp.Navigates through the key splited with dot(.) operator.

Iterates only if the key has a link as value which points to another record.

Specified by:

navigate in class Concourse

Parameters:

key - the field name

records - a collection of record ids

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a Map associating each of the records to a Set containing all the values stored in the respective field

navigate

public <T> Map<Long,Set<T>> navigate(String key,
                                     Criteria criteria)

Description copied from class: Concourse

Return all the values stored for key in every record that matches the Criteria filter. Navigates through the key splited with dot(.) operator.

Iterates only if the key has a link as value which points to another record.

Specified by:

navigate in class Concourse

Parameters:

key - the field name

Returns:

a Map associating each of the the matching records to a Set containing all the values stored in the respective field

navigate

public <T> Map<Long,Set<T>> navigate(String key,
                                     Criteria criteria,
                                     Timestamp timestamp)

Description copied from class: Concourse

Return all the values stored for key in every record that matches the Criteria filter. Navigates through the key splited with dot(.) operator.

Iterates only if the key has a link as value which points to another record.

Specified by:

navigate in class Concourse

Parameters:

key - the field name

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a Map associating each of the the matching records to a Set containing all the values stored in the respective field

navigate

public <T> Map<Long,Set<T>> navigate(String key,
                                     long record)

Description copied from class: Concourse

Return all the values stored for key in record.Iterates through the key splitted with dot(.) operator. Navigates only if the key has a link as value which points to another record.

Specified by:

navigate in class Concourse

Parameters:

key - the field name

record - the record id

Returns:

a Map containing record and all the values stored in the field

navigate

public <T> Map<Long,Set<T>> navigate(String key,
                                     long record,
                                     Timestamp timestamp)

Description copied from class: Concourse

Return all the values stored for key in record at timestamp. Navigates through the key splitted with dot(.) operator. Iterates only if the key has a link as value which points to another record.

Specified by:

navigate in class Concourse

Parameters:

key - the field name

record - the record id

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a Map containing all the values stored in the field at timestamp

navigate

public <T> Map<Long,Set<T>> navigate(String key,
                                     String ccl)

Description copied from class: Concourse

Return all the values stored for key in every record that matches the ccl filter. Navigates through the key splited with dot(.) operator.

Iterates only if the key has a link as value which points to another record.

Specified by:

navigate in class Concourse

Parameters:

key - the field name

ccl - a well-formed criteria expressed using the Concourse Criteria Language

Returns:

a Map associating each of the the matching records to a Set containing all the values stored in the respective field

navigate

public <T> Map<Long,Set<T>> navigate(String key,
                                     String ccl,
                                     Timestamp timestamp)

Description copied from class: Concourse

Return all the values stored for key in every record that matches the ccl filter. Navigates through the key splited with dot(.) operator.

Iterates only if the key has a link as value which points to another record.

Specified by:

navigate in class Concourse

Parameters:

key - the field name

ccl - a well-formed criteria expressed using the Concourse Criteria Language

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a Map associating each of the the matching records to a Set containing all the values stored in the respective field

ping

public boolean ping()

Description copied from class: Concourse

Test the connection to the server.

Check if the server is responsive by sending an echo request and awaiting a response. This request is designed to simply test the connection and potentially measure latency without incurring any additional overhead for data processing or availability.

If this method returns false it could mean that this client was somehow disconnected, and establishing a new connection would allow for subsequent communication. Or, it can mean that the server is down. Callers are advised to attempt multiple pings across different connections before concluding that the server is down.

Specified by:

ping in class Concourse

Returns:

boolean - true if the server is responsive to this client

ping

public Map<Long,Boolean> ping(Collection<Long> records)

Description copied from class: Concourse

Atomically check to see if each of the records currently contains any data.

Specified by:

ping in class Concourse

Parameters:

records - a collection of record ids

Returns:

a Map associating each of the records to a boolean that indicates whether that record currently contains any data.

ping

public boolean ping(long record)

Description copied from class: Concourse

Check to see if record currently contains any data.

Specified by:

ping in class Concourse

Parameters:

record - the record id

Returns:

true if record currently contains any data, otherwise false

reconcile

public <T> void reconcile(String key,
                          long record,
                          Collection<T> values)

Description copied from class: Concourse

Make the necessary changes to the data stored for key in record so that it contains the exact same values as the specified collection.

Specified by:

reconcile in class Concourse

Parameters:

key - the field name

record - the record id

values - the collection of values that should be exactly what is contained in the field after this method executes

remove

public <T> Map<Long,Boolean> remove(String key,
                                    T value,
                                    Collection<Long> records)

Description copied from class: Concourse

Atomically remove key as value from each of the records where it currently exists.

Specified by:

remove in class Concourse

Parameters:

key - the field name

value - the value to remove

records - a collection of record ids

Returns:

a Map associating each of the records to a boolean that indicates whether the data was removed

remove

public <T> boolean remove(String key,
                          T value,
                          long record)

Description copied from class: Concourse

Remove key as value from record if it currently exists.

Specified by:

remove in class Concourse

Parameters:

key - the field name

value - the value to remove

record - the record id

Returns:

true if the data is removed

revert

public void revert(Collection<String> keys,
                   Collection<Long> records,
                   Timestamp timestamp)

Description copied from class: Concourse

Atomically revert each of the keys in each of the records to their state at timestamp by creating new revisions that undo the net changes that have occurred since timestamp.

Specified by:

revert in class Concourse

Parameters:

keys - a collection of field names

records - a collection of record ids

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

revert

public void revert(Collection<String> keys,
                   long record,
                   Timestamp timestamp)

Description copied from class: Concourse

Atomically revert each of the keys in record to their state at timestamp by creating new revisions that undo the net changes that have occurred since timestamp.

Specified by:

revert in class Concourse

Parameters:

keys - a collection of field names

record - the record id

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

revert

public void revert(String key,
                   Collection<Long> records,
                   Timestamp timestamp)

Description copied from class: Concourse

Atomically revert key in each of the records to its state at timestamp by creating new revisions that undo the net changes that have occurred since timestamp.

Specified by:

revert in class Concourse

Parameters:

key - the field name

records - a collection of record ids

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

revert

public void revert(String key,
                   long record,
                   Timestamp timestamp)

Description copied from class: Concourse

Atomically revert key in record to its state at timestamp by creating new revisions that undo the net changes that have occurred since timestamp.

Specified by:

revert in class Concourse

Parameters:

key - the field name

record - the record id

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

review

public Map<Timestamp,List<String>> review(long record)

Description copied from class: Concourse

Return a list all the changes ever made to record.

Specified by:

review in class Concourse

Parameters:

record - the record id

Returns:

a Map from the Timestamp of each commit to a list of descriptions for each change made within the commit

review

public Map<Timestamp,List<String>> review(long record,
                                          Timestamp start)

Description copied from class: Concourse

Return a list all the changes made to record since start (inclusive).

Specified by:

review in class Concourse

Parameters:

record - the record id

start - an inclusive Timestamp of the oldest change that should possibly be included in the audit – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a Map from the Timestamp of each commit to a list of descriptions for each change made within the commit

review

public Map<Timestamp,List<String>> review(long record,
                                          Timestamp start,
                                          Timestamp end)

Description copied from class: Concourse

Return a list all the changes made to record between start (inclusive) and end (non-inclusive).

Specified by:

review in class Concourse

Parameters:

record - the record id

start - an inclusive Timestamp for the oldest change that should possibly be included in the audit – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

end - a non-inclusive Timestamp for the most recent change that should possibly be included in the audit – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a Map from the Timestamp of each commit to a list of descriptions for each change made within the commit

review

public Map<Timestamp,List<String>> review(String key,
                                          long record)

Description copied from class: Concourse

Return a list all the changes ever made to the key field in record

Specified by:

review in class Concourse

Parameters:

key - the field name

record - the record id

Returns:

a Map from the Timestamp of each commit to a list of descriptions for each change made within the commit

review

public Map<Timestamp,List<String>> review(String key,
                                          long record,
                                          Timestamp start)

Description copied from class: Concourse

Return a list of all the changes made to the key field in record since start (inclusive).

Specified by:

review in class Concourse

Parameters:

key - the field name

record - the record id

start - an inclusive Timestamp for the oldest change that should possibly be included in the audit – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a Map from the Timestamp of each commit to a list of descriptions for each change made within the commit

review

public Map<Timestamp,List<String>> review(String key,
                                          long record,
                                          Timestamp start,
                                          Timestamp end)

Description copied from class: Concourse

Return a list of all the changes made to the key field in record between start (inclusive) and end (non-inclusive).

Specified by:

review in class Concourse

Parameters:

key - the field name

record - the record id

start - an inclusive Timestamp for the oldest change that should possibly be included in the audit – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

end - a non-inclusive Timestamp for the most recent change that should possibly be included in the audit – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a Map from the Timestamp of each commit to a list of descriptions for each change made within the commit

search

public Set<Long> search(String key,
                        String query)

Description copied from class: Concourse

Perform a full text search for query against the key field and return the records that contain a String or Tag value that matches.

Specified by:

search in class Concourse

Returns:

a Set of ids for records that match the search query

select

public <T> Map<Long,Map<String,Set<T>>> select(Collection<Long> records)

Description copied from class: Concourse

Return all the data that is currently stored in each of the records.

Specified by:

select in class Concourse

Parameters:

records - a collection of record ids

Returns:

a Map associating each of the records to another Map associating every key in that record to a Set containing all the values stored in the respective field

select

public <T> Map<Long,Map<String,Set<T>>> select(Collection<Long> records,
                                               Order order)

Description copied from class: Concourse

Return all the data that is currently stored in each of the records.

Specified by:

select in class Concourse

Parameters:

records - a collection of record ids

order - an Order specification that describes how the result set should be sorted

Returns:

a Map associating each of the records to another Map associating every key in that record to a Set containing all the values stored in the respective field

select

public <T> Map<Long,Map<String,Set<T>>> select(Collection<Long> records,
                                               Order order,
                                               Page page)

Description copied from class: Concourse

Return all the data that is currently stored in each of the records.

Specified by:

select in class Concourse

Parameters:

records - a collection of record ids

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the records to another Map associating every key in that record to a Set containing all the values stored in the respective field

select

public <T> Map<Long,Map<String,Set<T>>> select(Collection<Long> records,
                                               Page page)

Description copied from class: Concourse

Return all the data that is currently stored in each of the records.

Specified by:

select in class Concourse

Parameters:

records - a collection of record ids

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the records to another Map associating every key in that record to a Set containing all the values stored in the respective field

select

public <T> Map<Long,Map<String,Set<T>>> select(Collection<Long> records,
                                               Timestamp timestamp)

Description copied from class: Concourse

Return all the data that was stored in each of the records at timestamp.

Specified by:

select in class Concourse

Parameters:

records - a collection of record ids

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a Map associating each of the records to another Map associating every key in that record at timestamp to a Set containing all the values stored in the respective field at timestamp

select

public <T> Map<Long,Map<String,Set<T>>> select(Collection<Long> records,
                                               Timestamp timestamp,
                                               Order order)

Description copied from class: Concourse

Return all the data that was stored in each of the records at timestamp.

Specified by:

select in class Concourse

Parameters:

records - a collection of record ids

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

Returns:

a Map associating each of the records to another Map associating every key in that record at timestamp to a Set containing all the values stored in the respective field at timestamp

select

public <T> Map<Long,Map<String,Set<T>>> select(Collection<Long> records,
                                               Timestamp timestamp,
                                               Order order,
                                               Page page)

Description copied from class: Concourse

Return all the data that was stored in each of the records at timestamp.

Specified by:

select in class Concourse

Parameters:

records - a collection of record ids

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the records to another Map associating every key in that record at timestamp to a Set containing all the values stored in the respective field at timestamp

select

public <T> Map<Long,Map<String,Set<T>>> select(Collection<Long> records,
                                               Timestamp timestamp,
                                               Page page)

Description copied from class: Concourse

Return all the data that was stored in each of the records at timestamp.

Specified by:

select in class Concourse

Parameters:

records - a collection of record ids

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the records to another Map associating every key in that record at timestamp to a Set containing all the values stored in the respective field at timestamp

select

public <T> Map<Long,Map<String,Set<T>>> select(Collection<String> keys,
                                               Collection<Long> records)

Description copied from class: Concourse

Return all the values stored for each of the keys in each of the records.

Specified by:

select in class Concourse

Parameters:

keys - a collection of field names

records - a collection of record ids

Returns:

a Map associating each of the records to another Map associating each of the keys to a Set containing all the values stored in the respective field

select

public <T> Map<Long,Map<String,Set<T>>> select(Collection<String> keys,
                                               Collection<Long> records,
                                               Order order)

Description copied from class: Concourse

Return all the values stored for each of the keys in each of the records.

Specified by:

select in class Concourse

Parameters:

keys - a collection of field names

records - a collection of record ids

order - an Order specification that describes how the result set should be sorted

Returns:

a Map associating each of the records to another Map associating each of the keys to a Set containing all the values stored in the respective field

select

public <T> Map<Long,Map<String,Set<T>>> select(Collection<String> keys,
                                               Collection<Long> records,
                                               Order order,
                                               Page page)

Description copied from class: Concourse

Return all the values stored for each of the keys in each of the records.

Specified by:

select in class Concourse

Parameters:

keys - a collection of field names

records - a collection of record ids

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the records to another Map associating each of the keys to a Set containing all the values stored in the respective field

select

public <T> Map<Long,Map<String,Set<T>>> select(Collection<String> keys,
                                               Collection<Long> records,
                                               Page page)

Description copied from class: Concourse

Return all the values stored for each of the keys in each of the records.

Specified by:

select in class Concourse

Parameters:

keys - a collection of field names

records - a collection of record ids

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the records to another Map associating each of the keys to a Set containing all the values stored in the respective field

select

public <T> Map<Long,Map<String,Set<T>>> select(Collection<String> keys,
                                               Collection<Long> records,
                                               Timestamp timestamp)

Description copied from class: Concourse

Return all the values stored for each of the keys in each of the records at timestamp.

Specified by:

select in class Concourse

Parameters:

keys - a collection of field names

records - a collection of record ids

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a Map associating each of the records to another Map associating each of the keys to a Set containing all the values stored in the respective field at timestamp

select

public <T> Map<Long,Map<String,Set<T>>> select(Collection<String> keys,
                                               Collection<Long> records,
                                               Timestamp timestamp,
                                               Order order)

Description copied from class: Concourse

Return all the values stored for each of the keys in each of the records at timestamp.

Specified by:

select in class Concourse

Parameters:

keys - a collection of field names

records - a collection of record ids

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

Returns:

a Map associating each of the records to another Map associating each of the keys to a Set containing all the values stored in the respective field at timestamp

select

public <T> Map<Long,Map<String,Set<T>>> select(Collection<String> keys,
                                               Collection<Long> records,
                                               Timestamp timestamp,
                                               Order order,
                                               Page page)

Description copied from class: Concourse

Return all the values stored for each of the keys in each of the records at timestamp.

Specified by:

select in class Concourse

Parameters:

keys - a collection of field names

records - a collection of record ids

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the records to another Map associating each of the keys to a Set containing all the values stored in the respective field at timestamp

select

public <T> Map<Long,Map<String,Set<T>>> select(Collection<String> keys,
                                               Collection<Long> records,
                                               Timestamp timestamp,
                                               Page page)

Description copied from class: Concourse

Return all the values stored for each of the keys in each of the records at timestamp.

Specified by:

select in class Concourse

Parameters:

keys - a collection of field names

records - a collection of record ids

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the records to another Map associating each of the keys to a Set containing all the values stored in the respective field at timestamp

select

public <T> Map<Long,Map<String,Set<T>>> select(Collection<String> keys,
                                               Criteria criteria)

Description copied from class: Concourse

Return all the values stored for each of the keys in every record that matches the criteria.

Specified by:

select in class Concourse

Parameters:

keys - a collection of field names

criteria - a Criteria that contains a well-formed filter for the desired records

Returns:

a Map associating each of the matching records to another Map associating each of the keys in that record to a Set containing all the values stored in the respective field

select

public <T> Map<Long,Map<String,Set<T>>> select(Collection<String> keys,
                                               Criteria criteria,
                                               Order order)

Description copied from class: Concourse

Return all the values stored for each of the keys in every record that matches the criteria.

Specified by:

select in class Concourse

Parameters:

keys - a collection of field names

criteria - a Criteria that contains a well-formed filter for the desired records

order - an Order specification that describes how the result set should be sorted

Returns:

a Map associating each of the matching records to another Map associating each of the keys in that record to a Set containing all the values stored in the respective field

select

public <T> Map<Long,Map<String,Set<T>>> select(Collection<String> keys,
                                               Criteria criteria,
                                               Order order,
                                               Page page)

Description copied from class: Concourse

Return all the values stored for each of the keys in every record that matches the criteria.

Specified by:

select in class Concourse

Parameters:

keys - a collection of field names

criteria - a Criteria that contains a well-formed filter for the desired records

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to another Map associating each of the keys in that record to a Set containing all the values stored in the respective field

select

public <T> Map<Long,Map<String,Set<T>>> select(Collection<String> keys,
                                               Criteria criteria,
                                               Page page)

Description copied from class: Concourse

Return all the values stored for each of the keys in every record that matches the criteria.

Specified by:

select in class Concourse

Parameters:

keys - a collection of field names

criteria - a Criteria that contains a well-formed filter for the desired records

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to another Map associating each of the keys in that record to a Set containing all the values stored in the respective field

select

public <T> Map<Long,Map<String,Set<T>>> select(Collection<String> keys,
                                               Criteria criteria,
                                               Timestamp timestamp)

Description copied from class: Concourse

Return all the values stored for each of the keys at timestamp in every record that matches the criteria

Specified by:

select in class Concourse

Parameters:

keys - a collection of field names

criteria - a Criteria that contains a well-formed filter for the desired records

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a Map associating each of the matching records to another Map associating each of the keys in that record to a Set containing all the values stored in the respective field at timestamp

select

public <T> Map<Long,Map<String,Set<T>>> select(Collection<String> keys,
                                               Criteria criteria,
                                               Timestamp timestamp,
                                               Order order)

Description copied from class: Concourse

Return all the values stored for each of the keys at timestamp in every record that matches the criteria

Specified by:

select in class Concourse

Parameters:

keys - a collection of field names

criteria - a Criteria that contains a well-formed filter for the desired records

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

Returns:

a Map associating each of the matching records to another Map associating each of the keys in that record to a Set containing all the values stored in the respective field at timestamp

select

public <T> Map<Long,Map<String,Set<T>>> select(Collection<String> keys,
                                               Criteria criteria,
                                               Timestamp timestamp,
                                               Order order,
                                               Page page)

Description copied from class: Concourse

Return all the values stored for each of the keys at timestamp in every record that matches the criteria

Specified by:

select in class Concourse

Parameters:

keys - a collection of field names

criteria - a Criteria that contains a well-formed filter for the desired records

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to another Map associating each of the keys in that record to a Set containing all the values stored in the respective field at timestamp

select

public <T> Map<Long,Map<String,Set<T>>> select(Collection<String> keys,
                                               Criteria criteria,
                                               Timestamp timestamp,
                                               Page page)

Description copied from class: Concourse

Return all the values stored for each of the keys at timestamp in every record that matches the criteria

Specified by:

select in class Concourse

Parameters:

keys - a collection of field names

criteria - a Criteria that contains a well-formed filter for the desired records

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to another Map associating each of the keys in that record to a Set containing all the values stored in the respective field at timestamp

select

public <T> Map<String,Set<T>> select(Collection<String> keys,
                                     long record)

Description copied from class: Concourse

Return all the values stored for each of the keys in record.

Specified by:

select in class Concourse

Parameters:

keys - a collection of field names

record - the record id

Returns:

a Map associating each of the keys to a Set containing all the values stored in the respective field

select

public <T> Map<String,Set<T>> select(Collection<String> keys,
                                     long record,
                                     Timestamp timestamp)

Description copied from class: Concourse

Return all the values stored for each of the keys in record at timestamp.

Specified by:

select in class Concourse

Parameters:

keys - a collection of field names

record - the record id

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a Map associating each of the keys to a Set containing all the values stored in the respective field at timestamp

select

public <T> Map<Long,Map<String,Set<T>>> select(Collection<String> keys,
                                               String ccl)

Description copied from class: Concourse

Return all the values stored for each of the keys in every record that matches the ccl filter.

Specified by:

select in class Concourse

Parameters:

keys - a collection of field names

ccl - a well-formed criteria expressed using the Concourse Criteria Language

Returns:

a Map associating each of the matching records to another Map associating each of the keys in that record to a Set containing all the values stored in the respective field

select

public <T> Map<Long,Map<String,Set<T>>> select(Collection<String> keys,
                                               String ccl,
                                               Order order)

Description copied from class: Concourse

Return all the values stored for each of the keys in every record that matches the ccl filter.

Specified by:

select in class Concourse

Parameters:

keys - a collection of field names

ccl - a well-formed criteria expressed using the Concourse Criteria Language

order - an Order specification that describes how the result set should be sorted

Returns:

a Map associating each of the matching records to another Map associating each of the keys in that record to a Set containing all the values stored in the respective field

select

public <T> Map<Long,Map<String,Set<T>>> select(Collection<String> keys,
                                               String ccl,
                                               Order order,
                                               Page page)

Description copied from class: Concourse

Return all the values stored for each of the keys in every record that matches the ccl filter.

Specified by:

select in class Concourse

Parameters:

keys - a collection of field names

ccl - a well-formed criteria expressed using the Concourse Criteria Language

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to another Map associating each of the keys in that record to a Set containing all the values stored in the respective field

select

public <T> Map<Long,Map<String,Set<T>>> select(Collection<String> keys,
                                               String ccl,
                                               Page page)

Description copied from class: Concourse

Return all the values stored for each of the keys in every record that matches the ccl filter.

Specified by:

select in class Concourse

Parameters:

keys - a collection of field names

ccl - a well-formed criteria expressed using the Concourse Criteria Language

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to another Map associating each of the keys in that record to a Set containing all the values stored in the respective field

select

public <T> Map<Long,Map<String,Set<T>>> select(Collection<String> keys,
                                               String ccl,
                                               Timestamp timestamp)

Description copied from class: Concourse

Return all the values stored for each of the keys at timestamp in every record that matches the ccl filter.

Specified by:

select in class Concourse

Parameters:

keys - a collection of field names

ccl - a well-formed criteria expressed using the Concourse Criteria Language

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a Map associating each of the matching records to another Map associating each of the keys in that record to a Set containing all the values stored in the respective field at timestamp

select

public <T> Map<Long,Map<String,Set<T>>> select(Collection<String> keys,
                                               String ccl,
                                               Timestamp timestamp,
                                               Order order)

Description copied from class: Concourse

Return all the values stored for each of the keys at timestamp in every record that matches the ccl filter.

Specified by:

select in class Concourse

Parameters:

keys - a collection of field names

ccl - a well-formed criteria expressed using the Concourse Criteria Language

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

Returns:

a Map associating each of the matching records to another Map associating each of the keys in that record to a Set containing all the values stored in the respective field at timestamp

select

public <T> Map<Long,Map<String,Set<T>>> select(Collection<String> keys,
                                               String ccl,
                                               Timestamp timestamp,
                                               Order order,
                                               Page page)

Description copied from class: Concourse

Return all the data from every record that matches criteria.

Specified by:

select in class Concourse

Parameters:

keys - a collection of field names

ccl - a well-formed criteria expressed using the Concourse Criteria Language

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to another Map associating each of the keys in that record to a Set containing all the values stored in the respective field at timestamp

select

public <T> Map<Long,Map<String,Set<T>>> select(Collection<String> keys,
                                               String ccl,
                                               Timestamp timestamp,
                                               Page page)

Description copied from class: Concourse

Return all the data from every record that matches criteria.

Specified by:

select in class Concourse

Parameters:

keys - a collection of field names

ccl - a well-formed criteria expressed using the Concourse Criteria Language

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to another Map associating each of the keys in that record to a Set containing all the values stored in the respective field at timestamp

select

public <T> Map<Long,Map<String,Set<T>>> select(Criteria criteria)

Description copied from class: Concourse

Return all the data from every record that matches criteria.

Specified by:

select in class Concourse

Parameters:

criteria - a Criteria that contains a well-formed filter for the desired records

Returns:

a Map associating each of the matching records to another Map associating each of the keys in that record to a Set containing all the values stored in the respective field

select

public <T> Map<Long,Map<String,Set<T>>> select(Criteria criteria,
                                               Order order)

Description copied from class: Concourse

Return all the data from every record that matches criteria.

Specified by:

select in class Concourse

Parameters:

criteria - a Criteria that contains a well-formed filter for the desired records

order - an Order specification that describes how the result set should be sorted

Returns:

a Map associating each of the matching records to another Map associating each of the keys in that record to a Set containing all the values stored in the respective field

select

public <T> Map<Long,Map<String,Set<T>>> select(Criteria criteria,
                                               Order order,
                                               Page page)

Description copied from class: Concourse

Return all the data from every record that matches criteria.

Specified by:

select in class Concourse

Parameters:

criteria - a Criteria that contains a well-formed filter for the desired records

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to another Map associating each of the keys in that record to a Set containing all the values stored in the respective field

select

public <T> Map<Long,Map<String,Set<T>>> select(Criteria criteria,
                                               Page page)

Description copied from class: Concourse

Return all the data from every record that matches criteria.

Specified by:

select in class Concourse

Parameters:

criteria - a Criteria that contains a well-formed filter for the desired records

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to another Map associating each of the keys in that record to a Set containing all the values stored in the respective field

select

public <T> Map<Long,Map<String,Set<T>>> select(Criteria criteria,
                                               Timestamp timestamp)

Description copied from class: Concourse

Return all the data at timestamp from every record that matches the criteria.

Specified by:

select in class Concourse

Parameters:

criteria - a Criteria that contains a well-formed filter for the desired records

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a Map associating each of the matching records to another Map associating each of the keys in that record to a Set containing all the values stored in the respective field at timestamp

select

public <T> Map<Long,Map<String,Set<T>>> select(Criteria criteria,
                                               Timestamp timestamp,
                                               Order order)

Description copied from class: Concourse

Return all the data at timestamp from every record that matches the criteria.

Specified by:

select in class Concourse

Parameters:

criteria - a Criteria that contains a well-formed filter for the desired records

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

Returns:

a Map associating each of the matching records to another Map associating each of the keys in that record to a Set containing all the values stored in the respective field at timestamp

select

public <T> Map<Long,Map<String,Set<T>>> select(Criteria criteria,
                                               Timestamp timestamp,
                                               Order order,
                                               Page page)

Description copied from class: Concourse

Return all the data at timestamp from every record that matches the criteria.

Specified by:

select in class Concourse

Parameters:

criteria - a Criteria that contains a well-formed filter for the desired records

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to another Map associating each of the keys in that record to a Set containing all the values stored in the respective field at timestamp

select

public <T> Map<Long,Map<String,Set<T>>> select(Criteria criteria,
                                               Timestamp timestamp,
                                               Page page)

Description copied from class: Concourse

Return all the data at timestamp from every record that matches the criteria.

Specified by:

select in class Concourse

Parameters:

criteria - a Criteria that contains a well-formed filter for the desired records

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to another Map associating each of the keys in that record to a Set containing all the values stored in the respective field at timestamp

select

public <T> Map<String,Set<T>> select(long record)

Description copied from class: Concourse

Return all the data from record.

Specified by:

select in class Concourse

Parameters:

record - the record id

Returns:

a Map associating each key in record to a Set containing all the values stored in the respective field

select

public <T> Map<String,Set<T>> select(long record,
                                     Timestamp timestamp)

Description copied from class: Concourse

Return all the data from record at timestamp.

Specified by:

select in class Concourse

Parameters:

record - the record id

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a Map associating each key in record to a Set containing all the values stored in the respective field at timestamp

select

public <T> Map<Long,Map<String,Set<T>>> select(String ccl)

Description copied from class: Concourse

Return all the data from every record that matches ccl filter.

Specified by:

select in class Concourse

Parameters:

ccl - a well-formed criteria expressed using the Concourse Criteria Language

Returns:

a Map associating each of the matching records to another Map associating each of the keys in that record to a Set containing all the values stored in the respective field

select

public <T> Map<Long,Set<T>> select(String key,
                                   Collection<Long> records)

Description copied from class: Concourse

Return all values stored for key in each of the records.

Specified by:

select in class Concourse

Parameters:

key - the field name

records - a collection of record ids

Returns:

a Map associating each of the records to a Set containing all the values stored in the respective field

select

public <T> Map<Long,Set<T>> select(String key,
                                   Collection<Long> records,
                                   Order order)

Description copied from class: Concourse

Return all values stored for key in each of the records.

Specified by:

select in class Concourse

Parameters:

key - the field name

records - a collection of record ids

order - an Order specification that describes how the result set should be sorted

Returns:

a Map associating each of the records to a Set containing all the values stored in the respective field

select

public <T> Map<Long,Set<T>> select(String key,
                                   Collection<Long> records,
                                   Order order,
                                   Page page)

Description copied from class: Concourse

Return all values stored for key in each of the records.

Specified by:

select in class Concourse

Parameters:

key - the field name

records - a collection of record ids

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the records to a Set containing all the values stored in the respective field

select

public <T> Map<Long,Set<T>> select(String key,
                                   Collection<Long> records,
                                   Page page)

Description copied from class: Concourse

Return all values stored for key in each of the records.

Specified by:

select in class Concourse

Parameters:

key - the field name

records - a collection of record ids

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the records to a Set containing all the values stored in the respective field

select

public <T> Map<Long,Set<T>> select(String key,
                                   Collection<Long> records,
                                   Timestamp timestamp)

Description copied from class: Concourse

Return all values stored for key in each of the records at timestamp.

Specified by:

select in class Concourse

Parameters:

key - the field name

records - a collection of record ids

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a Map associating each of the records to a Set containing all the values stored in the respective field at timestamp

select

public <T> Map<Long,Set<T>> select(String key,
                                   Collection<Long> records,
                                   Timestamp timestamp,
                                   Order order)

Description copied from class: Concourse

Return all values stored for key in each of the records at timestamp.

Specified by:

select in class Concourse

Parameters:

key - the field name

records - a collection of record ids

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

Returns:

a Map associating each of the records to a Set containing all the values stored in the respective field at timestamp

select

public <T> Map<Long,Set<T>> select(String key,
                                   Collection<Long> records,
                                   Timestamp timestamp,
                                   Order order,
                                   Page page)

Description copied from class: Concourse

Return all values stored for key in each of the records at timestamp.

Specified by:

select in class Concourse

Parameters:

key - the field name

records - a collection of record ids

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the records to a Set containing all the values stored in the respective field at timestamp

select

public <T> Map<Long,Set<T>> select(String key,
                                   Collection<Long> records,
                                   Timestamp timestamp,
                                   Page page)

Description copied from class: Concourse

Return all values stored for key in each of the records at timestamp.

Specified by:

select in class Concourse

Parameters:

key - the field name

records - a collection of record ids

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the records to a Set containing all the values stored in the respective field at timestamp

select

public <T> Map<Long,Set<T>> select(String key,
                                   Criteria criteria)

Description copied from class: Concourse

Return all the values stored for key in every record that matches the criteria.

Specified by:

select in class Concourse

Parameters:

key - the field name

criteria - a Criteria that contains a well-formed filter for the desired records

Returns:

a Map associating each of the matching records to a Set containing all the values stored in the respective field

select

public <T> Map<Long,Set<T>> select(String key,
                                   Criteria criteria,
                                   Order order)

Description copied from class: Concourse

Return all the values stored for key in every record that matches the criteria.

Specified by:

select in class Concourse

Parameters:

key - the field name

criteria - a Criteria that contains a well-formed filter for the desired records

order - an Order specification that describes how the result set should be sorted

Returns:

a Map associating each of the matching records to a Set containing all the values stored in the respective field

select

public <T> Map<Long,Set<T>> select(String key,
                                   Criteria criteria,
                                   Order order,
                                   Page page)

Description copied from class: Concourse

Return all the values stored for key in every record that matches the criteria.

Specified by:

select in class Concourse

Parameters:

key - the field name

criteria - a Criteria that contains a well-formed filter for the desired records

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to a Set containing all the values stored in the respective field

select

public <T> Map<Long,Set<T>> select(String key,
                                   Criteria criteria,
                                   Page page)

Description copied from class: Concourse

Return all the values stored for key in every record that matches the criteria.

Specified by:

select in class Concourse

Parameters:

key - the field name

criteria - a Criteria that contains a well-formed filter for the desired records

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to a Set containing all the values stored in the respective field

select

public <T> Map<Long,Set<T>> select(String key,
                                   Criteria criteria,
                                   Timestamp timestamp)

Description copied from class: Concourse

Return all the values stored for key at timestamp in every record that matches the criteria.

Specified by:

select in class Concourse

Parameters:

key - the field name

criteria - a Criteria that contains a well-formed filter for the desired records

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a Map associating each of the matching records to a Set containing all the values stored in the respective field at timestamp

select

public <T> Map<Long,Set<T>> select(String key,
                                   Criteria criteria,
                                   Timestamp timestamp,
                                   Order order)

Description copied from class: Concourse

Return all the values stored for key at timestamp in every record that matches the criteria.

Specified by:

select in class Concourse

Parameters:

key - the field name

criteria - a Criteria that contains a well-formed filter for the desired records

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

Returns:

a Map associating each of the matching records to a Set containing all the values stored in the respective field at timestamp

select

public <T> Map<Long,Set<T>> select(String key,
                                   Criteria criteria,
                                   Timestamp timestamp,
                                   Order order,
                                   Page page)

Description copied from class: Concourse

Return all the values stored for key at timestamp in every record that matches the criteria.

Specified by:

select in class Concourse

Parameters:

key - the field name

criteria - a Criteria that contains a well-formed filter for the desired records

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to a Set containing all the values stored in the respective field at timestamp

select

public <T> Map<Long,Set<T>> select(String key,
                                   Criteria criteria,
                                   Timestamp timestamp,
                                   Page page)

Description copied from class: Concourse

Return all the values stored for key at timestamp in every record that matches the criteria.

Specified by:

select in class Concourse

Parameters:

key - the field name

criteria - a Criteria that contains a well-formed filter for the desired records

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to a Set containing all the values stored in the respective field at timestamp

select

public <T> Set<T> select(String key,
                         long record)

Description copied from class: Concourse

Return all the values stored for key in record.

Specified by:

select in class Concourse

Parameters:

key - the field name

record - the record id

Returns:

a Set containing all the values stored in the field

select

public <T> Set<T> select(String key,
                         long record,
                         Timestamp timestamp)

Description copied from class: Concourse

Return all the values stored for key in record at timestamp.

Specified by:

select in class Concourse

Parameters:

key - the field name

record - the record id

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a Set containing all the values stored in the field at timestamp

select

public <T> Map<Long,Map<String,Set<T>>> select(String ccl,
                                               Order order)

Description copied from class: Concourse

Return all the data from every record that matches ccl filter.

Specified by:

select in class Concourse

Parameters:

ccl - a well-formed criteria expressed using the Concourse Criteria Language

order - an Order specification that describes how the result set should be sorted

Returns:

a Map associating each of the matching records to another Map associating each of the keys in that record to a Set containing all the values stored in the respective field

select

public <T> Map<Long,Map<String,Set<T>>> select(String ccl,
                                               Order order,
                                               Page page)

Description copied from class: Concourse

Return all the data from every record that matches ccl filter.

Specified by:

select in class Concourse

Parameters:

ccl - a well-formed criteria expressed using the Concourse Criteria Language

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to another Map associating each of the keys in that record to a Set containing all the values stored in the respective field

select

public <T> Map<Long,Map<String,Set<T>>> select(String ccl,
                                               Page page)

Description copied from class: Concourse

Return all the data from every record that matches ccl filter.

Specified by:

select in class Concourse

Parameters:

ccl - a well-formed criteria expressed using the Concourse Criteria Language

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to another Map associating each of the keys in that record to a Set containing all the values stored in the respective field

select

public <T> Map<Long,Set<T>> select(String key,
                                   String ccl)

Description copied from class: Concourse

Return all the values stored for key in every record that matches the ccl filter.

Specified by:

select in class Concourse

Parameters:

key - the field name

ccl - a well-formed criteria expressed using the Concourse Criteria Language

Returns:

a Map associating each of the the matching records to a Set containing all the values stored in the respective field

select

public <T> Map<Long,Set<T>> select(String key,
                                   String ccl,
                                   Order order)

Description copied from class: Concourse

Return all the values stored for key in every record that matches the ccl filter.

Specified by:

select in class Concourse

Parameters:

key - the field name

ccl - a well-formed criteria expressed using the Concourse Criteria Language

order - an Order specification that describes how the result set should be sorted

Returns:

a Map associating each of the the matching records to a Set containing all the values stored in the respective field

select

public <T> Map<Long,Set<T>> select(String key,
                                   String ccl,
                                   Order order,
                                   Page page)

Description copied from class: Concourse

Return all the values stored for key in every record that matches the ccl filter.

Specified by:

select in class Concourse

Parameters:

key - the field name

ccl - a well-formed criteria expressed using the Concourse Criteria Language

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the the matching records to a Set containing all the values stored in the respective field

select

public <T> Map<Long,Set<T>> select(String key,
                                   String ccl,
                                   Page page)

Description copied from class: Concourse

Return all the values stored for key in every record that matches the ccl filter.

Specified by:

select in class Concourse

Parameters:

key - the field name

ccl - a well-formed criteria expressed using the Concourse Criteria Language

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the the matching records to a Set containing all the values stored in the respective field

select

public <T> Map<Long,Set<T>> select(String key,
                                   String ccl,
                                   Timestamp timestamp)

Description copied from class: Concourse

Return all the values stored for key at timestamp in every record that matches the ccl filter.

Specified by:

select in class Concourse

Parameters:

key - the field name

ccl - a well-formed criteria expressed using the Concourse Criteria Language

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a Map associating each of the matching records to a Set containing all the values stored in the respective field at timestamp

select

public <T> Map<Long,Set<T>> select(String key,
                                   String ccl,
                                   Timestamp timestamp,
                                   Order order)

Description copied from class: Concourse

Return all the values stored for key at timestamp in every record that matches the ccl filter.

Specified by:

select in class Concourse

Parameters:

key - the field name

ccl - a well-formed criteria expressed using the Concourse Criteria Language

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

Returns:

a Map associating each of the matching records to a Set containing all the values stored in the respective field at timestamp

select

public <T> Map<Long,Set<T>> select(String key,
                                   String ccl,
                                   Timestamp timestamp,
                                   Order order,
                                   Page page)

Description copied from class: Concourse

Return all the values stored for key at timestamp in every record that matches the ccl filter.

Specified by:

select in class Concourse

Parameters:

key - the field name

ccl - a well-formed criteria expressed using the Concourse Criteria Language

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to a Set containing all the values stored in the respective field at timestamp

select

public <T> Map<Long,Set<T>> select(String key,
                                   String ccl,
                                   Timestamp timestamp,
                                   Page page)

Description copied from class: Concourse

Return all the values stored for key at timestamp in every record that matches the ccl filter.

Specified by:

select in class Concourse

Parameters:

key - the field name

ccl - a well-formed criteria expressed using the Concourse Criteria Language

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to a Set containing all the values stored in the respective field at timestamp

select

public <T> Map<Long,Map<String,Set<T>>> select(String ccl,
                                               Timestamp timestamp)

Description copied from class: Concourse

Return all the data at timestamp from every record that matches the ccl filter.

Specified by:

select in class Concourse

Parameters:

ccl - a well-formed criteria expressed using the Concourse Criteria Language

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

a Map associating each of the matching records to another Map associating each of the keys in that record to a Set containing all the values stored in the respective field at timestamp

select

public <T> Map<Long,Map<String,Set<T>>> select(String ccl,
                                               Timestamp timestamp,
                                               Order order)

Description copied from class: Concourse

Return all the data at timestamp from every record that matches the ccl filter.

Specified by:

select in class Concourse

Parameters:

ccl - a well-formed criteria expressed using the Concourse Criteria Language

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

Returns:

a Map associating each of the matching records to another Map associating each of the keys in that record to a Set containing all the values stored in the respective field at timestamp

select

public <T> Map<Long,Map<String,Set<T>>> select(String ccl,
                                               Timestamp timestamp,
                                               Order order,
                                               Page page)

Description copied from class: Concourse

Return all the data at timestamp from every record that matches the ccl filter.

Specified by:

select in class Concourse

Parameters:

ccl - a well-formed criteria expressed using the Concourse Criteria Language

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

order - an Order specification that describes how the result set should be sorted

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to another Map associating each of the keys in that record to a Set containing all the values stored in the respective field at timestamp

select

public <T> Map<Long,Map<String,Set<T>>> select(String ccl,
                                               Timestamp timestamp,
                                               Page page)

Description copied from class: Concourse

Return all the data at timestamp from every record that matches the ccl filter.

Specified by:

select in class Concourse

Parameters:

ccl - a well-formed criteria expressed using the Concourse Criteria Language

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

page - a {@link Page) specification that describes the page of the result set to return

Returns:

a Map associating each of the matching records to another Map associating each of the keys in that record to a Set containing all the values stored in the respective field at timestamp

set

public void set(String key,
                Object value,
                Collection<Long> records)

Description copied from class: Concourse

In each of the records, atomically remove all the values stored for key and then add key as value in the respective record.

Specified by:

set in class Concourse

Parameters:

key - the field name

value - the value to set

records - a collection of record ids

set

public <T> void set(String key,
                    T value,
                    long record)

Description copied from class: Concourse

Atomically remove all the values stored for key in record and add then key as value.

Specified by:

set in class Concourse

Parameters:

key - the field name

value - the value to set

record - the record id

stage

public void stage()
           throws TransactionException

Description copied from class: Concourse

Start a new transaction.

This method will turn on STAGING mode so that all subsequent changes are collected in an isolated buffer before possibly being committed to the database. Staged operations are guaranteed to be reliable, all or nothing units of work that allow correct recovery from failures and provide isolation between clients so the database is always in a consistent state.

After this method returns, all subsequent operations will be done in staging mode until either Concourse.abort() or Concourse.commit() is invoked.

All operations that occur within a transaction should be wrapped in a try-catch block so that transaction exceptions can be caught and the transaction can be properly aborted.

 concourse.stage();
 try {
     concourse.get("foo", 1);
     concourse.add("foo", "bar", 1);
     concourse.commit();
 }
 catch (TransactionException e) {
     concourse.abort();
 }
 

Specified by:

stage in class Concourse

Throws:

TransactionException

time

public Timestamp time()

Description copied from class: Concourse

Return a Timestamp that represents the current instant according to the server.

Specified by:

time in class Concourse

Returns:

the current time

time

public Timestamp time(String phrase)

Description copied from class: Concourse

Return the Timestamp, according to the server, that corresponds to the instant described by the phrase.

Specified by:

time in class Concourse

Parameters:

phrase - a natural language description of a point in time.

Returns:

the Timestamp that represents the desired instant

trace

public Map<Long,Map<String,Set<Long>>> trace(Collection<Long> records)

Description copied from class: Concourse

Locate and return all the incoming links to each of the records.

The data is returned as a mapping each of the records to another mapping from a key to all the records where that key was stored as a Link.to(long) the record at timestamp.

Specified by:

trace in class Concourse

Returns:

a mapping from key to all the records where the key is stored as a Link to the record

trace

public Map<Long,Map<String,Set<Long>>> trace(Collection<Long> records,
                                             Timestamp timestamp)

Description copied from class: Concourse

Locate and return all the incoming links to each of the records.

The data is returned as a mapping each of the records to another mapping from a key to all the records where that key was stored as a Link.to(long) the record at timestamp.

Specified by:

trace in class Concourse

Returns:

a mapping from key to all the records where the key is stored as a Link to the record at timestamp

trace

public Map<String,Set<Long>> trace(long record)

Description copied from class: Concourse

Locate and return all the incoming links to record.

The data is returned as a mapping from a key to all the records where that key is stored as a Link.to(long) the record.

Specified by:

trace in class Concourse

Returns:

a mapping from key to all the records where the key is stored as a Link to the record

trace

public Map<String,Set<Long>> trace(long record,
                                   Timestamp timestamp)

Description copied from class: Concourse

Locate and return all the incoming links to record at timestamp.

The data is returned as a mapping from a key to all the records where that key was stored as a Link.to(long) the record at timestamp.

Specified by:

trace in class Concourse

Returns:

a mapping from key to all the records where the key is stored as a Link to the record at timestamp

unlink

public boolean unlink(String key,
                      long destination,
                      long source)

Description copied from class: Concourse

If it exists, remove the link from key in source to destination.

Specified by:

unlink in class Concourse

Parameters:

key - the field name

destination - the id of the record where the link points

source - the id of the record where the link originates

Returns:

true if the link is removed

verify

public boolean verify(String key,
                      Object value,
                      long record)

Description copied from class: Concourse

Return true if value is stored for key in record.

Specified by:

verify in class Concourse

Parameters:

key - the field name

value - the value to check

record - the record id

Returns:

true if value is stored in the field, otherwise false

verify

public boolean verify(String key,
                      Object value,
                      long record,
                      Timestamp timestamp)

Description copied from class: Concourse

Return true if value was stored for key in record at timestamp.

Specified by:

verify in class Concourse

Parameters:

key - the field name

value - the value to check

record - the record id

timestamp - a Timestamp that represents the historical instant to use in the lookup – created from either a natural language description of a point in time (i.e. two weeks ago), OR the number of microseconds since the Unix epoch, OR a Joda DateTime object

Returns:

true if value is stored in the field, otherwise false

verifyAndSwap

public boolean verifyAndSwap(String key,
                             Object expected,
                             long record,
                             Object replacement)

Description copied from class: Concourse

Atomically replace expected with replacement for key in record if and only if expected is currently stored in the field.

Specified by:

verifyAndSwap in class Concourse

Parameters:

key - the field name

expected - the value expected to currently exist in the field

record - the record id

replacement - the value with which to replace expected if and only if it currently exists in the field

Returns:

true if the swap is successful

verifyOrSet

public void verifyOrSet(String key,
                        Object value,
                        long record)

Description copied from class: Concourse

Atomically verify that key equals expected in record or set it as such.

Please note that after returning, this method guarantees that key in record will only contain value, even if value already existed alongside other values [e.g. calling verifyOrSet("foo", "bar", 1) will mean that "foo" in 1 only has "bar" as a value after returning, even if "foo" in 1 already had "bar", "baz", and "apple" as values].

So, basically, this function has the same guarantee as the Concourse.set(String, Object, long) method, except it will not create any new revisions unless it is necessary to do so. The set method, on the other hand, would indiscriminately clear all the values for key in record before adding value, even if value already existed.

If you want to add a new value only if it does not exist while also preserving other values, you should use the Concourse.add(String, Object, long) method instead.

Specified by:

verifyOrSet in class Concourse

Parameters:

key - the field name

value - the value to check

record - the record id

$this

protected abstract ForwardingConcourse $this(Concourse concourse)

Construct an instance of this ForwardingConcourse using the provided concourse connection as the proxied handle.

Parameters:

concourse -

Returns:

an instace of this class

copyConnection

protected final Concourse copyConnection()

Description copied from class: Concourse

Return a new Concourse connection that is connected to the same deployment with the same credentials as this connection.

Specified by:

copyConnection in class Concourse

Returns:

a copy of this connection handle