com.couchbase.client.java.query

Class DefaultAsyncQueryResult

java.lang.Object

com.couchbase.client.java.query.DefaultAsyncQueryResult

All Implemented Interfaces:

AsyncQueryResult

@InterfaceStability.Uncommitted
 @InterfaceAudience.Public
public class DefaultAsyncQueryResult
extends Object
implements AsyncQueryResult

The default implementation of an AsyncQueryResult.

Constructor Summary

Constructors

Constructor and Description
DefaultAsyncQueryResult(Observable<AsyncQueryRow> rows, Observable<Object> signature, Observable<JsonObject> info, Observable<JsonObject> errors, Observable<Boolean> finalSuccess, boolean parsingSuccess, String requestId, String clientContextId)

Method Summary

Modifier and Type	Method and Description
String	clientContextId()
Observable<JsonObject>	errors()
Observable<Boolean>	finalSuccess() Asynchronously denotes the success or failure of the query.
Observable<QueryMetrics>	info()
boolean	parseSuccess() Immediately denotes initial parsing success of the query.
String	requestId()
Observable<AsyncQueryRow>	rows()
Observable<Object>	signature()

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultAsyncQueryResult

public DefaultAsyncQueryResult(Observable<AsyncQueryRow> rows,
                               Observable<Object> signature,
                               Observable<JsonObject> info,
                               Observable<JsonObject> errors,
                               Observable<Boolean> finalSuccess,
                               boolean parsingSuccess,
                               String requestId,
                               String clientContextId)

Method Detail

rows

public Observable<AsyncQueryRow> rows()

Specified by:

rows in interface AsyncQueryResult

Returns:

an async stream of each row resulting from the query (empty if fatal errors occurred).

signature

public Observable<Object> signature()

Specified by:

signature in interface AsyncQueryResult

Returns:

an async single-item representing the signature of the results, that can be used to learn about the common structure of each row. This signature is usually a JsonObject, but could also be any JSON-valid type like a boolean scalar, JsonArray…

info

public Observable<QueryMetrics> info()

Specified by:

info in interface AsyncQueryResult

Returns:

an async single item describing some metrics/info about the execution of the query.

finalSuccess

public Observable<Boolean> finalSuccess()

Description copied from interface: AsyncQueryResult

Asynchronously denotes the success or failure of the query. It could fail slower than with AsyncQueryResult.parseSuccess(), for example if a fatal error comes up while streaming the results to the client. Receiving a (single) value for finalSuccess means the query is over.

Specified by:

finalSuccess in interface AsyncQueryResult

parseSuccess

public boolean parseSuccess()

Description copied from interface: AsyncQueryResult

Immediately denotes initial parsing success of the query.

As rows are processed, it could be that a late failure occurs. See AsyncQueryResult.finalSuccess() for the end of processing status.

Specified by:

parseSuccess in interface AsyncQueryResult

Returns:

true if the query could be parsed, false if it short-circuited due to syntax/fatal error.

errors

public Observable<JsonObject> errors()

Specified by:

errors in interface AsyncQueryResult

Returns:

an async stream of errors or warnings encountered while executing the query.

requestId

public String requestId()

Specified by:

requestId in interface AsyncQueryResult

Returns:

the requestId generated by the server

clientContextId

public String clientContextId()

Specified by:

clientContextId in interface AsyncQueryResult

Returns:

the clientContextId that was set by the client (could be truncated to 64 bytes of UTF-8 chars)