| java.lang.Object
 org.geotools.filter.text.cql2.CQL
| CQL | | public class CQL (Code) | | Utility class to parse CQL predicates and expressions to GeoAPI
Filter s and
Expression s, respectively.
CQL is an acronym for OGC Common Query Language, a query predicate
language whose syntax is similar to a SQL WHERE clause, defined in clause
6.2.2 of the OGC Catalog Service for Web, version 2.0.1 implementation
specification.
This class provides three methods,
CQL.toFilter(String) ,
CQL.toExpression(String) and
CQL.toFilterList(String) ; and an
overloaded version of each one for the user to provide a
FilterFactory2 implementation to use.
Usage
Here are some usage examples. Refer to the complete
grammar to see what exactly you can do.
Filter f1 = CQL.toFilter("ATTR1 < 10 AND ATTR2 < 2 OR ATTR3 > 10");
Filter f2 = CQL.toFilter("ATTR1 IS NULL");
Filter f3 = CQL.toFilter("ATTR1 BEFORE 2006-11-30T01:30:00Z");
Filter f4 = CQL.toFilter("ATTR1 DOES-NOT-EXIST");
Filter f5 = CQL.toFilter("ATTR1 BETWEEN 10 AND 20");
Filter f6 = CQL.toFilter("CROSS(ATTR1, LINESTRING(1 2, 10 15))");
Filter f7 = CQL.toFilter("BBOX(ATTR1, 10,20,30,40)");
Expression expr1 = CQL.toExpression("attName");
Expression expr2 = CQL.toExpression("attName * 2");
Expression expr3 = CQL.toExpression("strConcat(attName, 'suffix')");
List filters = CQL
.toFilterList("ATTR1 IS NULL|BBOX(ATTR1, 10,20,30,40)|INCLUDE");
since:
2.4
author:
Mauricio Pazos - Axios Engineering
author:
Gabriel Roldan - Axios Engineering
version:
$Id: CQL.java 28745 2008-01-14 12:22:32Z vmpazos $ |
| Method Summary | |
| final public static void | main(String[] args)
| | public static Expression | toExpression(String cqlExpression)
Parses the input string in OGC CQL format into an Expression, using the
systems default FilterFactory implementation.
Parameters:
cqlExpression - a string containing an OGC CQL expression. | | public static Expression | toExpression(String cqlExpression, FilterFactory filterFactory)
Parses the input string in OGC CQL format into an Expression, using the
provided FilterFactory.
Parameters:
cqlExpression - a string containing a OGC CQL expression.
Parameters:
filterFactory - the FilterFactory to use for the creation of theExpression. | | public static Filter | toFilter(String cqlPredicate)
Parses the input string in OGC CQL format into a Filter, using the
systems default FilterFactory implementation.
Parameters:
cqlPredicate - a string containing a query predicate in OGC CQL format. | | public static Filter | toFilter(String cqlPredicate, FilterFactory filterFactory)
Parses the input string in OGC CQL format into a Filter, using the
provided FilterFactory.
Parameters:
cqlPredicate - a string containing a query predicate in OGC CQL format.
Parameters:
filterFactory - the FilterFactory to use for the creation of theFilter. | | public static List | toFilterList(String cqlFilterList)
Parses the input string, which has to be a list of OGC CQL predicates
separated by | into a List of
Filters, using the provided FilterFactory. | | public static List | toFilterList(String cqlSourceFilterList, FilterFactory filterFactory)
Parses the input string, which has to be a list of OGC CQL predicates
separated by | into a List of
Filters, using the provided FilterFactory.
Parameters:
cqlSourceFilterList - a list of OGC CQL predicates separated by |
Parameters:
filterFactory - the FilterFactory to use for the creation of theExpression. |
| main | | final public static void main(String[] args)(Code) | | Interactive filter compiling
Parameters:
args - |
| toExpression | | public static Expression toExpression(String cqlExpression) throws CQLException(Code) | | Parses the input string in OGC CQL format into an Expression, using the
systems default FilterFactory implementation.
Parameters:
cqlExpression - a string containing an OGC CQL expression. a Expression equivalent to the one specified incqlExpression. |
| toExpression | | public static Expression toExpression(String cqlExpression, FilterFactory filterFactory) throws CQLException(Code) | | Parses the input string in OGC CQL format into an Expression, using the
provided FilterFactory.
Parameters:
cqlExpression - a string containing a OGC CQL expression.
Parameters:
filterFactory - the FilterFactory to use for the creation of theExpression. If it is null the method finds the default implementation. a Filter equivalent to the constraint specified incqlExpression. |
| toFilter | | public static Filter toFilter(String cqlPredicate) throws CQLException(Code) | | Parses the input string in OGC CQL format into a Filter, using the
systems default FilterFactory implementation.
Parameters:
cqlPredicate - a string containing a query predicate in OGC CQL format. a Filter equivalent to the constraint specified incqlPredicate. |
| toFilter | | public static Filter toFilter(String cqlPredicate, FilterFactory filterFactory) throws CQLException(Code) | | Parses the input string in OGC CQL format into a Filter, using the
provided FilterFactory.
Parameters:
cqlPredicate - a string containing a query predicate in OGC CQL format.
Parameters:
filterFactory - the FilterFactory to use for the creation of theFilter. If it is null the method finds the default implementation. a Filter equivalent to the constraint specified inPredicate. |
| toFilterList | | public static List toFilterList(String cqlFilterList) throws CQLException(Code) | | Parses the input string, which has to be a list of OGC CQL predicates
separated by | into a List of
Filters, using the provided FilterFactory.
Parameters:
cqlFilterList - a list of OGC CQL predicates separated by | a List of Filter, one for each input CQL statement |
| toFilterList | | public static List toFilterList(String cqlSourceFilterList, FilterFactory filterFactory) throws CQLException(Code) | | Parses the input string, which has to be a list of OGC CQL predicates
separated by | into a List of
Filters, using the provided FilterFactory.
Parameters:
cqlSourceFilterList - a list of OGC CQL predicates separated by |
Parameters:
filterFactory - the FilterFactory to use for the creation of theExpression. If it is null the method finds the default implementation. a List of Filter, one for each input CQL statement |
|
|