RSQL is a query language for parametrized filtering of entries in RESTful APIs. It's based on FIQL (Feed Item Query Language) – an URI-friendly syntax for expressing filters across the entries in an Atom Feed. FIQL is great for use in URI; there are no unsafe characters, so URL encoding is not required. On the other side, FIQL's syntax is not very intuitive and URL encoding isn't always that big deal, so RSQL also provides a friendlier syntax for logical operators and some of the comparison operators.
For example, you can query your resource like this: /movies?query=name=="Kill Bill";year=gt=2003 or /movies?query=director.lastName==Nolan and year>=2000. See examples below.
This is a complete and thoroughly tested parser for RSQL written in JavaCC and Java. Since RSQL is a superset of the FIQL, it can be used for parsing FIQL as well.
RSQL-parser can be used with RSQL-hibernate, library to translate RSQL expression to Hibernate's Criteria query (it's written for 1.x version of the parser though), or RSQL-MongoDB.
Read full article from jirutka/rsql-parser
No comments:
Post a Comment