Solr查询语言 JSON Request API jsonsolrblog工作
程序员文章站
2022-03-10 17:56:55
...
全文阅读http://click.aliyun.com/m/23536/
一、背景与动机
JSON Request API是由noggit作者（同时也Solr Committer Leader）在Solr.5.3带来新特性，意在改善Solr原来复杂且又丑陋查询语法。
注：JSON Request API与Solr API v2并不是一回来，JSON Request API是一种新型Solr Query DSL。API v2新版本查询API，是基于Restful API实现的。当然JSON Request API显然是基于JSON实现的咯。
不过Request API还是API v2都是Solr学习ElasticSearch靠近的表现。
以前想写简单查询其实也没有很复杂，就是写个q参数，然后指定一下rows和sort嘛，但是对于用Solr来做统计相关工作的同学，还是觉得挺烦的。因为它
1. 冗长，没有结构，容易出错，难于校验和debug。f.facet_field_name.facet.range.start=5
2. 没有数据类型，整个世界都是String，缺乏结构，不便于编程
3. 对服务端而言，解释得也相当复杂。
总之，就是有一系列问题。所以在Solr5.3，Yonik小哥带来这个。当然，我们Solr的JSON解析器用的就是Noggit。
Noggit是非常牛比，非常最效，非常新颖的JSON解析器。她是流式JSON解释器，同时她还**扩展JSON格式**，使得她的结构更加简洁，优雅。想了解她更牛比之处请阅读noggit项目首页。
这就是JSON Request API出现的背景，当然动机就是针对这些痛点进行优化，一方面有利于推广Solr的搜索统计功能；二方面优化搜索解析效率、优化使用体验。
二、用法
在过去，我写Blog从不写用法一类的Blog。主要是这一类文章写的非常多，这次为什么要写呢，原因有二。一，Solr6.6正式推出这套API；二，貌似并没多少人关注她。这么好的特征，不能让她一直默默无闻。
虽然Noggit已经非常简洁好看，但是她在浏览器的地址栏里编辑还非常不好方便的。但我依然她觉得非常好，特别在她提供一系列非常好用的Facet Statistics & Aggregations Function。之前没有她的时候，我们要写这些查询，非常苦痛的，除了可能需要用到stats查询之外，还很有用可能需要用到非常用的Query Function。（这也可能就是Solr一直很搜索的原因吧。）
因此，非常有必要来推广她，不能让这个世界都是ElasticSearch。
好了，回归正题，先看来几个Query。
Query #1. 直接POST
原来写法 http://solr.daming.com/solr/daming/select?q=helloWorld
JSON Request API写法 $ curl http://solr.daming.com/solr/daming -d '{ query : "helloWorld" }' 非常清淅，特别是熟悉ElasticSearch的同学们，可谓是ElasticSearch转向Solr的一条桥梁。
query #2. HttpGet Method
JSON Request API作为新版的query api，其实它也是相当成熟了的，功能也相当丰富，也基本兼容旧版API。当是HttpGet是需要一个参数来接收我们新版JSON Request内容的。通过Parameter json={}的方式来接收JSON Request API的查询语句，且新版API与旧版API完全兼容，即是可以一起来描述一个查询请求。
这种情况下，JSON Request API完全就是原来查询语法的一个扩展，即是多出一个叫json的新参数。
$ curl http://localhost:8983/solr/query -d 'json={query:"hero"}&fq=author:brandon'
Query #3 来看一个完整的示例
老实说，JSONS Request API定义真的是非常人性化、贴近自然语言。
全文阅读http://click.aliyun.com/m/23536/
一、背景与动机
JSON Request API是由noggit作者（同时也Solr Committer Leader）在Solr.5.3带来新特性，意在改善Solr原来复杂且又丑陋查询语法。
注：JSON Request API与Solr API v2并不是一回来，JSON Request API是一种新型Solr Query DSL。API v2新版本查询API，是基于Restful API实现的。当然JSON Request API显然是基于JSON实现的咯。
不过Request API还是API v2都是Solr学习ElasticSearch靠近的表现。
以前想写简单查询其实也没有很复杂，就是写个q参数，然后指定一下rows和sort嘛，但是对于用Solr来做统计相关工作的同学，还是觉得挺烦的。因为它
1. 冗长，没有结构，容易出错，难于校验和debug。f.facet_field_name.facet.range.start=5
2. 没有数据类型，整个世界都是String，缺乏结构，不便于编程
3. 对服务端而言，解释得也相当复杂。
总之，就是有一系列问题。所以在Solr5.3，Yonik小哥带来这个。当然，我们Solr的JSON解析器用的就是Noggit。
Noggit是非常牛比，非常最效，非常新颖的JSON解析器。她是流式JSON解释器，同时她还**扩展JSON格式**，使得她的结构更加简洁，优雅。想了解她更牛比之处请阅读noggit项目首页。
这就是JSON Request API出现的背景，当然动机就是针对这些痛点进行优化，一方面有利于推广Solr的搜索统计功能；二方面优化搜索解析效率、优化使用体验。
二、用法
在过去，我写Blog从不写用法一类的Blog。主要是这一类文章写的非常多，这次为什么要写呢，原因有二。一，Solr6.6正式推出这套API；二，貌似并没多少人关注她。这么好的特征，不能让她一直默默无闻。
虽然Noggit已经非常简洁好看，但是她在浏览器的地址栏里编辑还非常不好方便的。但我依然她觉得非常好，特别在她提供一系列非常好用的Facet Statistics & Aggregations Function。之前没有她的时候，我们要写这些查询，非常苦痛的，除了可能需要用到stats查询之外，还很有用可能需要用到非常用的Query Function。（这也可能就是Solr一直很搜索的原因吧。）
因此，非常有必要来推广她，不能让这个世界都是ElasticSearch。
好了，回归正题，先看来几个Query。
Query #1. 直接POST
原来写法 http://solr.daming.com/solr/daming/select?q=helloWorld
JSON Request API写法 $ curl http://solr.daming.com/solr/daming -d '{ query : "helloWorld" }' 非常清淅，特别是熟悉ElasticSearch的同学们，可谓是ElasticSearch转向Solr的一条桥梁。
query #2. HttpGet Method
JSON Request API作为新版的query api，其实它也是相当成熟了的，功能也相当丰富，也基本兼容旧版API。当是HttpGet是需要一个参数来接收我们新版JSON Request内容的。通过Parameter json={}的方式来接收JSON Request API的查询语句，且新版API与旧版API完全兼容，即是可以一起来描述一个查询请求。
这种情况下，JSON Request API完全就是原来查询语法的一个扩展，即是多出一个叫json的新参数。
$ curl http://localhost:8983/solr/query -d 'json={query:"hero"}&fq=author:brandon'
Query #3 来看一个完整的示例
老实说，JSONS Request API定义真的是非常人性化、贴近自然语言。
全文阅读http://click.aliyun.com/m/23536/
上一篇： 《Netty权威指南》 试读
下一篇： 数据结构算法求边权和【数学 | 模拟】