Package com.datastax.dse.driver.api.core.cql.reactive

Interface ReactiveResultSet

All Superinterfaces:

org.reactivestreams.Publisher<ReactiveRow>, ReactiveQueryMetadata

All Known Subinterfaces:

ContinuousReactiveResultSet

public interface ReactiveResultSet
extends org.reactivestreams.Publisher<ReactiveRow>, ReactiveQueryMetadata

A Publisher of ReactiveRows returned by a ReactiveSession.

By default, all implementations returned by the driver are cold, unicast, single-subscriber only publishers. In other words, they do not support multiple subscriptions; consider caching the results produced by such publishers if you need to consume them by more than one downstream subscriber.

Also, note that reactive result sets may emit items to their subscribers on an internal driver IO thread. Subscriber implementors are encouraged to abide by Reactive Streams Specification rule 2.2 and avoid performing heavy computations or blocking calls inside onNext calls, as doing so could slow down the driver and impact performance. Instead, they should asynchronously dispatch received signals to their processing logic.

This interface exists mainly to expose useful information about request execution and query metadata. This is particularly convenient for queries that do not return rows; for queries that do return rows, it is also possible, and oftentimes easier, to access that same information at row level.

See Also:

ReactiveSession.executeReactive(String), ReactiveSession.executeReactive(Statement), ReactiveRow

Method Summary

Methods inherited from interface org.reactivestreams.Publisher

subscribe

Methods inherited from interface com.datastax.dse.driver.api.core.cql.reactive.ReactiveQueryMetadata

getColumnDefinitions, getExecutionInfos, wasApplied