GqlQuery (Google Cloud Datastore Parent 2.16.0 API)

java.lang.Object
- com.google.protobuf.AbstractMessageLite
- - com.google.protobuf.AbstractMessage
  - - com.google.protobuf.GeneratedMessageV3
    - - com.google.datastore.v1.GqlQuery

All Implemented Interfaces:

GqlQueryOrBuilder, com.google.protobuf.Message, com.google.protobuf.MessageLite, com.google.protobuf.MessageLiteOrBuilder, com.google.protobuf.MessageOrBuilder, Serializable
```
public final class GqlQuery
extends com.google.protobuf.GeneratedMessageV3
implements GqlQueryOrBuilder
```
```
 A [GQL
 query](https://cloud.google.com/datastore/docs/apis/gql/gql_reference).
 
```
Protobuf type google.datastore.v1.GqlQuery
See Also:

Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class GqlQuery.Builder
A [GQL query](https://cloud.google.com/datastore/docs/apis/gql/gql_reference).
- Nested classes/interfaces inherited from class com.google.protobuf.GeneratedMessageV3
  com.google.protobuf.GeneratedMessageV3.BuilderParent, com.google.protobuf.GeneratedMessageV3.ExtendableBuilder<MessageT extends com.google.protobuf.GeneratedMessageV3.ExtendableMessage<MessageT>,BuilderT extends com.google.protobuf.GeneratedMessageV3.ExtendableBuilder<MessageT,BuilderT>>, com.google.protobuf.GeneratedMessageV3.ExtendableMessage<MessageT extends com.google.protobuf.GeneratedMessageV3.ExtendableMessage<MessageT>>, com.google.protobuf.GeneratedMessageV3.ExtendableMessageOrBuilder<MessageT extends com.google.protobuf.GeneratedMessageV3.ExtendableMessage<MessageT>>, com.google.protobuf.GeneratedMessageV3.FieldAccessorTable, com.google.protobuf.GeneratedMessageV3.UnusedPrivateParameter
- Nested classes/interfaces inherited from class com.google.protobuf.AbstractMessageLite
  com.google.protobuf.AbstractMessageLite.InternalOneOfEnum

Nested Classes
Modifier and Type	Class and Description
`static class`	`GqlQuery.Builder` A [GQL query](https://cloud.google.com/datastore/docs/apis/gql/gql_reference).

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`ALLOW_LITERALS_FIELD_NUMBER`
`static int`	`NAMED_BINDINGS_FIELD_NUMBER`
`static int`	`POSITIONAL_BINDINGS_FIELD_NUMBER`
`static int`	`QUERY_STRING_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

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`boolean`	`containsNamedBindings(String key)` For each non-reserved named binding site in the query string, there must be a named parameter with that name, but not necessarily the inverse.
`boolean`	`equals(Object obj)`
`boolean`	`getAllowLiterals()` When false, the query string must not contain any literals and instead must bind all values.
`static GqlQuery`	`getDefaultInstance()`
`GqlQuery`	`getDefaultInstanceForType()`
`static com.google.protobuf.Descriptors.Descriptor`	`getDescriptor()`
`Map<String,GqlQueryParameter>`	`getNamedBindings()` Deprecated.
`int`	`getNamedBindingsCount()` For each non-reserved named binding site in the query string, there must be a named parameter with that name, but not necessarily the inverse.
`Map<String,GqlQueryParameter>`	`getNamedBindingsMap()` For each non-reserved named binding site in the query string, there must be a named parameter with that name, but not necessarily the inverse.
`GqlQueryParameter`	`getNamedBindingsOrDefault(String key, GqlQueryParameter defaultValue)` For each non-reserved named binding site in the query string, there must be a named parameter with that name, but not necessarily the inverse.
`GqlQueryParameter`	`getNamedBindingsOrThrow(String key)` For each non-reserved named binding site in the query string, there must be a named parameter with that name, but not necessarily the inverse.
`com.google.protobuf.Parser<GqlQuery>`	`getParserForType()`
`GqlQueryParameter`	`getPositionalBindings(int index)` Numbered binding site @1 references the first numbered parameter, effectively using 1-based indexing, rather than the usual 0.
`int`	`getPositionalBindingsCount()` Numbered binding site @1 references the first numbered parameter, effectively using 1-based indexing, rather than the usual 0.
`List<GqlQueryParameter>`	`getPositionalBindingsList()` Numbered binding site @1 references the first numbered parameter, effectively using 1-based indexing, rather than the usual 0.
`GqlQueryParameterOrBuilder`	`getPositionalBindingsOrBuilder(int index)` Numbered binding site @1 references the first numbered parameter, effectively using 1-based indexing, rather than the usual 0.
`List<? extends GqlQueryParameterOrBuilder>`	`getPositionalBindingsOrBuilderList()` Numbered binding site @1 references the first numbered parameter, effectively using 1-based indexing, rather than the usual 0.
`String`	`getQueryString()` A string of the format described [here](https://cloud.google.com/datastore/docs/apis/gql/gql_reference).
`com.google.protobuf.ByteString`	`getQueryStringBytes()` A string of the format described [here](https://cloud.google.com/datastore/docs/apis/gql/gql_reference).
`int`	`getSerializedSize()`
`int`	`hashCode()`
`protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable`	`internalGetFieldAccessorTable()`
`protected com.google.protobuf.MapField`	`internalGetMapField(int number)`
`boolean`	`isInitialized()`
`static GqlQuery.Builder`	`newBuilder()`
`static GqlQuery.Builder`	`newBuilder(GqlQuery prototype)`
`GqlQuery.Builder`	`newBuilderForType()`
`protected GqlQuery.Builder`	`newBuilderForType(com.google.protobuf.GeneratedMessageV3.BuilderParent parent)`
`protected Object`	`newInstance(com.google.protobuf.GeneratedMessageV3.UnusedPrivateParameter unused)`
`static GqlQuery`	`parseDelimitedFrom(InputStream input)`
`static GqlQuery`	`parseDelimitedFrom(InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)`
`static GqlQuery`	`parseFrom(byte[] data)`
`static GqlQuery`	`parseFrom(byte[] data, com.google.protobuf.ExtensionRegistryLite extensionRegistry)`
`static GqlQuery`	`parseFrom(ByteBuffer data)`
`static GqlQuery`	`parseFrom(ByteBuffer data, com.google.protobuf.ExtensionRegistryLite extensionRegistry)`
`static GqlQuery`	`parseFrom(com.google.protobuf.ByteString data)`
`static GqlQuery`	`parseFrom(com.google.protobuf.ByteString data, com.google.protobuf.ExtensionRegistryLite extensionRegistry)`
`static GqlQuery`	`parseFrom(com.google.protobuf.CodedInputStream input)`
`static GqlQuery`	`parseFrom(com.google.protobuf.CodedInputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)`
`static GqlQuery`	`parseFrom(InputStream input)`
`static GqlQuery`	`parseFrom(InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)`
`static com.google.protobuf.Parser<GqlQuery>`	`parser()`
`GqlQuery.Builder`	`toBuilder()`
`void`	`writeTo(com.google.protobuf.CodedOutputStream output)`

Methods inherited from class com.google.protobuf.GeneratedMessageV3
canUseUnsafe, computeStringSize, computeStringSizeNoTag, emptyBooleanList, emptyDoubleList, emptyFloatList, emptyIntList, emptyLongList, getAllFields, getDescriptorForType, getField, getOneofFieldDescriptor, getRepeatedField, getRepeatedFieldCount, getUnknownFields, hasField, hasOneof, isStringEmpty, makeExtensionsImmutable, makeMutableCopy, mergeFromAndMakeImmutableInternal, mutableCopy, mutableCopy, mutableCopy, mutableCopy, mutableCopy, newBooleanList, newBuilderForType, newDoubleList, newFloatList, newIntList, newLongList, parseDelimitedWithIOException, parseDelimitedWithIOException, parseUnknownField, parseUnknownFieldProto3, parseWithIOException, parseWithIOException, parseWithIOException, parseWithIOException, serializeBooleanMapTo, serializeIntegerMapTo, serializeLongMapTo, serializeStringMapTo, 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, 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, getUnknownFields, hasField, hasOneof

Methods inherited from interface com.google.protobuf.MessageLite
toByteArray, toByteString, writeDelimitedTo, writeTo

Field Detail
- QUERY_STRING_FIELD_NUMBER
```
public static final int QUERY_STRING_FIELD_NUMBER
```
  See Also:
  
  Constant Field Values
- ALLOW_LITERALS_FIELD_NUMBER
```
public static final int ALLOW_LITERALS_FIELD_NUMBER
```
  See Also:
  
  Constant Field Values
- NAMED_BINDINGS_FIELD_NUMBER
```
public static final int NAMED_BINDINGS_FIELD_NUMBER
```
  See Also:
  
  Constant Field Values
- POSITIONAL_BINDINGS_FIELD_NUMBER
```
public static final int POSITIONAL_BINDINGS_FIELD_NUMBER
```
  See Also:
  
  Constant Field Values

Method Detail

newInstance

protected Object newInstance(com.google.protobuf.GeneratedMessageV3.UnusedPrivateParameter unused)

Overrides:: newInstance in class com.google.protobuf.GeneratedMessageV3

getDescriptor

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

internalGetMapField
```
protected com.google.protobuf.MapField internalGetMapField(int number)
```
Overrides:

internalGetMapField in class com.google.protobuf.GeneratedMessageV3

internalGetFieldAccessorTable
```
protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
```
Specified by:

internalGetFieldAccessorTable in class com.google.protobuf.GeneratedMessageV3

getQueryString

public String getQueryString()

 A string of the format described
 [here](https://cloud.google.com/datastore/docs/apis/gql/gql_reference).

string query_string = 1;

Specified by:: getQueryString in interface GqlQueryOrBuilder
Returns:: The queryString.

getQueryStringBytes

public com.google.protobuf.ByteString getQueryStringBytes()

 A string of the format described
 [here](https://cloud.google.com/datastore/docs/apis/gql/gql_reference).

string query_string = 1;

Specified by:: getQueryStringBytes in interface GqlQueryOrBuilder
Returns:: The bytes for queryString.

getAllowLiterals

public boolean getAllowLiterals()

 When false, the query string must not contain any literals and instead must
 bind all values. For example,
 `SELECT * FROM Kind WHERE a = 'string literal'` is not allowed, while
 `SELECT * FROM Kind WHERE a = @value` is.

bool allow_literals = 2;

Specified by:: getAllowLiterals in interface GqlQueryOrBuilder
Returns:: The allowLiterals.

getNamedBindingsCount

public int getNamedBindingsCount()

Description copied from interface: GqlQueryOrBuilder

 For each non-reserved named binding site in the query string, there must be
 a named parameter with that name, but not necessarily the inverse.

 Key must match regex `[A-Za-z_$][A-Za-z_$0-9]*`, must not match regex
 `__.*__`, and must not be `""`.

map<string, .google.datastore.v1.GqlQueryParameter> named_bindings = 5;

Specified by:: getNamedBindingsCount in interface GqlQueryOrBuilder

containsNamedBindings

public boolean containsNamedBindings(String key)

 For each non-reserved named binding site in the query string, there must be
 a named parameter with that name, but not necessarily the inverse.

 Key must match regex `[A-Za-z_$][A-Za-z_$0-9]*`, must not match regex
 `__.*__`, and must not be `""`.

map<string, .google.datastore.v1.GqlQueryParameter> named_bindings = 5;

Specified by:: containsNamedBindings in interface GqlQueryOrBuilder

getNamedBindings
```
@Deprecated
public Map<String,GqlQueryParameter> getNamedBindings()
```
Deprecated.

Use getNamedBindingsMap() instead.

Specified by:

getNamedBindings in interface GqlQueryOrBuilder

getNamedBindingsMap

public Map<String,GqlQueryParameter> getNamedBindingsMap()

 For each non-reserved named binding site in the query string, there must be
 a named parameter with that name, but not necessarily the inverse.

 Key must match regex `[A-Za-z_$][A-Za-z_$0-9]*`, must not match regex
 `__.*__`, and must not be `""`.

map<string, .google.datastore.v1.GqlQueryParameter> named_bindings = 5;

Specified by:: getNamedBindingsMap in interface GqlQueryOrBuilder

getNamedBindingsOrDefault

public GqlQueryParameter getNamedBindingsOrDefault(String key,
                                                   GqlQueryParameter defaultValue)

 For each non-reserved named binding site in the query string, there must be
 a named parameter with that name, but not necessarily the inverse.

 Key must match regex `[A-Za-z_$][A-Za-z_$0-9]*`, must not match regex
 `__.*__`, and must not be `""`.

map<string, .google.datastore.v1.GqlQueryParameter> named_bindings = 5;

Specified by:: getNamedBindingsOrDefault in interface GqlQueryOrBuilder

getNamedBindingsOrThrow

public GqlQueryParameter getNamedBindingsOrThrow(String key)

 For each non-reserved named binding site in the query string, there must be
 a named parameter with that name, but not necessarily the inverse.

 Key must match regex `[A-Za-z_$][A-Za-z_$0-9]*`, must not match regex
 `__.*__`, and must not be `""`.

map<string, .google.datastore.v1.GqlQueryParameter> named_bindings = 5;

Specified by:: getNamedBindingsOrThrow in interface GqlQueryOrBuilder