一、RSQL / FIQL parser
RSQL是一种查询语言，用于对RESTful API中的条目进行参数化过滤。它基于FIQL（Feed Item Query Language）——一种URI友好的语法，用于跨Atom Feed中的条目表达过滤器。FIQL非常适合在URI中使用，没有不安全的字符，因此不需要URL编码。另一方面，FIQL的语法不太直观，URL编码也不总是那么重要，因此RSQL还为逻辑运算符和一些比较运算符提供了更友好的语法。
例如，您可以像这样查询资源：/movies?query=name=="Kill Bill";year=gt=2003 or /movies?query=director.lastName==Nolan and year>=2000。详见以下示例：
这是一个用JavaCC和Java编写的完整且经过彻底测试的RSQL解析器。因为RSQL是FIQL的超集，所以它也可以用于解析FIQL。
语法和语义
以下语法规范采用EBNF表示法（ISO 14977）编写。
RSQL表达式由一个或多个比较组成，通过逻辑运算符相互关联：
Logical AND : ; or and
Logical OR : , or or
默认情况下，AND运算符优先（即，在任何OR运算符之前对其求值）。但是，可以使用带括号的表达式来更改优先级，从而产生所包含表达式产生的任何结果。
input = or, EOF;
or = and, { "," , and };
and = constraint, { ";" , constraint };
constraint= ( group | comparison );
group = "(", or, ")";
比较由选择器、运算符和参数组成。
comparison=选择器、比较运算、参数；
选择器标识要筛选的资源表示形式的字段（或属性、元素…）。它可以是任何不包含保留字符的非空Unicode字符串（见下文）或空格。选择器的特定语法不由此解析器强制执行。
selector=未保留str；
比较运算符采用FIQL表示法，其中一些运算符还具有另一种语法：
· Equal to : ==
· Not equal to : !=
· Less than : =lt= or <
· Less than or equal to : =le= or <=
· Greater than operator : =gt= or >
· Greater than or equal to : =ge= or >=
· In : =in=
· Not in : =out=
您还可以使用自己的运算符简单地扩展此解析器（请参阅下一节）。
comparison-op = comp-fiql | comp-alt;
comp-fiql = ( ( "=", { ALPHA } ) | "!" ), "=";
comp-alt = ( ">" | "<" ), [ "=" ];
参数可以是单个值，也可以是用逗号分隔的括号中的多个值。不包含任何保留字符或空格的值可以不加引号，其他参数必须用单引号或双引号括起来。
arguments = ( "(", value, { "," , value }, ")" ) | value;
value = unreserved-str | double-quoted | single-quoted;
unreserved-str = unreserved, { unreserved }
single-quoted = "'", { ( escaped | all-chars - ( "'" | "\" ) ) }, "'";
double-quoted = '"', { ( escaped | all-chars - ( '"' | "\" ) ) }, '"';
reserved = '"' | "'" | "(" | ")" | ";" | "," | "=" | "!" | "~" | "<" | ">";
unreserved = all-chars - reserved - " ";
escaped = "\", all-chars;
all-chars = ? all unicode characters ?;
如果需要在带引号的参数中同时使用单引号和双引号，则必须使用\（反斜杠）转义其中一个引号。如果要按字面意思使用\，请将其加倍为\。反斜杠只有在引用的参数中才有特殊含义，而不是在未引用的参数。
示例
Examples of RSQL expressions in both FIQL-like and alternative notation:
- name=="Kill Bill";year=gt=2003
- name=="Kill Bill" and year>2003
- genres=in=(sci - fi,action);(director=='Christopher Nolan',actor==*Bale);year=ge=2000
- genres=in=(sci - fi,action) and (director=='Christopher Nolan' or actor==*Bale) and year>=2000
- director.lastName==Nolan;year=ge=2000;year=lt=2010
- director.lastName==Nolan and year>=2000 and year<2010
- genres=in=(sci - fi,action);genres=out=(romance,animated,horror),director==Que*Tarantino
- genres=in=(sci - fi,action) and genres=out=(romance,animated,horror) or director==Que*Tarantino
二、Oinone 拓展协议
正常类型
- Is null : =isnull=
- Not null : =notnull=
- Like to : =like=
- Not like to : =notlike=
- Column equal to : =cole=
- Not column equal to : =colnot=
- like ‘xxxx%’ : =starts=
- not like ‘xxxx%’ :=notstarts=
- like ‘%xxxx’ : =ends=
- not like ‘%xxxx’ : =notends=
二进制枚举
-
Intersect : =has=
-
Not Intersect : =hasnt=
-
Contain : =contain=
-
Not Contain : =notcontain=
Oinone社区 作者：史, 昂原创文章，如若转载，请注明出处：https://doc.oinone.top/oio4/9291.html
访问Oinone官网:https://www.oinone.top获取数式Oinone低代码应用平台体验
