Easy-Es

成为赞助商

# ⛵赞助商

Postcat

强大、开源、跨平台的 API 开发测试工具...

AgileBPM

快速、简洁且强大的低代码工作流开发平台...

MaxKey

业界领先、安全、可靠的身份管理和单点登录产品...

明道云

快速响应业务需求，从“IT背锅侠”变成“IT英雄”

- name: Postcat
  desc: 强大、开源、跨平台的 API 开发测试工具...
  avatar: /img/sponsor/postcat-logo.png
  link: https://datayi.cn/w/4PY7qq59
  bgColor: '#FFB6C1'
  textColor: '#FFFFFF'

- name: AgileBPM
  desc: 快速、简洁且强大的低代码工作流开发平台...
  avatar: /img/sponsor/agile-logo.png
  link: https://www.tongzhouyun.com/
  bgColor: '#FFB6C1'
  textColor: '#FFFFFF'
  
- name: MaxKey
  desc: 业界领先、安全、可靠的身份管理和单点登录产品...
  avatar: /img/sponsor/maxkey-logo.jpg
  link: http://maxkey.top/
  bgColor: '#FFB6C1'
  textColor: '#FFFFFF'

- name: 明道云
  desc: 快速响应业务需求，从“IT背锅侠”变成“IT英雄”
  avatar: /img/sponsor/mingdao-logo.jpg
  link: https://www.mingdao.com/
  bgColor: '#00BFFF'
  textColor: '#FFFFFF'

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

# 🍬特性

零侵入：针对ES官方提供的RestHighLevelClient只做增强不做改变，引入EE不会对现有工程产生影响，使用体验如丝般顺滑。
损耗小：启动即会自动注入基本 CURD，性能基本无损耗，直接面向对象操作。
自动化: 全球领先的哥哥你不用动,索引我全自动模式,帮助开发者和运维杜绝索引困扰。
智能化: 根据索引类型和当前查询类型上下文综合智能判断当前查询是否需要拼接.keyword后缀,减少小白误用的可能。
强大的 CRUD 操作：内置通用 Mapper，仅仅通过少量配置即可实现大部分 CRUD 操作，更有强大的条件构造器，满足各类使用需求。
支持 Lambda 形式调用：通过 Lambda 表达式，方便的编写各类查询条件，无需再担心字段写错段。
支持主键自动生成：支持多种主键策略，可自由配置，完美解决主键问题。
支持 ActiveRecord 模式：支持 ActiveRecord 形式调用，实体类只需继承 Model 类即可进行强大的 CRUD 操作。
支持自定义全局通用操作：支持全局通用方法注入（ Write once, use anywhere ）。
内置分页插件：基于RestHighLevelClient 物理分页，开发者无需关心具体操作，且无需额外配置插件，写分页等同于普通 List 查询,比MP的PageHelper插件用起来更简单，且保持与其同样的分页返回字段,无需担心命名影响。
MySQL功能全覆盖:MySQL中支持的功能通过EE都可以轻松实现。
支持ES高阶语法:支持聚合,嵌套,父子类型,高亮搜索,分词查询,权重查询,Geo地理位置查询,IP查询等高阶语法，应有尽有。
良好的拓展性:底层仍使用RestHighLevelClient，可保持其拓展性，开发者在使用EE的同时，仍可使用RestHighLevelClient的所有功能。

# ✨最新版本 Latest Version: (opens new window)

Maven:

<dependency>
    <groupId>org.dromara.easy-es</groupId>
    <artifactId>easy-es-boot-starter</artifactId>
    <version>${Latest Version}</version>
</dependency>

1
2
3
4
5

Gradle:

compile group: 'org.dromara.easy-es', name: 'easy-es-boot-starter', version: 'Latest Version'

版本稳定吗？

在版本发布前,我们针对每项功能我们都有测试用例覆盖,

单元测试用例综合覆盖率超95%,已上线的所有功能均有测试用例覆盖,且经过生产环境和开源社区大量用户使用验证,

另外我们针对整个框架的性能,安全等方面都做了理论分析+实际测试,确保每位用户用得放心,具体可查看文档顾虑粉碎模块.

我们由Star总数超10万的Dromara社区孵化,并有良好的社区答疑群.基本上有问必答，如出现bug,通常2个工作日内必解决.

引入EE即引入了ES所需最小全部依赖,无需再额外去研究和引入ES所需依赖,我们对所有项目透明,代码零侵入,引入不影响您

当前项目的所有功能,底层是RestHighLevelClient,引入后您依旧可以使用RestHighLevelClient全部功能,并且可以

享受到EE为您提供的各种开箱即用的功能和解放双手的智能化套件.

所以,请您放心引入使用！

# 安全

我们已接入OSCS墨菲安全扫描ee源码中未被扫描出任何风险项，并且框架采用Apache2.0许可协议，确保人畜无害！大家可放心使用，当然如果您仍不放心，我们推荐您在使用前下载ee源码亲自阅读一番，我们是100%开源，是否有风险您一看便知。

# 🎉致谢

Easy-Es自从2021年开源以来，获得了很多人的支持。目前社区群答疑总计超千人，收获Star超3K，尽管这算不上很多,但对于ES这种高门槛,低频使用的工具,已经算得上优秀了,而且开源至今时间不超1年，

这离不开社区小伙伴的支持和意见以及PR,感谢你们!我们会秉承"把简单,易用,方便留给用户,把复杂留给框架"的理念,致力于实现"让天下没有难用的ES"愿景,继续砥砺前行!

# 🏡代码托管

# 💪🏻参与开发

欢迎各路好汉一起来参与完善 Easy-Es，我们期待您的 PR！

如果您想贡献，请先查看参与贡献。

# 📚 知识星球

# 🤝 Dromara 组织项目

为往圣继绝学,一个人或许能走的更快,但一群人会走的更远!