public abstract class StructuredQuery<V> extends Query<V>
An implementation of a Google Cloud Datastore Query that can be constructed by providing all the specific query elements.
A usage example:
A simple query that returns all entities for a specific kind
Query<Entity> query = Query.newEntityQueryBuilder().setKind(kind).build();
QueryResults<Entity> results = datastore.run(query);
while (results.hasNext()) {
Entity entity = results.next();
...
}
A simple key-only query of all entities for a specific kind
Query<Key> keyOnlyQuery = Query.newKeyQueryBuilder().setKind(KIND1).build();
QueryResults<Key> results = datastore.run(keyOnlyQuery);
...
A less trivial example of a projection query that returns the first 10 results of "age" and "name" properties (sorted and grouped by "age") with an age greater than 18
Query<ProjectionEntity> query = Query.newProjectionEntityQueryBuilder()
.setKind(kind)
.setProjection(Projection.property("age"), Projection.first("name"))
.setFilter(PropertyFilter.gt("age", 18))
.setGroupBy("age")
.setOrderBy(OrderBy.asc("age"))
.setLimit(10)
.build();
QueryResults<ProjectionEntity> results = datastore.run(query);
...
See Also: Datastore queries
Type Parameter
Name | Description |
V |
Methods
equals(Object obj)
public boolean equals(Object obj)
Name | Description |
obj | Object |
Type | Description |
boolean |
getDistinctOn()
public List<String> getDistinctOn()
Returns the distinct on clause for this query.
Type | Description |
List<String> |
getEndCursor()
public Cursor getEndCursor()
Returns the end cursor for this query.
Type | Description |
Cursor |
getFilter()
public StructuredQuery.Filter getFilter()
Returns the filter for this query.
Type | Description |
StructuredQuery.Filter |
getKind()
public String getKind()
Returns the kind for this query.
Type | Description |
String |
getLimit()
public Integer getLimit()
Returns the limit for this query.
Type | Description |
Integer |
getOffset()
public int getOffset()
Returns the offset for this query.
Type | Description |
int |
getOrderBy()
public List<StructuredQuery.OrderBy> getOrderBy()
Returns the order by clause for this query.
Type | Description |
List<OrderBy> |
getProjection()
public List<String> getProjection()
Returns the projection for this query.
Type | Description |
List<String> |
getStartCursor()
public Cursor getStartCursor()
Returns the start cursor for this query.
Type | Description |
Cursor |
hashCode()
public int hashCode()
Type | Description |
int |
toBuilder()
public abstract StructuredQuery.Builder<V> toBuilder()
Type | Description |
Builder<V> |
toString()
public String toString()
Type | Description |
String |