The best elasticsearch highlevel java rest api-----bboss

bboss是一套基于query dsl语法操作和访问分布式搜索引擎Elasticsearch/Opensearch的o/r mapping高性能开发库，底层直接基于 http 协议操作和访问Elasticsearch、Opensearch。基于bboss，可以快速编写出访问和操作Elasticsearch/Opensearch的程序代码，简单、高效、可靠、安全。

快速开始bboss

https://esdoc.bbossgroups.com/#/quickstart

bboss兼容性

兼容性：bboss兼容所有版本Elasticsearch、Spring boot，基于bboss开发的代码，可以无缝对接不同版本的Elasticsearch、Opensearch、Spring boot

bboss	Elasticsearch	spring boot
all	1.x	1.x,2.x
all	2.x	1.x,2.x
all	3.x	1.x,2.x
all	5.x	1.x,2.x
all	6.x	1.x,2.x
all	7.x	1.x,2.x

Opensearch兼容性：1.x,2.x,+

jdk兼容性：jdk 1.7+

典型应用场景

一行代码插入/修改

//添加/修改文档，如果文档id存在则修改，不存在则插入



clientUtil.addDocument("agentinfo",//索引名称

				agentInfo);//需添加/修改的索引数据对象

一行代码分页/高亮检索



ESDatas<TAgentInfo> data //ESDatas为查询结果集对象，封装了返回的当前查询的List<TAgentInfo>结果集和符合条件的总记录数totalSize

            = clientUtil.searchList("trace-*/_search",//查询操作，查询indices trace-*中符合条件的数据

                                "queryServiceByCondition",//通过名称引用配置文件中的query dsl语句

                                traceExtraCriteria,//查询条件封装对象

                                TAgentInfo.class);//指定返回的po对象类型，po对象中的属性与indices表中的文档filed名称保持一致

//获取当前页结果对象列表

        List<TAgentInfo> demos = data.getDatas();

        //获取总记录数

        long totalSize = data.getTotalSize();

根据文档id获取文档



Demo demo = clientUtil.getDocument("demo",//索引表

      "2",//文档id

      Demo.class);//指定返回对象类型

根据字段直接获取文档



String document = clientInterface.getDocumentByField("demo",//索引名称

                  "applicationName.keyword",//字段名称

                  "blackcatdemo2");//字段值

 Map document = clientInterface.getDocumentByField("demo","applicationName.keyword","blackcatdemo2",Map.class);

 DemoPo document = clientInterface.getDocumentByField("demo","applicationName.keyword","blackcatdemo2",DemoPo.class);

一行代码根据字段值进行分页查找



ESDatas<Map> documents = clientInterface.searchListByField("demo",//索引名名称

                                          "applicationName.keyword", //检索字段名称

                                          "blackcatdemo2",//检索值

                                           Map.class,  //返回结果类型，可以是po对象类型也可以是map类型

                                           0,  //分页起始位置

                                           10); //分页每页记录数

//获取当前页结果对象列表

        List<Map> demos = data.getDatas();

        //获取匹配的总记录数

        long totalSize = data.getTotalSize();

一行代码删除文档



clientUtil.deleteDocument("demo",//索引表

          "2");//文档id

一行代码批量删除文档



//批量删除文档

        clientUtil.deleteDocuments("demo",//索引表

                new String[]{"2","3"});//批量删除文档ids

api方法可以指定特定的Elasticsearch 集群进行操作

所有 api 可以直接指定数据源操作，指哪打哪，下面展示了在一段代码里面同时操作两个Elasticsearch集群功能：datasourceName1和datasourceName2



ESDatas<Demo> esDatas1 = 

            clientUtil.searchListWithCluster(datasourceName1,//指定操作的Elasticsearch集群数据源名称

                  "demo1/_search",//demo为索引表，_search为检索操作action

            "searchDatas",//esmapper/demo7.xml中定义的dsl语句

            params,//变量参数

            Demo.class);//返回的文档封装对象类型



ESDatas<Demo> esDatas2 = 

            clientUtil.searchListWithCluster(datasourceName2,//指定操作的Elasticsearch集群数据源名称

                  "demo2/_search",//demo为索引表，_search为检索操作action

            "searchDatas",//esmapper/demo7.xml中定义的dsl语句

            params,//变量参数

            Demo.class);//返回的文档封装对象类型

datasourceName1和datasourceName2 可是两个相同版本的Elasticsearch，亦可以是两个不同版本的Elasticsearch，bboss在兼容性方面是毋庸置疑的。

快速集成，导入BBoss maven坐标:quickstart文档

其他特点