Recupero dei risultati delle query

Dopo aver creato una query, puoi specificare una serie di opzioni di recupero per controllare ulteriormente i risultati restituiti. Per ulteriori informazioni sulla strutturazione delle query per la tua app, consulta la sezione Query Datastore.

Recupero di una singola entità

Per recuperare una sola entità corrispondente alla query, utilizza il metodo PreparedQuery.asSingleEntity():

Query q =
    new Query("Person")
        .setFilter(new FilterPredicate("lastName", FilterOperator.EQUAL, targetLastName));

PreparedQuery pq = datastore.prepare(q);
Entity result = pq.asSingleEntity();

Restituisce il primo risultato trovato nell'indice che corrisponde alla query. Se è presente più di un risultato corrispondente, viene generato un TooManyResultsException.

Iterazione tra i risultati delle query

Quando esegui l'iterazione dei risultati di una query utilizzando i metodi PreparedQuery.asIterable() e PreparedQuery.asIterator(), Cloud Datastore recupera i risultati in batch. Per impostazione predefinita, ogni batch contiene 20 risultati, ma puoi modificare questo valore utilizzando FetchOptions.chunkSize(). Puoi continuare a scorrere i risultati della query finché non vengono restituiti tutti o la richiesta non scade.

Recupero delle proprietà selezionate da un'entità

Per recuperare solo le proprietà selezionate di un'entità anziché l'intera entità, utilizza una query di proiezione. Questo tipo di query viene eseguito più rapidamente e costa meno di una che restituisce entità complete.

Allo stesso modo, una query basata solo su chiavi consente di risparmiare tempo e risorse restituendo solo le chiavi delle entità corrispondenti, anziché le entità complete. Per creare questo tipo di query, utilizza il metodo Query.setKeysOnly():

Query q = new Query("Person").setKeysOnly();

Impostare un limite per la query

Puoi specificare un limite per la query per controllare il numero massimo di risultati restituiti in un batch. L'esempio seguente recupera le cinque persone più alte da Cloud Datastore:

private List<Entity> getTallestPeople() {
  DatastoreService datastore = DatastoreServiceFactory.getDatastoreService();

  Query q = new Query("Person").addSort("height", SortDirection.DESCENDING);

  PreparedQuery pq = datastore.prepare(q);
  return pq.asList(FetchOptions.Builder.withLimit(5));
}

Passaggi successivi