DataQL之语法-词法记号

太过爱你忘了你带给我的痛 2022-11-28 10:43 173阅读 0赞

# 词法记号 #

以下正式的语法规范可以用来帮助更深入的了解如何使用 DataQL 的所有特性。

# 源码文本 #

DataQL 文档表示建议使用 Unicode字符序列。但这并不是强制的，您可以通过 java.io.Reader 来读取您的字符流数据。故本文不会强调您的编写查询语言所使用的字符集。  
DataQL 支持单行注释和多行注释两种注释方式。与 JavaScript 一样，您可以使用：`//、/* ... */` 的形式进行代码注释。被注释的代码会被语法解析器忽略。

*  单行注释：以 // 开头后面的当前换行符内的所有内容均为注释内容。
 *  多行注释：以 \* 开始直到遇到 \*/ 为止，中间的所有内容均为注释。

# 空白字符 #

空白字符用于提高源文本的可读性，并作为标记之间的分隔，任何数量的空白都可能出现在任何标记之前或之后。标记之间的空白对于 DataQL 文档的语义意义并不重要。

*  空白字符：`(空格)、\t、\n、\r、\f`

# 关键字 #

<table> 
 <thead> 
  <tr> 
   <th>关键字</th> 
   <th>含义</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>if</td> 
   <td>条件语句的引导词</td> 
  </tr> 
  <tr> 
   <td>else</td> 
   <td>用在条件语句中，表明当条件不成立时的分支</td> 
  </tr> 
  <tr> 
   <td>return</td> 
   <td>三大退出指令之一，终止当前过程的执行并正常退出到上一个执行过程中</td> 
  </tr> 
  <tr> 
   <td>throw</td> 
   <td>三大退出指令之一，终止所有后续指令的执行并抛出异常</td> 
  </tr> 
  <tr> 
   <td>exit</td> 
   <td>三大退出指令之一，终止所有后续指令的执行并正常退出</td> 
  </tr> 
  <tr> 
   <td>var</td> 
   <td>执行一个查询动作，并把查询结果保存到临时变量中</td> 
  </tr> 
  <tr> 
   <td>run</td> 
   <td>仅仅执行查询动作，不保留查询的结果</td> 
  </tr> 
  <tr> 
   <td>hint</td> 
   <td>写在 DataQL 查询语句的最前面，用于设置一些执行选项参数</td> 
  </tr> 
  <tr> 
   <td>import</td> 
   <td>将另外一个 DataQL 查询导入并作为一个 Udf 形式存在、或直接导入一个 Udf 到当前查询中</td> 
  </tr> 
  <tr> 
   <td>as</td> 
   <td>与 import 关键字配合使用，用作将导入的 Udf 命名为一个本地变量名</td> 
  </tr> 
  <tr> 
   <td>true</td> 
   <td>基础类型之一，表示 Boolean 的：真值</td> 
  </tr> 
  <tr> 
   <td>false</td> 
   <td>基础类型之一，表示 Boolean 的：假值</td> 
  </tr> 
  <tr> 
   <td>null</td> 
   <td>基础类型之一，表示 NULL 值</td> 
  </tr> 
 </tbody> 
</table>

# 标识符 #

在编写 DataQL 中用来表示查询中的一些实体。例如：变量名、参数名

*  标识符必须满足正则表达式：\[\_a-zA-Z\]\[\_0-9a-zA-Z\]\*
 *  在一些接口中数据对象的 Key 可能会超出标识符标示的范围，这时候可以使用 反引号 `xxxx` 的形式来标示标识符。

# 分割符 #

<table> 
 <thead> 
  <tr> 
   <th>分割符</th> 
   <th>含义</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>()</td> 
   <td>函数入参的圈定，表达式中的计算项提取权</td> 
  </tr> 
  <tr> 
   <td>{}</td> 
   <td>用来定义复合语句</td> 
  </tr> 
  <tr> 
   <td>[]</td> 
   <td>对数据通过下标方式取值操作</td> 
  </tr> 
  <tr> 
   <td>,</td> 
   <td>不同参数的分割；对象键值对或数组元素之间的分割</td> 
  </tr> 
  <tr> 
   <td>:</td> 
   <td>对象键值对，键和值之间的分割</td> 
  </tr> 
  <tr> 
   <td>；</td> 
   <td>语句的结束，DataQL 会自动推断语句结束，因此语句结束分割符并不是必须的</td> 
  </tr> 
 </tbody> 
</table>

# 运算符 #

# 总结 #

本次是DataQL之语法说明。  
如有问题，欢迎有问题及时交流。谢谢！