org.apache.cxf.jaxrs.ext.search.fiql
Class FiqlParser<T>

java.lang.Object
  org.apache.cxf.jaxrs.ext.search.fiql.FiqlParser<T>

Type Parameters:

T - type of search condition.

All Implemented Interfaces:

SearchConditionParser<T>

public class FiqlParser<T>
extends Object
implements SearchConditionParser<T>

Parses FIQL expression to construct SearchCondition structure. Since this class operates on Java type T, not on XML structures "selectors" part of specification is not applicable; instead selectors describes getters of type T used as search condition type (see SimpleSearchCondition.isMet(Object) for details.

OR

public static final String OR

See Also:

Constant Field Values

AND

public static final String AND

See Also:

Constant Field Values

GT

public static final String GT

See Also:

Constant Field Values

GE

public static final String GE

See Also:

Constant Field Values

LT

public static final String LT

See Also:

Constant Field Values

LE

public static final String LE

See Also:

Constant Field Values

EQ

public static final String EQ

See Also:

Constant Field Values

NEQ

public static final String NEQ

See Also:

Constant Field Values

DEFAULT_DATE_FORMAT

public static final String DEFAULT_DATE_FORMAT

See Also:

Constant Field Values

FiqlParser

public FiqlParser(Class<T> tclass)

Creates FIQL parser.

Parameters:

tclass - - class of T used to create condition objects in built syntax tree. Class T must have accessible no-arg constructor and complementary setters to these used in FIQL expressions.

FiqlParser

public FiqlParser(Class<T> tclass,
                  Map<String,String> contextProperties)

Creates FIQL parser.

Parameters:

tclass - - class of T used to create condition objects in built syntax tree. Class T must have accessible no-arg constructor and complementary setters to these used in FIQL expressions.

contextProperties -

parse

public SearchCondition<T> parse(String fiqlExpression)
                         throws SearchParseException

Parses expression and builds search filter. Names used in FIQL expression are names of getters/setters in type T.

Example:

 class Condition {
   public String getFoo() {...}
   public void setFoo(String foo) {...}
   public int getBar() {...}
   public void setBar(int bar) {...}
 }
 
 FiqlParser<Condition> parser = new FiqlParser<Condition>(Condition.class);
 parser.parse("foo==mystery*;bar=ge=10");
 

Specified by:

parse in interface SearchConditionParser<T>

Parameters:

fiqlExpression - expression of filter.

Returns:

tree of SearchCondition objects representing runtime search structure.

Throws:

SearchParseException - when expression does not follow FIQL grammar