Package 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	Description
CompletableFuture<TimeSeries.QueryResult<V>>	selectFrom(String topicPath)	Evaluate this query for a time series topic.

Method Details

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.