com.couchbase.client.java.query

Class DefaultQueryResult

java.lang.Object

com.couchbase.client.java.query.DefaultQueryResult

All Implemented Interfaces:

QueryResult, Iterable<QueryRow>

public class DefaultQueryResult
extends Object
implements QueryResult

Constructor Summary

Constructors

Constructor and Description
DefaultQueryResult(List<AsyncQueryRow> rows, Object signature, QueryMetrics info, List<JsonObject> errors, Boolean finalSuccess, boolean parseSuccess, String requestId, String clientContextId) Create a default blocking representation of a query result.

Method Summary

Modifier and Type	Method and Description
List<QueryRow>	allRows()
String	clientContextId()
List<JsonObject>	errors()
boolean	finalSuccess() Denotes the success or failure of the query.
QueryMetrics	info()
Iterator<QueryRow>	iterator()
boolean	parseSuccess()
String	requestId()
Iterator<QueryRow>	rows()
Object	signature()

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

DefaultQueryResult

public DefaultQueryResult(List<AsyncQueryRow> rows,
                          Object signature,
                          QueryMetrics info,
                          List<JsonObject> errors,
                          Boolean finalSuccess,
                          boolean parseSuccess,
                          String requestId,
                          String clientContextId)

Create a default blocking representation of a query result.

Parameters:

rows - the list of rows.

signature - the signature for rows.

info - the metrics.

errors - the list of errors and warnings.

finalSuccess - the definitive (but potentially delayed) result of the query.

parseSuccess - the intermediate result of the query

Method Detail

allRows

public List<QueryRow> allRows()

Specified by:

allRows in interface QueryResult

Returns:

the list of all QueryRow, the results of the query, if successful.

rows

public Iterator<QueryRow> rows()

Specified by:

rows in interface QueryResult

Returns:

an iterator over the list of all QueryRow, the results of the query, if successful.

signature

public Object signature()

Specified by:

signature in interface QueryResult

Returns:

an object 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 QueryMetrics info()

Specified by:

info in interface QueryResult

Returns:

an object describing some metrics/info about the execution of the query.

parseSuccess

public boolean parseSuccess()

Specified by:

parseSuccess in interface QueryResult

Returns:

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

errors

public List<JsonObject> errors()

Specified by:

errors in interface QueryResult

Returns:

A list of errors or warnings encountered while executing the query.

finalSuccess

public boolean finalSuccess()

Description copied from interface: QueryResult

Denotes the success or failure of the query. It could fail slower than with QueryResult.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 QueryResult

iterator

public Iterator<QueryRow> iterator()

Specified by:

iterator in interface Iterable<QueryRow>

requestId

public String requestId()

Specified by:

requestId in interface QueryResult

Returns:

the requestId generated by the server

clientContextId

public String clientContextId()

Specified by:

clientContextId in interface QueryResult

Returns:

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