com.google.gdata.client
Class Query.CategoryFilter

java.lang.Object
  extended by com.google.gdata.client.Query.CategoryFilter
Enclosing class:
Query

public static class Query.CategoryFilter
extends java.lang.Object

The CategoryFilter class is used to define sets of category conditions that must be met in order for an entry to match.

The CategoryFilter can contain multiple category criteria (inclusive or exclusive). If it does contain multiple categories, then the query matches if any one of the category filter criteria is met, i.e. it is a logical 'OR' of the contained category criteria. To match, an entry must contain at least one included category or must not contain at least one excluded category.

It is also possible to add multiple CategoryFilters to a Query. In this case, each individual CategoryFilter must be true for an entry to match, i.e. it is a logical 'AND' of all CategoryFilters.

See Also:
Query.addCategoryFilter(CategoryFilter)

Constructor Summary
Query.CategoryFilter()
          Creates an empty category filter.
Query.CategoryFilter(Category category)
          Creates a simple category filter containing only a single Category.
 
Method Summary
 void addCategory(Category category)
          Adds a new Category to the query, indicating that entries containing the category should be considered to match.
 void addExcludeCategory(Category category)
          Adds a new Category to the query, indicating that entries that do not contain the category should be considered to match.
 java.lang.String toString()
          Returns a string representation for the category conditions in the CategoryFilter, in the format used by a Query URI.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

Query.CategoryFilter

public Query.CategoryFilter()
Creates an empty category filter.


Query.CategoryFilter

public Query.CategoryFilter(Category category)
Creates a simple category filter containing only a single Category.

Parameters:
category - an initial category to add to the filter.
Method Detail

addCategory

public void addCategory(Category category)
Adds a new Category to the query, indicating that entries containing the category should be considered to match.

Parameters:
category - the category to add to query parameters.

addExcludeCategory

public void addExcludeCategory(Category category)
Adds a new Category to the query, indicating that entries that do not contain the category should be considered to match.

Parameters:
category - the category to add to query parameters.

toString

public java.lang.String toString()
Returns a string representation for the category conditions in the CategoryFilter, in the format used by a Query URI.

Overrides:
toString in class java.lang.Object