酒店ES搜索
最近跟着师哥着手开发了一个互联酒旅的项目,收获巨多,体验到开发完整的项目过程,review三次以上代码,严格遵守设计规范,代码规范,数据库设计,我主要负责酒店搜索模块,采用最热门的es搜索引擎,下面整个项目的技术选型架构图

一、ES框架介绍
- 项目使用的es版本为7.6.2,对应springboot 2.3.0.RELEASE。
- 中文分词器(IK Analysis),也要选择对应的版本7.6.2,对于使用Kibana和Logstash也是如此。

二、酒店表
DROP TABLE IF EXISTS `hotel`;
CREATE TABLE `hotel` (
`id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键',
`name` varchar(64) NOT NULL DEFAULT '' COMMENT '酒店名称',
`brand` varchar(32) NOT NULL DEFAULT '' COMMENT '酒店品牌',
`city_name` varchar(32) NOT NULL DEFAULT '' COMMENT '城市名称',
`region` varchar(32) NOT NULL DEFAULT '' COMMENT '区域,比如某某市区',
`landmark_nearby` varchar(32) NOT NULL DEFAULT '' COMMENT '附近的地标',
`longitude` varchar(32) NOT NULL DEFAULT '0.0' COMMENT '酒店经度',
`latitude` varchar(32) NOT NULL DEFAULT '0.0' COMMENT '酒店纬度',
`address_detail` varchar(128) NOT NULL DEFAULT '' COMMENT '地址详细信息',
`entry_departure_time` varchar(32) NOT NULL DEFAULT '入住时间:14:00以后 离店时间:12:00以前' COMMENT '入离时间',
`notice` varchar(255) NOT NULL DEFAULT '' COMMENT '注意事项',
`hint` varchar(255) NOT NULL DEFAULT '' COMMENT '酒店提示',
`open_date` datetime NOT NULL DEFAULT '2022-04-06 18:28:59' COMMENT '开业时间',
`decorate_date` datetime NOT NULL DEFAULT '2022-04-06 18:28:59' COMMENT '装修时间',
`room_count` smallint(5) unsigned NOT NULL DEFAULT '0' COMMENT '客房数量',
`introduce` varchar(255) NOT NULL DEFAULT '' COMMENT '酒店介绍',
`grade` tinyint(3) unsigned NOT NULL DEFAULT '3' COMMENT '酒店星级 2:经济型(非星级) 3:舒适型(3星级) 4:高档型(4星级) 5:豪华型(5星级)',
`evaluate_score` int(7) unsigned NOT NULL DEFAULT '3' COMMENT '评分',
`evaluate_count` int(6) unsigned NOT NULL DEFAULT '1' COMMENT '参与评分总人数',
`sale_count` bigint(20) unsigned NOT NULL DEFAULT '0' COMMENT '销售量',
`homepage_image_url` varchar(255) NOT NULL DEFAULT '' COMMENT '首页图片链接',
`collect_count` bigint(20) unsigned NOT NULL DEFAULT '0' COMMENT '收藏人数',
`floor_original_price` bigint(20) unsigned NOT NULL DEFAULT '0' COMMENT '原价',
`floor_special_price` bigint(20) unsigned NOT NULL DEFAULT '0' COMMENT '特价',
`phone1` varchar(32) NOT NULL DEFAULT '' COMMENT '电话1',
`phone2` varchar(32) NOT NULL DEFAULT '' COMMENT '电话2',
`revision` bigint(20) unsigned NOT NULL DEFAULT '1' COMMENT '乐观锁',
`deleted` tinyint(1) NOT NULL DEFAULT '0' COMMENT '禁用启用状态;@values 0|1|2:启用|禁用|暂停营业',
`create_time` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
`update_time` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更改时间',
PRIMARY KEY (`id`) USING BTREE,
UNIQUE KEY `index_hotel_name` (`name`) USING BTREE,
KEY `index_hotel_latitude_and_longititude` (`latitude`,`longitude`) USING BTREE,
KEY `index_hotel_evaluate_score` (`evaluate_score`) USING BTREE,
KEY `index_hotel_collect_count` (`collect_count`) USING BTREE,
KEY `index_hotel_brand` (`brand`) USING BTREE,
KEY `index_hotel_address_detail` (`address_detail`) USING BTREE,
KEY `index_hotel_floor_price` (`floor_original_price`) USING BTREE,
KEY `index_hotel_city_name` (`city_name`) USING BTREE,
KEY `index_hotel_grade` (`grade`) USING BTREE,
KEY `index_hotel_evaluate_count` (`evaluate_count`) USING BTREE,
KEY `index_hotel_open_date` (`open_date`) USING BTREE,
KEY `index_hotel_sale_count` (`sale_count`) USING BTREE,
KEY `index_hotel_special_price` (`floor_special_price`) USING BTREE,
KEY `index_hotel_region` (`region`) USING BTREE,
KEY `index_hotel_landmark_nearby` (`landmark_nearby`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=22 DEFAULT CHARSET=utf8mb4 ROW_FORMAT=DYNAMIC COMMENT='酒店基本信息表';
数据库遵守阿里巴巴设计规范
- 【强制】主键索引名为 pk_字段名;唯一索引名为 uk_字段名;普通索引名则为 idx_字段名。 说明:pk_即 primary
key;uk_即 unique key;idx_即 index 的简称。 - 【强制】小数类型为 decimal,禁止使用 float 和 double。
说明:在存储的时候,float 和 double 都存在精度损失的问题,很可能在比较值的时候,得到不正确的结果。如果存
储的数据范围超过 decimal 的范围,建议将数据拆成整数和小数并分开存储。 - 【强制】表必备三字段:id,create_time,update_time。
说明:其中 id 必为主键,类型为 bigint unsigned、单表时自增、步长为 1。create_time,update_time 的类型均为
datetime 类型,前者现在时表示主动式创建,后者过去分词表示被动式更新。 - 【强制】在数据库中不能使用物理删除操作,要使用逻辑删除。
说明:逻辑删除在数据删除后可以追溯到行为操作。不过会使得一些情况下的唯一主键变得不唯一,需要根据情况来酌
情解决。
三、es配置文件
- 在application.yml中,原来我们用来配置Elasticsearch访问路径和集群名称的配置已经不建议使用了

- es7.0版本的配置文件做了更改,替换成以下配置
spring:
elasticsearch:
rest:
uris: http://localhost:9200
四、搜索实现
- 采用spring data es 框架 -

- es快速开发 采用ElasticsearchRestTemplate模板
@Resource
private ElasticsearchRestTemplate elasticsearchRestTemplate;
- ElasticsearchRestTemplate底层实现采用高版本client

- es搜索字段名称要放到一个常量类里面统一管理

- 地理位置查询
if (ObjectUtil.isNotNull(hotelDTO.getLongitude()) && ObjectUtil.isNotNull(hotelDTO.getLatitude()) && ObjectUtil.isNotNull(hotelDTO.getRange())) {
boolQueryBuilder.must(QueryBuilders.geoDistanceQuery(SearchCode.LOCATION).point(hotelDTO.getLatitude(), hotelDTO.getLongitude())
.distance(hotelDTO.getRange(), DistanceUnit.METERS).geoDistance(GeoDistance.ARC));
}
判断非空统一用hutool工具包,如果前端传入经纬度再进行查询,地理位置查询先传入维度,再传入经度,单位用米,es经纬度字段type类型要指定为"geo_point"
- 酒店星级查询
if (ObjectUtil.isNotNull(hotelDTO.getHotelStars())) {
boolQueryBuilder.must(QueryBuilders.termsQuery(SearchCode.GRADE, (Object[]) hotelDTO.getHotelStars()));
}
酒店星级可以多选,前端要传入数组,QueryBuilders.termsQuery( )方法实现,相当于mysql中的in的操作
//构造数组,初始化需要匹配的值
long[] typeArray = new long[]{0, 1};
boolQueryBuilder.filter(QueryBuilders.termsQuery(“type”, typeArray));
对应的sql语句为:
select * from table_name where type in (0,1);
五、api文档
- 请求参数

- 响应示例

本文介绍了在酒店搜索项目中使用Elasticsearch 7.6.2版本进行搜索的实现,包括ES框架介绍、酒店数据表设计遵循的阿里巴巴设计规范、ES配置文件的变化以及搜索功能的具体实现,如地理位置查询和多条件筛选。文章还提到了使用hutool工具包进行非空判断以及Spring Data ES框架在搜索中的应用。
1895

被折叠的 条评论
为什么被折叠?



