com.google.spanner.v1

Class ReadRequest

java.lang.Object

com.google.protobuf.AbstractMessageLite

com.google.protobuf.AbstractMessage

com.google.protobuf.GeneratedMessageV3

com.google.spanner.v1.ReadRequest

All Implemented Interfaces:

com.google.protobuf.Message, com.google.protobuf.MessageLite, com.google.protobuf.MessageLiteOrBuilder, com.google.protobuf.MessageOrBuilder, ReadRequestOrBuilder, java.io.Serializable

public final class ReadRequest
extends com.google.protobuf.GeneratedMessageV3
implements ReadRequestOrBuilder

 The request for [Read][google.spanner.v1.Spanner.Read] and
 [StreamingRead][google.spanner.v1.Spanner.StreamingRead].
 

Protobuf type google.spanner.v1.ReadRequest

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ReadRequest.Builder The request for [Read][google.spanner.v1.Spanner.Read] and [StreamingRead][google.spanner.v1.Spanner.StreamingRead].

Nested classes/interfaces inherited from class com.google.protobuf.GeneratedMessageV3

com.google.protobuf.GeneratedMessageV3.BuilderParent, com.google.protobuf.GeneratedMessageV3.ExtendableBuilder<MessageType extends com.google.protobuf.GeneratedMessageV3.ExtendableMessage,BuilderType extends com.google.protobuf.GeneratedMessageV3.ExtendableBuilder<MessageType,BuilderType>>, com.google.protobuf.GeneratedMessageV3.ExtendableMessage<MessageType extends com.google.protobuf.GeneratedMessageV3.ExtendableMessage>, com.google.protobuf.GeneratedMessageV3.ExtendableMessageOrBuilder<MessageType extends com.google.protobuf.GeneratedMessageV3.ExtendableMessage>, com.google.protobuf.GeneratedMessageV3.FieldAccessorTable

Field Summary

Fields

Modifier and Type	Field and Description
static int	COLUMNS_FIELD_NUMBER
static int	INDEX_FIELD_NUMBER
static int	KEY_SET_FIELD_NUMBER
static int	LIMIT_FIELD_NUMBER
static int	RESUME_TOKEN_FIELD_NUMBER
static int	SESSION_FIELD_NUMBER
static int	TABLE_FIELD_NUMBER
static int	TRANSACTION_FIELD_NUMBER

Fields inherited from class com.google.protobuf.GeneratedMessageV3

alwaysUseFieldBuilders, unknownFields

Fields inherited from class com.google.protobuf.AbstractMessage

memoizedSize

Fields inherited from class com.google.protobuf.AbstractMessageLite

memoizedHashCode

Method Summary

Modifier and Type	Method and Description
boolean	equals(java.lang.Object obj)
java.lang.String	getColumns(int index) The columns of [table][google.spanner.v1.ReadRequest.table] to be returned for each row matching this request.
com.google.protobuf.ByteString	getColumnsBytes(int index) The columns of [table][google.spanner.v1.ReadRequest.table] to be returned for each row matching this request.
int	getColumnsCount() The columns of [table][google.spanner.v1.ReadRequest.table] to be returned for each row matching this request.
com.google.protobuf.ProtocolStringList	getColumnsList() The columns of [table][google.spanner.v1.ReadRequest.table] to be returned for each row matching this request.
static ReadRequest	getDefaultInstance()
ReadRequest	getDefaultInstanceForType()
static com.google.protobuf.Descriptors.Descriptor	getDescriptor()
java.lang.String	getIndex() If non-empty, the name of an index on [table][google.spanner.v1.ReadRequest.table].
com.google.protobuf.ByteString	getIndexBytes() If non-empty, the name of an index on [table][google.spanner.v1.ReadRequest.table].
KeySet	getKeySet() Required.
KeySetOrBuilder	getKeySetOrBuilder() Required.
long	getLimit() If greater than zero, only the first `limit` rows are yielded.
com.google.protobuf.Parser<ReadRequest>	getParserForType()
com.google.protobuf.ByteString	getResumeToken() If this request is resuming a previously interrupted read, `resume_token` should be copied from the last [PartialResultSet][google.spanner.v1.PartialResultSet] yielded before the interruption.
int	getSerializedSize()
java.lang.String	getSession() Required.
com.google.protobuf.ByteString	getSessionBytes() Required.
java.lang.String	getTable() Required.
com.google.protobuf.ByteString	getTableBytes() Required.
TransactionSelector	getTransaction() The transaction to use.
TransactionSelectorOrBuilder	getTransactionOrBuilder() The transaction to use.
com.google.protobuf.UnknownFieldSet	getUnknownFields()
int	hashCode()
boolean	hasKeySet() Required.
boolean	hasTransaction() The transaction to use.
protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable	internalGetFieldAccessorTable()
boolean	isInitialized()
static ReadRequest.Builder	newBuilder()
static ReadRequest.Builder	newBuilder(ReadRequest prototype)
ReadRequest.Builder	newBuilderForType()
protected ReadRequest.Builder	newBuilderForType(com.google.protobuf.GeneratedMessageV3.BuilderParent parent)
static ReadRequest	parseDelimitedFrom(java.io.InputStream input)
static ReadRequest	parseDelimitedFrom(java.io.InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
static ReadRequest	parseFrom(byte[] data)
static ReadRequest	parseFrom(byte[] data, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
static ReadRequest	parseFrom(com.google.protobuf.ByteString data)
static ReadRequest	parseFrom(com.google.protobuf.ByteString data, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
static ReadRequest	parseFrom(com.google.protobuf.CodedInputStream input)
static ReadRequest	parseFrom(com.google.protobuf.CodedInputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
static ReadRequest	parseFrom(java.io.InputStream input)
static ReadRequest	parseFrom(java.io.InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
static com.google.protobuf.Parser<ReadRequest>	parser()
ReadRequest.Builder	toBuilder()
void	writeTo(com.google.protobuf.CodedOutputStream output)

Methods inherited from class com.google.protobuf.GeneratedMessageV3

computeStringSize, computeStringSizeNoTag, getAllFields, getDescriptorForType, getField, getOneofFieldDescriptor, getRepeatedField, getRepeatedFieldCount, hasField, hasOneof, internalGetMapField, makeExtensionsImmutable, newBuilderForType, parseDelimitedWithIOException, parseDelimitedWithIOException, parseUnknownField, parseWithIOException, parseWithIOException, parseWithIOException, parseWithIOException, writeReplace, writeString, writeStringNoTag

Methods inherited from class com.google.protobuf.AbstractMessage

findInitializationErrors, getInitializationErrorString, hashBoolean, hashEnum, hashEnumList, hashFields, hashLong, toString

Methods inherited from class com.google.protobuf.AbstractMessageLite

addAll, checkByteStringIsUtf8, toByteArray, toByteString, writeDelimitedTo, writeTo

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.google.protobuf.MessageOrBuilder

findInitializationErrors, getAllFields, getDescriptorForType, getField, getInitializationErrorString, getOneofFieldDescriptor, getRepeatedField, getRepeatedFieldCount, hasField, hasOneof

Methods inherited from interface com.google.protobuf.MessageLite

toByteArray, toByteString, writeDelimitedTo, writeTo

Field Detail

SESSION_FIELD_NUMBER

public static final int SESSION_FIELD_NUMBER

See Also:

Constant Field Values

TRANSACTION_FIELD_NUMBER

public static final int TRANSACTION_FIELD_NUMBER

See Also:

Constant Field Values

TABLE_FIELD_NUMBER

public static final int TABLE_FIELD_NUMBER

See Also:

Constant Field Values

INDEX_FIELD_NUMBER

public static final int INDEX_FIELD_NUMBER

See Also:

Constant Field Values

COLUMNS_FIELD_NUMBER

public static final int COLUMNS_FIELD_NUMBER

See Also:

Constant Field Values

KEY_SET_FIELD_NUMBER

public static final int KEY_SET_FIELD_NUMBER

See Also:

Constant Field Values

LIMIT_FIELD_NUMBER

public static final int LIMIT_FIELD_NUMBER

See Also:

Constant Field Values

RESUME_TOKEN_FIELD_NUMBER

public static final int RESUME_TOKEN_FIELD_NUMBER

See Also:

Constant Field Values

Method Detail

getUnknownFields

public final com.google.protobuf.UnknownFieldSet getUnknownFields()

Specified by:

getUnknownFields in interface com.google.protobuf.MessageOrBuilder

Overrides:

getUnknownFields in class com.google.protobuf.GeneratedMessageV3

getDescriptor

public static final com.google.protobuf.Descriptors.Descriptor getDescriptor()

internalGetFieldAccessorTable

protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()

Specified by:

internalGetFieldAccessorTable in class com.google.protobuf.GeneratedMessageV3

getSession

public java.lang.String getSession()

 Required. The session in which the read should be performed.
 

optional string session = 1;

Specified by:

getSession in interface ReadRequestOrBuilder

getSessionBytes

public com.google.protobuf.ByteString getSessionBytes()

 Required. The session in which the read should be performed.
 

optional string session = 1;

Specified by:

getSessionBytes in interface ReadRequestOrBuilder

hasTransaction

public boolean hasTransaction()

 The transaction to use. If none is provided, the default is a
 temporary read-only transaction with strong concurrency.
 

optional .google.spanner.v1.TransactionSelector transaction = 2;

Specified by:

hasTransaction in interface ReadRequestOrBuilder

getTransaction

public TransactionSelector getTransaction()

 The transaction to use. If none is provided, the default is a
 temporary read-only transaction with strong concurrency.
 

optional .google.spanner.v1.TransactionSelector transaction = 2;

Specified by:

getTransaction in interface ReadRequestOrBuilder

getTransactionOrBuilder

public TransactionSelectorOrBuilder getTransactionOrBuilder()

 The transaction to use. If none is provided, the default is a
 temporary read-only transaction with strong concurrency.
 

optional .google.spanner.v1.TransactionSelector transaction = 2;

Specified by:

getTransactionOrBuilder in interface ReadRequestOrBuilder

getTable

public java.lang.String getTable()

 Required. The name of the table in the database to be read.
 

optional string table = 3;

Specified by:

getTable in interface ReadRequestOrBuilder

getTableBytes

public com.google.protobuf.ByteString getTableBytes()

 Required. The name of the table in the database to be read.
 

optional string table = 3;

Specified by:

getTableBytes in interface ReadRequestOrBuilder

getIndex

public java.lang.String getIndex()

 If non-empty, the name of an index on [table][google.spanner.v1.ReadRequest.table]. This index is
 used instead of the table primary key when interpreting [key_set][google.spanner.v1.ReadRequest.key_set]
 and sorting result rows. See [key_set][google.spanner.v1.ReadRequest.key_set] for further information.
 

optional string index = 4;

Specified by:

getIndex in interface ReadRequestOrBuilder

getIndexBytes

public com.google.protobuf.ByteString getIndexBytes()

 If non-empty, the name of an index on [table][google.spanner.v1.ReadRequest.table]. This index is
 used instead of the table primary key when interpreting [key_set][google.spanner.v1.ReadRequest.key_set]
 and sorting result rows. See [key_set][google.spanner.v1.ReadRequest.key_set] for further information.
 

optional string index = 4;

Specified by:

getIndexBytes in interface ReadRequestOrBuilder

getColumnsList

public com.google.protobuf.ProtocolStringList getColumnsList()

 The columns of [table][google.spanner.v1.ReadRequest.table] to be returned for each row matching
 this request.
 

repeated string columns = 5;

Specified by:

getColumnsList in interface ReadRequestOrBuilder

getColumnsCount

public int getColumnsCount()

 The columns of [table][google.spanner.v1.ReadRequest.table] to be returned for each row matching
 this request.
 

repeated string columns = 5;

Specified by:

getColumnsCount in interface ReadRequestOrBuilder

getColumns

public java.lang.String getColumns(int index)

 The columns of [table][google.spanner.v1.ReadRequest.table] to be returned for each row matching
 this request.
 

repeated string columns = 5;

Specified by:

getColumns in interface ReadRequestOrBuilder

getColumnsBytes

public com.google.protobuf.ByteString getColumnsBytes(int index)

 The columns of [table][google.spanner.v1.ReadRequest.table] to be returned for each row matching
 this request.
 

repeated string columns = 5;

Specified by:

getColumnsBytes in interface ReadRequestOrBuilder

hasKeySet

public boolean hasKeySet()

 Required. `key_set` identifies the rows to be yielded. `key_set` names the
 primary keys of the rows in [table][google.spanner.v1.ReadRequest.table] to be yielded, unless [index][google.spanner.v1.ReadRequest.index]
 is present. If [index][google.spanner.v1.ReadRequest.index] is present, then [key_set][google.spanner.v1.ReadRequest.key_set] instead names
 index keys in [index][google.spanner.v1.ReadRequest.index].
 Rows are yielded in table primary key order (if [index][google.spanner.v1.ReadRequest.index] is empty)
 or index key order (if [index][google.spanner.v1.ReadRequest.index] is non-empty).
 It is not an error for the `key_set` to name rows that do not
 exist in the database. Read yields nothing for nonexistent rows.
 

optional .google.spanner.v1.KeySet key_set = 6;

Specified by:

hasKeySet in interface ReadRequestOrBuilder

getKeySet

public KeySet getKeySet()

 Required. `key_set` identifies the rows to be yielded. `key_set` names the
 primary keys of the rows in [table][google.spanner.v1.ReadRequest.table] to be yielded, unless [index][google.spanner.v1.ReadRequest.index]
 is present. If [index][google.spanner.v1.ReadRequest.index] is present, then [key_set][google.spanner.v1.ReadRequest.key_set] instead names
 index keys in [index][google.spanner.v1.ReadRequest.index].
 Rows are yielded in table primary key order (if [index][google.spanner.v1.ReadRequest.index] is empty)
 or index key order (if [index][google.spanner.v1.ReadRequest.index] is non-empty).
 It is not an error for the `key_set` to name rows that do not
 exist in the database. Read yields nothing for nonexistent rows.
 

optional .google.spanner.v1.KeySet key_set = 6;

Specified by:

getKeySet in interface ReadRequestOrBuilder

getKeySetOrBuilder

public KeySetOrBuilder getKeySetOrBuilder()

 Required. `key_set` identifies the rows to be yielded. `key_set` names the
 primary keys of the rows in [table][google.spanner.v1.ReadRequest.table] to be yielded, unless [index][google.spanner.v1.ReadRequest.index]
 is present. If [index][google.spanner.v1.ReadRequest.index] is present, then [key_set][google.spanner.v1.ReadRequest.key_set] instead names
 index keys in [index][google.spanner.v1.ReadRequest.index].
 Rows are yielded in table primary key order (if [index][google.spanner.v1.ReadRequest.index] is empty)
 or index key order (if [index][google.spanner.v1.ReadRequest.index] is non-empty).
 It is not an error for the `key_set` to name rows that do not
 exist in the database. Read yields nothing for nonexistent rows.
 

optional .google.spanner.v1.KeySet key_set = 6;

Specified by:

getKeySetOrBuilder in interface ReadRequestOrBuilder

getLimit

public long getLimit()

 If greater than zero, only the first `limit` rows are yielded. If `limit`
 is zero, the default is no limit.
 

optional int64 limit = 8;

Specified by:

getLimit in interface ReadRequestOrBuilder

getResumeToken

public com.google.protobuf.ByteString getResumeToken()

 If this request is resuming a previously interrupted read,
 `resume_token` should be copied from the last
 [PartialResultSet][google.spanner.v1.PartialResultSet] yielded before the interruption. Doing this
 enables the new read to resume where the last read left off. The
 rest of the request parameters must exactly match the request
 that yielded this token.
 

optional bytes resume_token = 9;

Specified by:

getResumeToken in interface ReadRequestOrBuilder

isInitialized

public final boolean isInitialized()

Specified by:

isInitialized in interface com.google.protobuf.MessageLiteOrBuilder

Overrides:

isInitialized in class com.google.protobuf.GeneratedMessageV3

writeTo

public void writeTo(com.google.protobuf.CodedOutputStream output)
             throws java.io.IOException

Specified by:

writeTo in interface com.google.protobuf.MessageLite

Overrides:

writeTo in class com.google.protobuf.GeneratedMessageV3

Throws:

java.io.IOException

getSerializedSize

public int getSerializedSize()

Specified by:

getSerializedSize in interface com.google.protobuf.MessageLite

Overrides:

getSerializedSize in class com.google.protobuf.GeneratedMessageV3

equals

public boolean equals(java.lang.Object obj)

Specified by:

equals in interface com.google.protobuf.Message

Overrides:

equals in class com.google.protobuf.AbstractMessage

hashCode

public int hashCode()

Specified by:

hashCode in interface com.google.protobuf.Message

Overrides:

hashCode in class com.google.protobuf.AbstractMessage

parseFrom

public static ReadRequest parseFrom(com.google.protobuf.ByteString data)
                             throws com.google.protobuf.InvalidProtocolBufferException

Throws:

com.google.protobuf.InvalidProtocolBufferException

parseFrom

public static ReadRequest parseFrom(com.google.protobuf.ByteString data,
                                    com.google.protobuf.ExtensionRegistryLite extensionRegistry)
                             throws com.google.protobuf.InvalidProtocolBufferException

Throws:

com.google.protobuf.InvalidProtocolBufferException

parseFrom

public static ReadRequest parseFrom(byte[] data)
                             throws com.google.protobuf.InvalidProtocolBufferException

Throws:

com.google.protobuf.InvalidProtocolBufferException

parseFrom

public static ReadRequest parseFrom(byte[] data,
                                    com.google.protobuf.ExtensionRegistryLite extensionRegistry)
                             throws com.google.protobuf.InvalidProtocolBufferException

Throws:

com.google.protobuf.InvalidProtocolBufferException

parseFrom

public static ReadRequest parseFrom(java.io.InputStream input)
                             throws java.io.IOException

Throws:

java.io.IOException

parseFrom

public static ReadRequest parseFrom(java.io.InputStream input,
                                    com.google.protobuf.ExtensionRegistryLite extensionRegistry)
                             throws java.io.IOException

Throws:

java.io.IOException

parseDelimitedFrom

public static ReadRequest parseDelimitedFrom(java.io.InputStream input)
                                      throws java.io.IOException

Throws:

java.io.IOException

parseDelimitedFrom

public static ReadRequest parseDelimitedFrom(java.io.InputStream input,
                                             com.google.protobuf.ExtensionRegistryLite extensionRegistry)
                                      throws java.io.IOException

Throws:

java.io.IOException

parseFrom

public static ReadRequest parseFrom(com.google.protobuf.CodedInputStream input)
                             throws java.io.IOException

Throws:

java.io.IOException

parseFrom

public static ReadRequest parseFrom(com.google.protobuf.CodedInputStream input,
                                    com.google.protobuf.ExtensionRegistryLite extensionRegistry)
                             throws java.io.IOException

Throws:

java.io.IOException

newBuilderForType

public ReadRequest.Builder newBuilderForType()

Specified by:

newBuilderForType in interface com.google.protobuf.Message

Specified by:

newBuilderForType in interface com.google.protobuf.MessageLite

newBuilder

public static ReadRequest.Builder newBuilder()

newBuilder

public static ReadRequest.Builder newBuilder(ReadRequest prototype)

toBuilder

public ReadRequest.Builder toBuilder()

Specified by:

toBuilder in interface com.google.protobuf.Message

Specified by:

toBuilder in interface com.google.protobuf.MessageLite

newBuilderForType

protected ReadRequest.Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.BuilderParent parent)

Specified by:

newBuilderForType in class com.google.protobuf.GeneratedMessageV3

getDefaultInstance

public static ReadRequest getDefaultInstance()

parser

public static com.google.protobuf.Parser<ReadRequest> parser()

getParserForType

public com.google.protobuf.Parser<ReadRequest> getParserForType()

Specified by:

getParserForType in interface com.google.protobuf.Message

Specified by:

getParserForType in interface com.google.protobuf.MessageLite

Overrides:

getParserForType in class com.google.protobuf.GeneratedMessageV3

getDefaultInstanceForType

public ReadRequest getDefaultInstanceForType()

Specified by:

getDefaultInstanceForType in interface com.google.protobuf.MessageLiteOrBuilder

Specified by:

getDefaultInstanceForType in interface com.google.protobuf.MessageOrBuilder