Easy-ES终极指南3分钟从Elasticsearch新手到高手还在为Elasticsearch复杂的API和繁琐的配置头疼吗Easy-ES是一个简化Elasticsearch操作的开源框架让你用MySQL语法就能完成ES查询开发效率提升300%这个框架基于Elasticsearch官方RestHighLevelClient 7.10版本开发支持全自动智能索引托管功能丰富度和易用度已全面领先SpringData-Elasticsearch。✨ 为什么你需要Easy-ES传统ES开发 vs Easy-ES对比传统ES查询需要11行代码SearchRequest searchRequest new SearchRequest(document); BoolQueryBuilder boolQueryBuilder QueryBuilders.boolQuery(); TermQueryBuilder titleTerm QueryBuilders.termQuery(title, Hi); // 还要处理异常、解析结果...太复杂Easy-ES只需要1行代码ListDocument documents documentMapper.selectList( EsWrappers.lambdaQuery(Document.class) .eq(Document::getTitle, Hi) .eq(Document::getCreator, Guy) );看到区别了吗Easy-ES让你用最熟悉的MyBatis-Plus语法操作ES学习成本几乎为零 5分钟快速上手教程第1步添加依赖dependency groupIdorg.dromara.easyes/groupId artifactIdeasy-es-boot-starter/artifactId version最新版本/version /dependency第2步配置ES连接easy-es: enable: true address: 127.0.0.1:9200 username: elastic password: 123456第3步创建实体类Data IndexName(easyes_document) public class Document { IndexId(type IdType.CUSTOMIZE) private String id; IndexField(fieldType FieldType.TEXT, analyzer Analyzer.IK_SMART) private String title; IndexField(fieldType FieldType.KEYWORD) private String creator; IndexField(fieldType FieldType.DATE) private Date createTime; }第4步创建Mapper接口public interface DocumentMapper extends BaseEsMapperDocument { // 就这么简单无需写实现类 }第5步开始使用Autowired private DocumentMapper documentMapper; // 增删改查全支持 documentMapper.insert(document); documentMapper.selectById(1); documentMapper.updateById(document); documentMapper.deleteById(1);⚠️ 新手必知的5个避坑技巧1. 版本兼容性选择Elasticsearch版本建议使用7.10.x整个7.x系列都兼容Spring Boot版本推荐2.5.4兼容2.3.x-2.6.xJava版本需要JDK 1.82. 字段类型选择策略Keyword类型适合精确查询类似MySQL普通字段支持eq()、like()、distinct()等操作支持排序和聚合Text类型适合分词查询必须指定分词器否则使用ES默认分词器支持match()等分词查询双类型字段技巧IndexField(fieldType FieldType.KEYWORD_TEXT) private String combinedField; // 查询时combinedField.keyword 用于精确查询 // 查询时combinedField 用于分词查询3. ID字段的特殊性Easy-ES强制要求ID字段因为核心功能如selectById、update、deleteById都依赖IDES本身要求每个文档必须有唯一IDTableId(type IdType.CUSTOMIZE) private String id; // 可以是任意数据类型重要提示当ID已存在时insert操作会执行更新具备幂等性4. 与MyBatis-Plus和平共存如果项目同时使用MP和EE记住这个黄金法则隔离扫描路径mybatis-plus: mapper-locations: classpath:com/yourpackage/mapper/mp/*.xml easy-es: mapper-locations: classpath:com/yourpackage/mapper/ee/*.xml5. 查询条件构建技巧ES使用树形查询结构与MySQL平铺式条件不同// AND条件默认多个条件以AND连接 wrapper.eq(Document::getTitle, Java) .gt(Document::getStarNum, 100); // OR条件需要显式使用or() wrapper.eq(Document::getTitle, Java) .or() .eq(Document::getTitle, Python); 高级功能快速上手智能索引管理Settings(shardsNum 3, replicasNum 2) IndexName(value easyes_document, keepGlobalPrefix true) public class Document { // 框架会自动创建索引无需手动操作 }地理空间查询IndexField(fieldType FieldType.GEO_POINT) private String location; // 查询5公里内的文档 wrapper.geoDistance(Document::getLocation, 40.139337,116.634419, 5.0);嵌套类型支持IndexField(fieldType FieldType.NESTED, nestedOrObjectClass User.class) private ListUser users; // 嵌套查询 wrapper.nestedMatch(Document::getUsers, users.userName, 张三);高亮显示HighLight(mappingField highlightContent, preTag em, postTag /em) IndexField(fieldType FieldType.TEXT, analyzer Analyzer.IK_SMART) private String content; // 查询时自动高亮 wrapper.match(Document::getContent, Elasticsearch); 性能优化小贴士索引策略首次启动开启自动创建生产环境预先设计好mapping分页优化深度分页避免使用from/size改用search_after字段设计频繁查询的字段设为keyword类型连接池合理配置连接池大小避免资源浪费批量操作使用批量接口提升性能 实战场景示例场景1电商商品搜索// 多条件组合查询 LambdaEsQueryWrapperProduct wrapper new LambdaEsQueryWrapper(); wrapper.match(Product::getName, 手机) .eq(Product::getCategory, 电子产品) .between(Product::getPrice, 1000, 5000) .orderByDesc(Product::getSales) .limit(10); ListProduct products productMapper.selectList(wrapper);场景2日志分析// 时间范围聚合统计 LambdaEsQueryWrapperLog wrapper new LambdaEsQueryWrapper(); wrapper.between(Log::getCreateTime, startTime, endTime) .groupBy(Log::getLevel) .count();场景3地理位置服务// 附近的人查询 wrapper.geoDistance(User::getLocation, userLocation, 1.0) // 1公里内 .orderByAsc(Document::getDistance) // 按距离排序 .limit(20);✅ 总结为什么选择Easy-ES极简开发用MySQL语法操作ES学习成本极低全自动索引智能创建、更新、迁移索引零停机Lambda支持类型安全编译期检查避免字段名拼写错误丰富功能支持高亮、地理位置、嵌套、Join等高级特性性能保证基于官方RestHighLevelClient原生性能不打折生态完善支持Spring Boot、Solon等主流框架立即开始克隆仓库https://gitcode.com/gh_mirrors/eas/easy-es体验极简ES开发记住复杂的ES操作不应该成为你的开发瓶颈。Easy-ES让你专注于业务逻辑而不是ES API细节。从今天开始让ES开发变得简单而高效创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考