com.pushtechnology.diffusion.client.features

Interface TimeSeries.Query<V>

Type Parameters:

V - query value type

All Known Subinterfaces:

TimeSeries.RangeQuery<V>

Enclosing interface:

TimeSeries

public static interface TimeSeries.Query<V>

A configured query.

A default query that performs a value range query of an entire time series can be obtained using TimeSeries.rangeQuery() and further configured using methods of the TimeSeries.RangeQuery interface.

Method Summary

Modifier and Type	Method and Description
CompletableFuture<TimeSeries.QueryResult<V>>	selectFrom(String topicPath) Evaluate this query for a time series topic.

Method Detail

selectFrom

CompletableFuture<TimeSeries.QueryResult<V>> selectFrom(String topicPath)

Evaluate this query for a time series topic.

The session must have the READ_TOPIC topic permission for topicPath to evaluate a query. The QUERY_OBSOLETE_TIME_SERIES_EVENTS topic permission is also required if this is an edit range query, or a value range query with an edit range.

Parameters:

topicPath - the path of the time series topic to query

Returns:

a CompletableFuture that completes when a response is received from the server.

If the query returned results, the CompletableFuture will complete successfully and provide an TimeSeries.QueryResult.

Otherwise, the CompletableFuture will complete exceptionally with a CompletionException. Common reasons for failure, listed by the exception reported as the cause, include:

• NoSuchTopicException – if there is no topic bound to topicPath;
• IncompatibleTopicException – if the topic bound to topicPath is not a time series topic;
• IncompatibleTopicException – if the query value type is incompatible with the event data type of the time series topic bound to topicPath;
• TimeSeries.InvalidQueryException – if the range query is not valid for the time series;
• PermissionsException – if the calling session does not have READ_TOPIC permission for topicPath;
• PermissionsException – if the calling session does not have QUERY_OBSOLETE_TIME_SERIES_EVENTS permission for topicPath and this is an edit range query, or a value range query with an edit range;
• SessionClosedException – if the session is closed.