Class ForwardingResultSet (6.62.0)

public class ForwardingResultSet extends ForwardingStructReader implements ProtobufResultSet

Forwarding implementation of ResultSet that forwards all calls to a delegate.

Inheritance

java.lang.Object > ForwardingStructReader > ForwardingResultSet

Implements

ProtobufResultSet

Constructors

ForwardingResultSet(ResultSet delegate)

public ForwardingResultSet(ResultSet delegate)
Parameter
NameDescription
delegateResultSet

ForwardingResultSet(Supplier<ResultSet> supplier)

public ForwardingResultSet(Supplier<ResultSet> supplier)
Parameter
NameDescription
suppliercom.google.common.base.Supplier<ResultSet>

Methods

canGetProtobufValue(int columnIndex)

public boolean canGetProtobufValue(int columnIndex)

Returns true if the protobuf value for the given column is still available.

Parameter
NameDescription
columnIndexint
Returns
TypeDescription
boolean

close()

public void close()

Explicitly close the result set, releasing any associated resources. This must always be called when disposing of a ResultSet before #next() has returned false or raised an exception. Calling close() is also allowed if the result set has been fully consumed, so a recommended practice is to unconditionally close the result set once it is done with, typically using a try-with-resources construct.

getCurrentRowAsStruct()

public Struct getCurrentRowAsStruct()

Creates an immutable version of the row that the result set is positioned over. This may involve copying internal data structures, and so converting all rows to Struct objects is generally more expensive than processing the ResultSet directly.

Returns
TypeDescription
Struct

getMetadata()

public ResultSetMetadata getMetadata()

Returns the ResultSetMetadata for this ResultSet. This is method may only be called after calling ResultSet#next() at least once.

Returns
TypeDescription
ResultSetMetadata

getProtobufValue(int columnIndex)

public Value getProtobufValue(int columnIndex)

Returns the column value as a protobuf value.

This is an internal method not intended for external usage.

This method may only be called before the column value has been decoded to a plain Java object. This means that the DecodeMode that is used for the ResultSet must be one of DecodeMode#LAZY_PER_ROW and DecodeMode#LAZY_PER_COL, and that the corresponding ResultSet#getValue(int), ResultSet#getBoolean(int), ... method may not yet have been called for the column.

Parameter
NameDescription
columnIndexint
Returns
TypeDescription
Value

getStats()

public ResultSetStats getStats()

Returns the ResultSetStats for the query only if the query was executed in either the PLAN or the PROFILE mode via the ReadContext#analyzeQuery(Statement, com.google.cloud.spanner.ReadContext.QueryAnalyzeMode) method or for DML statements in ReadContext#executeQuery(Statement, QueryOption...). Attempts to call this method on a ResultSet not obtained from analyzeQuery or executeQuery will return a null ResultSetStats. This method must be called after #next() has returned @{code false}. Calling it before that will result in null ResultSetStats too.

Returns
TypeDescription
ResultSetStats

next()

public boolean next()

Advances the result set to the next row, returning false if no such row exists. This method may block.

Returns
TypeDescription
boolean
Exceptions
TypeDescription
SpannerException