public final class GqlQuery<V> extends Query<V> implements RecordQuery<V>
A Google Cloud Datastore GQL query.
A usage example:
When the type of the results is known the preferred usage would be:
Query<Entity> query =
Query.newGqlQueryBuilder(Query.ResultType.ENTITY, "select * from kind").build();
QueryResults<Entity> results = datastore.run(query);
while (results.hasNext()) {
Entity entity = results.next();
...
}
When the type of the results is unknown you can use this approach:
Query query = Query.newGqlQueryBuilder("select __key__ from kind").build();
QueryResults results = datastore.run(query);
if (Key.class.isAssignableFrom(results.getResultClass())) {
QueryResults<Key> keys = (QueryResults<Key>) results;
while (keys.hasNext()) {
Key key = keys.next();
...
}
}
See Also: GQL Reference
Implements
RecordQuery<V>Inherited Members
Type Parameter |
|
---|---|
Name | Description |
V |
Methods
allowLiteral()
public boolean allowLiteral()
Returns whether the query string can contain literals. When false
, the query string
must not contain any literals and instead must bind all values.
Returns | |
---|---|
Type | Description |
boolean |
equals(Object obj)
public boolean equals(Object obj)
Parameter | |
---|---|
Name | Description |
obj |
Object |
Returns | |
---|---|
Type | Description |
boolean |
getNamedBindings()
public Map<String,Object> getNamedBindings()
Returns an immutable map of named bindings.
getNamedBindingsMap()
public Map<String,GqlQuery.Binding> getNamedBindingsMap()
getNumberArgs()
public List<Object> getNumberArgs()
Returns an immutable list of positional bindings (using original order).
getPositionalBindingsMap()
public List<GqlQuery.Binding> getPositionalBindingsMap()
Returns | |
---|---|
Type | Description |
List<com.google.cloud.datastore.GqlQuery.Binding> |
getQueryString()
public String getQueryString()
Returns the query string for this query.
Returns | |
---|---|
Type | Description |
String |
getType()
public Query.ResultType<V> getType()
Returns | |
---|---|
Type | Description |
ResultType<V> |
hashCode()
public int hashCode()
Returns | |
---|---|
Type | Description |
int |
nextQuery(RunQueryResponse responsePb)
public RecordQuery<V> nextQuery(RunQueryResponse responsePb)
Parameter | |
---|---|
Name | Description |
responsePb |
RunQueryResponse |
Returns | |
---|---|
Type | Description |
RecordQuery<V> |
populatePb(RunQueryRequest.Builder requestPb)
public void populatePb(RunQueryRequest.Builder requestPb)
Parameter | |
---|---|
Name | Description |
requestPb |
RunQueryRequest.Builder |
toString()
public String toString()
Returns | |
---|---|
Type | Description |
String |