https://github.com/noear/esearchx
noear::一个简单的 Elasticsearch ORM 框架（基于 lamabda 表达式，构建类似 sql 的体验）
https://github.com/noear/esearchx
Last synced: 11 months ago
JSON representation
noear::一个简单的 Elasticsearch ORM 框架（基于 lamabda 表达式，构建类似 sql 的体验）
- Host: GitHub
- URL: https://github.com/noear/esearchx
- Owner: noear
- License: apache-2.0
- Created: 2021-10-23T02:39:14.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2024-11-06T03:10:03.000Z (over 1 year ago)
- Last Synced: 2025-04-14T10:55:06.751Z (about 1 year ago)
- Language: Java
- Homepage:
- Size: 250 KB
- Stars: 18
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
EsearchX
Elasticsearch ORM 框架（基于 lamabda 表达式，构建类似 sql 的体验）
### 特点
基于 okhttp + snack3 开发，是一个代码直白和简单的 Elasticsearch ORM 框架。支持 7.x , 8.x
项目里有3个关键的对象概念：
* 执行上下文
* 查询器
* 命令
支持自动序列化和反序列化，以及批量插入、批量更新；脚本查询、聚合查询。
### 快速入门：
```xml
org.noear
esearchx
1.0.27
```
```java
import org.noear.snack.ONode;
//
// 更多的示例，可以查看 src/test/ 下的相关单测
//
public class DemoApp {
String tableCreateDsl = "...";
public void demo() {
//执行前打印dsl
EsGlobal.onCommandBefore(cmd -> System.out.println("dsl:::" + cmd.getDsl()));
//实例化上下文
EsContext esx = new EsContext("localhost:30480");
//创建索引
esx.indiceCreate("user_log_20200101", tableCreateDsl);
esx.indiceCreate("user_log_20200102", tableCreateDsl);
esx.indiceCreate("user_log_20200103", tableCreateDsl);
//构建索引别名
esx.indiceAliases(a -> a
.add("user_log_20200101", "user_log")
.add("user_log_20200102", "user_log")
.add("user_log_20200103", "user_log"));
//删除索引（如果存在就删了；当然也可以直接删）
if (esx.indiceExist("user_log_20200101")) {
esx.indiceDrop("user_log_20200101");
}
//单条插入
LogDo logDo = new LogDo();
esx.indice("user_log").insert(logDo);
//单条插入::增加序列化选项定制
esx.indice("user_log").options(options).insert(logDo);
esx.indice("user_log").options(options -> {
//增加类型编码
options.addEncoder(Long.class, (data, node) -> node.val().setString(String.valueOf(data)));
}).insert(logDo);
//批量插入
List list = new ArrayList<>();
list.add(new LogDo());
esx.indice("user_log").insertList(list);
//带超时设置的批量插入（单位：秒）
esx.indice("user_log").timeout(30).insertList(list);
//单条插入或更新
LogDo logDo = new LogDo();
esx.indice("user_log").upsert("1", logDo);
//批量插入或更新
Map list = new LinkedHashMap<>();
list.put("...", new LogDo());
esx.indice("user_log").upsertList(list);
//一个简单的查询
LogDo result = esx.indice("user_log").selectById(LogDo.class, "1");
//一个带条件的查询
EsData result = esx.indice("user_log")
.where(r -> r.term("level", 5))
.orderByDesc("log_id")
.limit(50)
.selectList(LogDo.class);
//一个结果高亮的查询
Map result = context.indice(indice)
.where(c -> c.match("content", "tag"))
.highlight(h -> h.addField("content", f -> f.preTags("").postTags("")))
.limit(1)
.selectMap();
//一个复杂些的查询
EsData result = esx.indice(indice)
.where(c -> c.useScore().must()
.term("tag", "list1")
.range("level", r -> r.gt(3)))
.orderByAsc("level")
.andByAsc("log_id")
.minScore(1)
.limit(50, 50)
.selectList(LogDo.class);
//脚本查询
EsData result = esx.indice(indice)
.where(c -> c.script("doc['tag'].value.length() >= params.len", p -> p.set("len", 2)))
.limit(10)
.selectList(LogDo.class);
//聚合查询
ONode result = esx.indice(indice)
.where(w -> w.term("tag", "list1"))
.limit(0)
.aggs(a -> a.terms("level", t -> t.size(20))
.aggs(a1 -> a1.topHits(2, s -> s.addByAes("log_fulltime"))))
.selectAggs();
//特别复杂的，用原生dsl查
ONode dsl = new ONode();
//...
String resultJson = esx.indice(indice).select(dsl.toJson());
ONode result = ONode.load(resultJson);
}
}
```