《深入理解Elasticsearch(原书第2版)》一2.3.2 Mustache模板引擎

本节书摘来华章计算机《深入理解Elasticsearch(原书第2版)》一书中的第2章 ,第2.3.2节,[美]拉斐尔·酷奇(Rafal Ku) 马雷克·罗戈任斯基(Marek Rogoziski)著 张世武 余洪淼 商旦 译 更多章节内容可以访问云栖社区“华章计算机”公众号查看。

2.3.2 Mustache模板引擎

Elasticsearch使用Mustache模板引擎来为查询模板生成可用的查询语句。如你所见,每个变量被双大括号包裹,这一点是Mustache规范要求的,是该模板引擎间接引用变量的方式。Mustache模板引擎的完整语法不在本书讨论范围内,不过我们可以在这里简单介绍一下它最具魅力的部分,包括条件表达式、循环和默认值。

1. 条件表达式
{{val}}表达式用来插入变量val的值。{{#val}}和{{/val}}则用来在变量val取值计算为true时把位于它们之间的变量标记替换为变量值。
我们看一下下面这个示例:
《深入理解Elasticsearch(原书第2版)》一2.3.2 Mustache模板引擎

这个命令将返回library索引中的所有文档。不过,假如我们把limit参数的取值改为true,则再次查询后,我们将只能得到两个文档。这是因为判断条件满足了,模板内容因此被激活。
 不幸的是,似乎直到本书写作时,笔者所使用的Elasticsearch版本在处理条件表达式时仍然有些问题。比如,其中一个相关问题可以在这里看到:https://github.com/Elasticsearch/Elasticsearch/issues/8308 。我们决定保留条件表达式这一小节,以期望相关问题都能在未来得到解决。使用条件表达式可以更方便地构造查询模板。
2. 循环
循环结构定义和条件表达式一模一样,都位于{{#val}}和{{/val}}之间。如果表达式中变量取值是数组,则可以使用{{.}}标记来指代当前变量值。
例如,假定我们需要模板引擎遍历一个词项数组来生成一个词项查询,可以执行如下命令:
《深入理解Elasticsearch(原书第2版)》一2.3.2 Mustache模板引擎

3. 默认值
默认值标记允许我们在参数未定义时给它设置默认取值。比如,给var变量设置默认值语法的代码如下:
《深入理解Elasticsearch(原书第2版)》一2.3.2 Mustache模板引擎

举个例子,假定我们要给查询模板中的phrase参数设置默认值“crime”,可以使用如下命令:
《深入理解Elasticsearch(原书第2版)》一2.3.2 Mustache模板引擎

这个命令将从Elasticsearch查询出所有title字段中包含front的文档。而如果我们在params片段中不指定phrase参数的值,则使用crime来代替。

上一篇:《深入理解Elasticsearch(原书第2版)》一2.3.1 引入查询模板


下一篇:“基因编辑婴儿”惹争议,三位学者却指出应用前景