import com.google.appengine.api.datastore.Query.CompositeFilterOperator; //导入依赖的package包/类
@Override
public void doGet(HttpServletRequest req, HttpServletResponse resp)
    throws IOException, ServletException {
  // [START exploding_index_example_1]
  Query q =
      new Query("Widget")
          .setFilter(
              CompositeFilterOperator.and(
                  new FilterPredicate("x", FilterOperator.EQUAL, 1),
                  new FilterPredicate("y", FilterOperator.EQUAL, 2)))
          .addSort("date", Query.SortDirection.ASCENDING);
  // [END exploding_index_example_1]
  List<Entity> results = datastore.prepare(q).asList(FetchOptions.Builder.withDefaults());

  PrintWriter out = resp.getWriter();
  out.printf("Got %d widgets.\n", results.size());
}
 

import com.google.appengine.api.datastore.Query.CompositeFilterOperator; //导入依赖的package包/类
void printPropertyRange(DatastoreService ds, PrintWriter writer) {

    // Start with unrestricted keys-only property query
    Query q = new Query(Entities.PROPERTY_METADATA_KIND).setKeysOnly();

    // Limit range
    q.setFilter(
        CompositeFilterOperator.and(
            new FilterPredicate(
                Entity.KEY_RESERVED_PROPERTY,
                Query.FilterOperator.GREATER_THAN_OR_EQUAL,
                Entities.createPropertyKey("Employee", "salary")),
            new FilterPredicate(
                Entity.KEY_RESERVED_PROPERTY,
                Query.FilterOperator.LESS_THAN_OR_EQUAL,
                Entities.createPropertyKey("Manager", "salary"))));
    q.addSort(Entity.KEY_RESERVED_PROPERTY, SortDirection.ASCENDING);

    // Print query results
    for (Entity e : ds.prepare(q).asIterable()) {
      writer.println(e.getKey().getParent().getName() + ": " + e.getKey().getName());
    }
  }
 

import com.google.appengine.api.datastore.Query.CompositeFilterOperator; //导入依赖的package包/类
@Test
public void queryRestrictions_compositeFilter_isInvalid() throws Exception {
  long minBirthYear = 1940;
  long maxHeight = 200;
  // [START inequality_filters_one_property_invalid_example]
  Filter birthYearMinFilter =
      new FilterPredicate("birthYear", FilterOperator.GREATER_THAN_OR_EQUAL, minBirthYear);

  Filter heightMaxFilter =
      new FilterPredicate("height", FilterOperator.LESS_THAN_OR_EQUAL, maxHeight);

  Filter invalidFilter = CompositeFilterOperator.and(birthYearMinFilter, heightMaxFilter);

  Query q = new Query("Person").setFilter(invalidFilter);
  // [END inequality_filters_one_property_invalid_example]

  // Note: The local devserver behavior is different than the production
  // version of Cloud Datastore, so there aren't any assertions we can make
  // in this test.  The query appears to work with the local test runner,
  // but will fail in production.
}
 

import com.google.appengine.api.datastore.Query.CompositeFilterOperator; //导入依赖的package包/类
@Test
public void queryRestrictions_surprisingMultipleValuesAllMustMatch_returnsNoEntities()
    throws Exception {
  Entity a = new Entity("Widget", "a");
  List<Long> xs = Arrays.asList(1L, 2L);
  a.setProperty("x", xs);
  datastore.put(a);

  // [START surprising_behavior_example_1]
  Query q =
      new Query("Widget")
          .setFilter(
              CompositeFilterOperator.and(
                  new FilterPredicate("x", FilterOperator.GREATER_THAN, 1),
                  new FilterPredicate("x", FilterOperator.LESS_THAN, 2)));
  // [END surprising_behavior_example_1]

  // Entity "a" will not match because no individual value matches all filters.
  // See the documentation for more details:
  // https://cloud.google.com/appengine/docs/java/datastore/query-restrictions#properties_with_multiple_values_can_behave_in_surprising_ways
  List<Entity> results =
      datastore.prepare(q.setKeysOnly()).asList(FetchOptions.Builder.withDefaults());
  assertThat(results).named("query results").isEmpty();
}
 

import com.google.appengine.api.datastore.Query.CompositeFilterOperator; //导入依赖的package包/类
@Test
public void queryRestrictions_surprisingMultipleValuesAllMustMatch_returnsNoEntities()
    throws Exception {
  Entity a = new Entity("Widget", "a");
  List<Long> xs = Arrays.asList(1L, 2L);
  a.setProperty("x", xs);
  datastore.put(a);

  // [START surprising_behavior_example_1]
  Query q =
      new Query("Widget")
          .setFilter(
              CompositeFilterOperator.and(
                  new FilterPredicate("x", FilterOperator.GREATER_THAN, 1),
                  new FilterPredicate("x", FilterOperator.LESS_THAN, 2)));
  // [END surprising_behavior_example_1]

  // Entity "a" will not match because no individual value matches all filters.
  // See the documentation for more details:
  // https://cloud.google.com/appengine/docs/java/datastore/query-restrictions
  // #properties_with_multiple_values_can_behave_in_surprising_ways
  List<Entity> results =
      datastore.prepare(q.setKeysOnly()).asList(FetchOptions.Builder.withDefaults());
  assertThat(results).named("query results").isEmpty();
}
 

import com.google.appengine.api.datastore.Query.CompositeFilterOperator; //导入依赖的package包/类
@Test
public void testPropertyMetadata() {
    NamespaceManager.set(namespaceDat[2]);
    // sort by kind/property, kindDat[1] < kindDat[0] < kindDat[2]
    Query q = new Query("__property__").addSort(Entity.KEY_RESERVED_PROPERTY).setKeysOnly();
    // filter out properties for kind "testing"
    Key key1 = Entities.createPropertyKey(kindDat[0], "urlData");
    Key key2 = Entities.createPropertyKey(kindDat[2], "urlData");
    q.setFilter(CompositeFilterOperator.and(
        new FilterPredicate(Entity.KEY_RESERVED_PROPERTY, FilterOperator.GREATER_THAN, key1),
        new FilterPredicate(Entity.KEY_RESERVED_PROPERTY, FilterOperator.LESS_THAN_OR_EQUAL, key2)));
    List<Entity> el = service.prepare(q).asList(fo);
    // un-indexed property, textData, will not be returned in __property__ queries.
    assertEquals(13, el.size());
    for (int i = 0; i < el.size(); i++) {
        assertEquals(namespaceDat[2], el.get(i).getKey().getNamespace());
        assertEquals(kindDat[2], el.get(i).getKey().getParent().getName());
        if (i == 0) {
            assertEquals("adressData", el.get(0).getKey().getName());
        } else if (i == el.size() - 1) {
            assertEquals("urlData", el.get(el.size() - 1).getKey().getName());
        }
    }
}
 

import com.google.appengine.api.datastore.Query.CompositeFilterOperator; //导入依赖的package包/类
private static void updateRegistrations(Level level, Map<String, School> schools) {
	DatastoreService datastore = DatastoreServiceFactory.getDatastoreService();

	for (School school : schools.values()) {
		Filter schoolNameFilter = new FilterPredicate("schoolName", FilterOperator.EQUAL, school.getName());
		Filter schoolLevelFilter = new FilterPredicate("schoolLevel", FilterOperator.EQUAL, level.toString());
		Filter regTypeFilter = new FilterPredicate("registrationType", FilterOperator.EQUAL, "coach");

		Query query = new Query("registration").setFilter(CompositeFilterOperator.and(schoolNameFilter, schoolLevelFilter, regTypeFilter));
		List<Entity> registrations = datastore.prepare(query).asList(FetchOptions.Builder.withDefaults());

		if (registrations.size() > 0) {
			Entity registration = registrations.get(0);
			for (Entry<Test, Integer> numTest : school.getNumTests().entrySet()) {
				registration.setProperty(numTest.getKey().toString(), numTest.getValue());
			}
			datastore.put(registration);
		}
	}
}
 

import com.google.appengine.api.datastore.Query.CompositeFilterOperator; //导入依赖的package包/类
@Override
public Connection<?> getConnection(ConnectionKey connectionKey) {
	final CompositeFilter filter = CompositeFilterOperator.and(
		FilterOperator.EQUAL.of("providerId", connectionKey.getProviderId()),
		FilterOperator.EQUAL.of("providerUserId", connectionKey.getProviderUserId())
	);
	final Query query = new Query(getKind())
		.setAncestor(userKey)
		.setFilter(filter);
	Entity singleEntity;
	try {
		singleEntity = datastore.prepare(query).asSingleEntity();			
	} catch (TooManyResultsException ex) {
		log.warning("Too many results were found for query " + query.toString());
		throw new NoSuchConnectionException(connectionKey);
	}
	if (singleEntity == null) throw new NoSuchConnectionException(connectionKey);
	return connectionMapper.mapEntity(singleEntity);
}
 

import com.google.appengine.api.datastore.Query.CompositeFilterOperator; //导入依赖的package包/类
@Override
public List<String> findUserIdsWithConnection(Connection<?> connection) {
	ConnectionKey key = connection.getKey();
	final CompositeFilter filter = CompositeFilterOperator.and(
		FilterOperator.EQUAL.of("providerId", key.getProviderId()),
		FilterOperator.EQUAL.of("providerUserId", key.getProviderUserId())
	);
       // fetch and return only keys, not full entities.
	Query query = new Query(getKind()).setFilter(filter).setKeysOnly();
	List<String> localUserIds = DatastoreUtils.queryForList(datastore.prepare(query), userIdMapper);
	if (localUserIds.size() == 0 && connectionSignUp != null) {			
			String newUserId = connectionSignUp.execute(connection);
			if (newUserId != null) {
				createConnectionRepository(newUserId).addConnection(connection);
				return Arrays.asList(newUserId);
			}
	}
	return localUserIds;
}
 

import com.google.appengine.api.datastore.Query.CompositeFilterOperator; //导入依赖的package包/类
protected Object doExecute(Object[] parameters) {
    Class<?> domainClass = queryMethod.getEntityInformation().getJavaType();
    int paramIndex = 0;
    
    PartTree tree = new PartTree(getQueryMethod().getName(), getQueryMethod().getEntityInformation().getJavaType());
    System.out.println(tree);
    
    List<Filter> orFilters = new ArrayList<Filter>();
    for (Iterator<OrPart> orPartIter = tree.iterator(); orPartIter.hasNext();) {
        OrPart orPart = orPartIter.next();
        
        List<Filter> andFilters = new ArrayList<Filter>();
        for (Iterator<Part> partIter = orPart.iterator(); partIter.hasNext();) {
            Part part = partIter.next();
            PropertyPath propertyPath  = part.getProperty();
            String propName = propertyPath.getSegment();
            Object propValue = parameters[paramIndex++];
            
            FilterOperator operator = getFilterOperation(part);
            Filter filter = new Query.FilterPredicate(propName, operator, propValue);
            andFilters.add(filter);
        }
        if (andFilters.size() == 1) {
            orFilters.add(andFilters.get(0));
        } else if (andFilters.size() >= 2){
            orFilters.add(CompositeFilterOperator.and(andFilters));
        }
    }
    
    com.googlecode.objectify.cmd.Query q = ofy().load().type(domainClass);
    if (orFilters.size() == 1) {
        q = q.filter(orFilters.get(0));
    } else if (orFilters.size() >= 2){
        q = q.filter(CompositeFilterOperator.or(orFilters));
    }
    return q.list();
}
 

import com.google.appengine.api.datastore.Query.CompositeFilterOperator; //导入依赖的package包/类
@Override
public void doGet(HttpServletRequest req, HttpServletResponse resp)
    throws IOException, ServletException {
  Query q =
      new Query("Widget")
          .setFilter(
              CompositeFilterOperator.and(
                  new FilterPredicate("x", FilterOperator.EQUAL, 1),
                  new FilterPredicate("y", FilterOperator.EQUAL, "red")))
          .addSort("date", Query.SortDirection.ASCENDING);
  List<Entity> results = datastore.prepare(q).asList(FetchOptions.Builder.withDefaults());

  PrintWriter out = resp.getWriter();
  out.printf("Got %d widgets.\n", results.size());
}
 

import com.google.appengine.api.datastore.Query.CompositeFilterOperator; //导入依赖的package包/类
void printLowercaseKinds(DatastoreService ds, PrintWriter writer) {

    // Start with unrestricted kind query
    Query q = new Query(Entities.KIND_METADATA_KIND);

    List<Filter> subFils = new ArrayList();

    // Limit to lowercase initial letters
    subFils.add(
        new FilterPredicate(
            Entity.KEY_RESERVED_PROPERTY,
            FilterOperator.GREATER_THAN_OR_EQUAL,
            Entities.createKindKey("a")));

    String endChar = Character.toString((char) ('z' + 1)); // Character after 'z'

    subFils.add(
        new FilterPredicate(
            Entity.KEY_RESERVED_PROPERTY,
            FilterOperator.LESS_THAN,
            Entities.createKindKey(endChar)));

    q.setFilter(CompositeFilterOperator.and(subFils));

    // Print heading
    writer.println("Lowercase kinds:");

    // Print query results
    for (Entity e : ds.prepare(q).asIterable()) {
      writer.println("  " + e.getKey().getName());
    }
  }
 

import com.google.appengine.api.datastore.Query.CompositeFilterOperator; //导入依赖的package包/类
List<String> getNamespaces(DatastoreService ds, String start, String end) {

    // Start with unrestricted namespace query
    Query q = new Query(Entities.NAMESPACE_METADATA_KIND);
    List<Filter> subFilters = new ArrayList();
    // Limit to specified range, if any
    if (start != null) {
      subFilters.add(
          new FilterPredicate(
              Entity.KEY_RESERVED_PROPERTY,
              FilterOperator.GREATER_THAN_OR_EQUAL,
              Entities.createNamespaceKey(start)));
    }
    if (end != null) {
      subFilters.add(
          new FilterPredicate(
              Entity.KEY_RESERVED_PROPERTY,
              FilterOperator.LESS_THAN_OR_EQUAL,
              Entities.createNamespaceKey(end)));
    }

    q.setFilter(CompositeFilterOperator.and(subFilters));

    // Initialize result list
    List<String> results = new ArrayList<String>();

    // Build list of query results
    for (Entity e : ds.prepare(q).asIterable()) {
      results.add(Entities.getNamespaceFromNamespaceKey(e.getKey()));
    }

    // Return result list
    return results;
  }
 

import com.google.appengine.api.datastore.Query.CompositeFilterOperator; //导入依赖的package包/类
@Test
public void queryInterface_orFilter_printsMatchedEntities() throws Exception {
  // Arrange
  Entity a = new Entity("Person", "a");
  a.setProperty("height", 100);
  Entity b = new Entity("Person", "b");
  b.setProperty("height", 150);
  Entity c = new Entity("Person", "c");
  c.setProperty("height", 200);
  datastore.put(ImmutableList.<Entity>of(a, b, c));

  StringWriter buf = new StringWriter();
  PrintWriter out = new PrintWriter(buf);
  long minHeight = 125;
  long maxHeight = 175;

  // Act
  // [START interface_3]
  Filter tooShortFilter = new FilterPredicate("height", FilterOperator.LESS_THAN, minHeight);

  Filter tooTallFilter = new FilterPredicate("height", FilterOperator.GREATER_THAN, maxHeight);

  Filter heightOutOfRangeFilter = CompositeFilterOperator.or(tooShortFilter, tooTallFilter);

  Query q = new Query("Person").setFilter(heightOutOfRangeFilter);
  // [END interface_3]

  // Assert
  List<Entity> results =
      datastore.prepare(q.setKeysOnly()).asList(FetchOptions.Builder.withDefaults());
  assertThat(results).named("query results").containsExactly(a, c);
}
 

import com.google.appengine.api.datastore.Query.CompositeFilterOperator; //导入依赖的package包/类
@Test
public void queryRestrictions_compositeFilter_returnsMatchedEntities() throws Exception {
  // Arrange
  Entity a = new Entity("Person", "a");
  a.setProperty("birthYear", 1930);
  Entity b = new Entity("Person", "b");
  b.setProperty("birthYear", 1960);
  Entity c = new Entity("Person", "c");
  c.setProperty("birthYear", 1990);
  datastore.put(ImmutableList.<Entity>of(a, b, c));

  // Act
  long minBirthYear = 1940;
  long maxBirthYear = 1980;
  // [START inequality_filters_one_property_valid_example_1]
  Filter birthYearMinFilter =
      new FilterPredicate("birthYear", FilterOperator.GREATER_THAN_OR_EQUAL, minBirthYear);

  Filter birthYearMaxFilter =
      new FilterPredicate("birthYear", FilterOperator.LESS_THAN_OR_EQUAL, maxBirthYear);

  Filter birthYearRangeFilter =
      CompositeFilterOperator.and(birthYearMinFilter, birthYearMaxFilter);

  Query q = new Query("Person").setFilter(birthYearRangeFilter);
  // [END inequality_filters_one_property_valid_example_1]

  // Assert
  List<Entity> results =
      datastore.prepare(q.setKeysOnly()).asList(FetchOptions.Builder.withDefaults());
  assertThat(results).named("query results").containsExactly(b);
}
 

import com.google.appengine.api.datastore.Query.CompositeFilterOperator; //导入依赖的package包/类
@Test
public void queryRestrictions_surprisingMultipleValuesEquals_returnsMatchedEntities()
    throws Exception {
  Entity a = new Entity("Widget", "a");
  a.setProperty("x", ImmutableList.<Long>of(1L, 2L));
  Entity b = new Entity("Widget", "b");
  b.setProperty("x", ImmutableList.<Long>of(1L, 3L));
  Entity c = new Entity("Widget", "c");
  c.setProperty("x", ImmutableList.<Long>of(-6L, 2L));
  Entity d = new Entity("Widget", "d");
  d.setProperty("x", ImmutableList.<Long>of(-6L, 4L));
  Entity e = new Entity("Widget", "e");
  e.setProperty("x", ImmutableList.<Long>of(1L, 2L, 3L));
  datastore.put(ImmutableList.<Entity>of(a, b, c, d, e));

  // [START surprising_behavior_example_2]
  Query q =
      new Query("Widget")
          .setFilter(
              CompositeFilterOperator.and(
                  new FilterPredicate("x", FilterOperator.EQUAL, 1),
                  new FilterPredicate("x", FilterOperator.EQUAL, 2)));
  // [END surprising_behavior_example_2]

  // Only "a" and "e" have both 1 and 2 in the "x" array-valued property.
  // See the documentation for more details:
  // https://cloud.google.com/appengine/docs/java/datastore/query-restrictions#properties_with_multiple_values_can_behave_in_surprising_ways
  List<Entity> results =
      datastore.prepare(q.setKeysOnly()).asList(FetchOptions.Builder.withDefaults());
  assertThat(results).named("query results").containsExactly(a, e);
}
 

import com.google.appengine.api.datastore.Query.CompositeFilterOperator; //导入依赖的package包/类
@Test
public void queryRestrictions_surprisingMultipleValuesTwoNotEquals_returnsMatchedEntities()
    throws Exception {
  Entity a = new Entity("Widget", "a");
  a.setProperty("x", ImmutableList.<Long>of(1L, 2L));
  Entity b = new Entity("Widget", "b");
  b.setProperty("x", ImmutableList.<Long>of(1L, 2L, 3L));
  datastore.put(ImmutableList.<Entity>of(a, b));

  // [START surprising_behavior_example_4]
  Query q =
      new Query("Widget")
          .setFilter(
              CompositeFilterOperator.and(
                  new FilterPredicate("x", FilterOperator.NOT_EQUAL, 1),
                  new FilterPredicate("x", FilterOperator.NOT_EQUAL, 2)));
  // [END surprising_behavior_example_4]

  // The two NOT_EQUAL filters in the query become like the combination of queries:
  // x < 1 OR (x > 1 AND x < 2) OR x > 2
  //
  // Only "b" has some value which matches the "x > 2" portion of this query.
  //
  // See the documentation for more details:
  // https://cloud.google.com/appengine/docs/java/datastore/query-restrictions#properties_with_multiple_values_can_behave_in_surprising_ways
  List<Entity> results =
      datastore.prepare(q.setKeysOnly()).asList(FetchOptions.Builder.withDefaults());
  assertThat(results).named("query results").containsExactly(b);
}
 

import com.google.appengine.api.datastore.Query.CompositeFilterOperator; //导入依赖的package包/类
@Test
public void queryRestrictions_surprisingMultipleValuesEquals_returnsMatchedEntities()
    throws Exception {
  Entity a = new Entity("Widget", "a");
  a.setProperty("x", ImmutableList.<Long>of(1L, 2L));
  Entity b = new Entity("Widget", "b");
  b.setProperty("x", ImmutableList.<Long>of(1L, 3L));
  Entity c = new Entity("Widget", "c");
  c.setProperty("x", ImmutableList.<Long>of(-6L, 2L));
  Entity d = new Entity("Widget", "d");
  d.setProperty("x", ImmutableList.<Long>of(-6L, 4L));
  Entity e = new Entity("Widget", "e");
  e.setProperty("x", ImmutableList.<Long>of(1L, 2L, 3L));
  datastore.put(ImmutableList.<Entity>of(a, b, c, d, e));

  // [START surprising_behavior_example_2]
  Query q =
      new Query("Widget")
          .setFilter(
              CompositeFilterOperator.and(
                  new FilterPredicate("x", FilterOperator.EQUAL, 1),
                  new FilterPredicate("x", FilterOperator.EQUAL, 2)));
  // [END surprising_behavior_example_2]

  // Only "a" and "e" have both 1 and 2 in the "x" array-valued property.
  // See the documentation for more details:
  // https://cloud.google.com/appengine/docs/java/datastore/query-restrictions
  // #properties_with_multiple_values_can_behave_in_surprising_ways
  List<Entity> results =
      datastore.prepare(q.setKeysOnly()).asList(FetchOptions.Builder.withDefaults());
  assertThat(results).named("query results").containsExactly(a, e);
}
 

import com.google.appengine.api.datastore.Query.CompositeFilterOperator; //导入依赖的package包/类
@Test
public void queryRestrictions_surprisingMultipleValuesTwoNotEquals_returnsMatchedEntities()
    throws Exception {
  Entity a = new Entity("Widget", "a");
  a.setProperty("x", ImmutableList.<Long>of(1L, 2L));
  Entity b = new Entity("Widget", "b");
  b.setProperty("x", ImmutableList.<Long>of(1L, 2L, 3L));
  datastore.put(ImmutableList.<Entity>of(a, b));

  // [START surprising_behavior_example_4]
  Query q =
      new Query("Widget")
          .setFilter(
              CompositeFilterOperator.and(
                  new FilterPredicate("x", FilterOperator.NOT_EQUAL, 1),
                  new FilterPredicate("x", FilterOperator.NOT_EQUAL, 2)));
  // [END surprising_behavior_example_4]

  // The two NOT_EQUAL filters in the query become like the combination of queries:
  // x < 1 OR (x > 1 AND x < 2) OR x > 2
  //
  // Only "b" has some value which matches the "x > 2" portion of this query.
  //
  // See the documentation for more details:
  // https://cloud.google.com/appengine/docs/java/datastore/query-restrictions
  // #properties_with_multiple_values_can_behave_in_surprising_ways
  List<Entity> results =
      datastore.prepare(q.setKeysOnly()).asList(FetchOptions.Builder.withDefaults());
  assertThat(results).named("query results").containsExactly(b);
}
 

import com.google.appengine.api.datastore.Query.CompositeFilterOperator; //导入依赖的package包/类
private static Filter getSourceFilter(final PageId source) {
    final int number = source.getNumber();
    final Filter numberFilter = getSourceNumberFilter(number);
    final String version = source.getVersion();
    final Filter versionFilter = getSourceVersionFilter(version);
    return CompositeFilterOperator.and(numberFilter, versionFilter);
}