Applies the next by* method to the previous by* method, so
that a call
hasNext
,
next
, or
results
sees only the intersection of the two
calls.
For example,
service.onlyType(Image.class);
service.byFullText("foo");
service.complement();
service.byAnnotatedWith(TagAnnotation.class);
will return all the Images
not annotated with
TagAnnotation.
Calling this method overrides a previous setting of
or
or and
. If there is no active queries
(i.e. activeQueries > 0
), then an
ApiUsageException
will be thrown.