Func<T,T>应用之Elasticsearch查询语句构造器的开发

前言

　　之前项目中做Elasticsearch相关开发的时候，虽然借助了第三方的组件PlainElastic.Net，但是由于当时不熟悉用法，而选择了自己拼接查询语句。例如：

            string queryGroup = "{\"query\": {\"match\": { \"roomid\": \"FRIEND_12686_10035\" }}}";
            //关键字查询
            string queryKeyWord = "{ \"query\": {\"match_phrase\": {\"content\": {\"query\": \"" + keyword + "\",\"slop\": 0} } }}";
            //是否图片 查询
            string queryImg = "{ \"term\": {\"isimg\": true }}";
            //是否包含文件查询
            string queryFile = "{ \"term\": {\"isfile\": true }}";
            //大于小于某个时间段查询
            string queryTimeRange = "{\"range\": {\"addtime\": { \"gt\": \"" + st + "\",\"lt\": \"" + et + "\" }} }";
            //大于某个时间
            string queryTimeRangeGt = "{\"range\": {\"addtime\": { \"gt\": \"" + st + "\"}} }";
            //小于某个时间
            string queryTimeRangeLt = "{\"range\": {\"addtime\": { \"lt\": \"" + et + "\" }} }";

　　后来慢慢看了下该组件的源代码，想自己简单实现一下，看看到底是什么原理。

分析

　　先来一个简单的小例子：PlainElastic中的demo示例：

　　　　　　string query = new QueryBuilder<Tweet>()        // This will generate:
          .Query(q => q                         // { "query": { "term": { "User": "somebody" } } }
            .Term(t => t
              .Field(tweet=> tweet.User).Value("somebody")
            )
          ).Build();

　　可以看到，构造查询语句的时候很灵活，直接用表达式的形式，最后通过Build方法，生成相应的查询语句，于是乎，照着葫芦画瓢，开始吧。其实，不管如何写语句，最终都是对字符串的拼接，生成最终的查询语句。那我们就从最简单的term查询开始。比如一条查询语句就是 {"query":{"term":{"name":"zhangsan"}}},这条语句的的意思，就是查询 name 为zhangsan的数据。（需要读者懂elasticsearch查询语法）

　　先不考虑封装，直接新建一个类，就叫 TermFilter,内部实现了 Term 的语言构造。由于需要链式调用，所以里面的方法一般都返回  this 。

        private Dictionary<string, object> _terms;
        public TermFilter()
        {
            _terms = new Dictionary<string, object>();
        }
        public TermFilter KeyValue(string key, object value)
        {
            _terms.Add(key, value);
            return this;
        }

　　如上述代码所示，当我们调用KeyValue方法时，传入key和value，添加到内部的Dictionary中。然后重写 ToString 方法，构造Term语句

       private void Build()
        {
            StringBuilder str = new StringBuilder();
            int i = ;
            foreach (KeyValuePair<string, object> kv in _terms)
            {
                str.Append("{\"term\":{\"" + kv.Key + "\":" + kv.Value + "}}");
                if (i >=  && i < _terms.Count - )
                {
                    str.Append(",");
                }
                i++;
            }
            _condition = str.ToString();
        }
        public override string ToString()
        {
            Build();

            return base.ToString();
        }

　　遍历Dictionary，构造term语句，Term构造完之后，我们需要在外层加一个Query，由于Query是通用的，所以也需要提取出。于是乎，又多了一个类，叫做Filter，这个是查询的入口，里面有两个方法，一个Bool方法，一个Query方法：

  　　　public Filter() { }
        //
        public Filter Bool(Func<BoolFilter, BoolFilter> boolFunc)
        {
            string boolFuncResult = boolFunc(new BoolFilter()).ToString();
            _condition = "{\"query\":{\"filtered\":{\"filter\":{" + boolFuncResult + "}}}";
            return this;
        }
        public Filter Query(Func<BoolFilter, BoolFilter> boolFunc)
        {
            string boolFuncResult = boolFunc(new BoolFilter()).ToString();
            _condition = "{\"query\":" + boolFuncResult;
            return this;
        }

　　直接看Query方法，里面的参数为 Func<BoolFilter,BoolFilter> boolFunc，好吧，这里的Boss终于出场了，就是核心类，BoolFilter，它内部实现了，Must，Shoud，MustNot，And，Or，等方法。当然还有Term。我们直接看Term方法。

 public BoolFilter Term(Func<TermFilter, TermFilter> termFunc)
        {
            PrapareCondition();
            _condition += termFunc(new TermFilter());
            return this;
        }

　　同理，因为链式调用，还是返回this，上述代码中由于termFunc 返回的是一个TermFilter对象，然后toString之后，就相当于追加 相应的Term语句。ToString方法最终也是返回 _condition字段的值。好吧，我猜你越来越晕了，没关系，我们在看最后一个类，就可以实战了。

      public QueryCreator Filter(Func<Filter, Filter> filter)
        {
            _condition += filter(new Filter());
            return this;
        }

　　好了，到这里，代码基本结束了。重新梳理一遍：

　　首先，最外层代码调用Filter方法，Filter实现了Query方法，Query内部传入了BoolFilter参数，在调用Term方法，最终由TermFilter实现语句的构造，所以，外部最终代码调用起来是这样的。

var result = creator.Filter(f =>  //Filter内部调用Query方法，
                                            f.Query(q => //Query调用BoolFilter的Term方法
                                                        q.Term(t => //BoolFilter又调用TermFilter的KeyValue方法
                                                                    t.KeyValue("name", "zhangsan"))))
                                                                    .BuildBeautiful();//最后构造出我们想要的结果

　　

如上图，from和size是默认的。下面我们来个稍微复杂点的。比如在一个用户表，想要查询 用户类型为 3 的且地区为 北京 的 并且满足 年龄是 20  岁或者 工作经验为1年 的用户。并且根据 姓名倒叙排序，分页取第3页的20条数据。

首先分析一下，这里我们要使用 and 查询，and 里面还包括  or 查询。 构造语句如下：

  　　　　　　var result = creator.Filter(f =>
                                            f.Bool(b => //bool查询
                                            b.Must(m => //must，必须符合条件
                                            m.And(a => //and查询
                                            a.Term(t => //构造查询条件
                                            t.KeyValue("type", ).KeyValue("area", "北京")).
                                            Or(o => o.Term(t1 => t1.KeyValue("age", ).KeyValue("experience", ))))))).//or查询，构造查询条件
                                            Page().//页码
                                            Size().//每页大小
                                            OrderByDesc("name").//姓名倒叙排序
                                            BuildBeautiful();//根据之前的条件创建查询语句

　　哈哈，是不是有点绕啊，其实要想用这个，还是得会点ES查询语法的，就好比SQL语句一样，你不理解，是查不出东东的。用这种方式我们就能够避免手动写ES查询语句了，只要经过代码简单配制就好喽，不过我还是乖乖用第三方组件吧，自己写的太渣了。。。

看看构造成的语句：

好了就到这里吧。当做自己研究的总结了。