|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.geotools.filter.text.cql2.CQL
public class CQL
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, toFilter(String)
,
toExpression(String)
and toFilterList(String)
; and an
overloaded version of each one for the user to provide a
FilterFactory
implementation to use.
Filter f = CQL.toFilter("ATTR1 < 10 AND ATTR2 < 2 OR ATTR3 > 10");
Filter f = CQL.toFilter("NAME = 'New York' ");
Filter f = CQL.toFilter("NAME LIKE 'New%' ");
Filter f = CQL.toFilter("NAME IS NULL");
Filter f = CQL.toFilter("DATE BEFORE 2006-11-30T01:30:00Z");
Filter f = CQL.toFilter("NAME DOES-NOT-EXIST");
Filter f = CQL.toFilter("QUANTITY BETWEEN 10 AND 20");
Filter f = CQL.toFilter("CROSS(SHAPE, LINESTRING(1 2, 10 15))");
Filter f = CQL.toFilter("BBOX(SHAPE, 10,20,30,40)");
Expression e = CQL.toExpression("NAME");
Expression e = CQL.toExpression("QUANTITY * 2");
Expression e = CQL.toExpression("strConcat(NAME, 'suffix')");
List filters = CQL.toFilterList("NAME IS NULL;BBOX(SHAPE, 10,20,30,40);INCLUDE");
Method Summary | |
---|---|
static void |
main(java.lang.String[] args)
|
static java.lang.String |
toCQL(org.opengis.filter.expression.Expression expression)
WARNING THIS IS A WORK IN PROGRESS. |
static java.lang.String |
toCQL(org.opengis.filter.Filter filter)
WARNING THIS IS A WORK IN PROGRESS. |
static org.opengis.filter.expression.Expression |
toExpression(java.lang.String cqlExpression)
Parses the input string in OGC CQL format into an Expression, using the systems default FilterFactory implementation. |
static org.opengis.filter.expression.Expression |
toExpression(java.lang.String cqlExpression,
org.opengis.filter.FilterFactory filterFactory)
Parses the input string in OGC CQL format into an Expression , using the
provided FilterFactory . |
static org.opengis.filter.Filter |
toFilter(java.lang.String cqlPredicate)
Parses the input string in OGC CQL format into a Filter, using the systems default FilterFactory implementation. |
static org.opengis.filter.Filter |
toFilter(java.lang.String cqlPredicate,
org.opengis.filter.FilterFactory filterFactory)
Parses the input string in OGC CQL format into a Filter, using the provided FilterFactory. |
static java.util.List<org.opengis.filter.Filter> |
toFilterList(java.lang.String cqlFilterList)
Parses the input string, which has to be a list of OGC CQL predicates separated by ; into a List of
Filter s, using the provided FilterFactory. |
static java.util.List<org.opengis.filter.Filter> |
toFilterList(java.lang.String cqlSequencePredicate,
org.opengis.filter.FilterFactory filterFactory)
Parses the input string which has to be a list of OGC CQL predicates separated by " ; " into a List of
Filter s, using the provided FilterFactory. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Method Detail |
---|
public static org.opengis.filter.Filter toFilter(java.lang.String cqlPredicate) throws CQLException
cqlPredicate
- a string containing a query predicate in OGC CQL format.
Filter
equivalent to the constraint specified in
cqlPredicate
.
CQLException
public static org.opengis.filter.Filter toFilter(java.lang.String cqlPredicate, org.opengis.filter.FilterFactory filterFactory) throws CQLException
cqlPredicate
- a string containing a query predicate in OGC CQL format.filterFactory
- the FilterFactory
to use for the creation of the
Filter. If it is null the method finds the default implementation.
Filter
equivalent to the constraint specified in
Predicate
.
CQLException
public static org.opengis.filter.expression.Expression toExpression(java.lang.String cqlExpression) throws CQLException
FilterFactory
implementation.
cqlExpression
- a string containing an OGC CQL expression.
Expression
equivalent to the one specified in
cqlExpression
.
CQLException
public static org.opengis.filter.expression.Expression toExpression(java.lang.String cqlExpression, org.opengis.filter.FilterFactory filterFactory) throws CQLException
Expression
, using the
provided FilterFactory
.
cqlExpression
- a string containing a OGC CQL expression.filterFactory
- the FilterFactory
to use for the creation of the
Expression. If it is null the method finds the default implementation.
Filter
equivalent to the constraint specified in
cqlExpression
.
CQLException
public static java.util.List<org.opengis.filter.Filter> toFilterList(java.lang.String cqlFilterList) throws CQLException
;
into a List
of
Filter
s, using the provided FilterFactory.
cqlFilterList
- a list of OGC CQL predicates separated by ";
"
List
of Filter
, one for each input CQL statement
CQLException
public static java.lang.String toCQL(org.opengis.filter.Filter filter)
filter
-
public static java.lang.String toCQL(org.opengis.filter.expression.Expression expression)
filter
-
public static java.util.List<org.opengis.filter.Filter> toFilterList(java.lang.String cqlSequencePredicate, org.opengis.filter.FilterFactory filterFactory) throws CQLException
;
" into a List
of
Filter
s, using the provided FilterFactory.
cqlSequencePredicate
- a list of OGC CQL predicates separated by ";
"filterFactory
- the FilterFactory
to use for the creation of the
Expression. If it is null the method finds the default implementation.
Filter
, one for each input CQL statement
CQLException
public static final void main(java.lang.String[] args)
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |