SpringBoot集成ElasticSearch以及通过ElasticSearch的Java API实现增删改查

一、简介

ElasticSearch，简称ES， 是一个基于Lucene的分布式可扩展的实时搜索和分析引擎，是基于分词和分段的全文搜索引擎，具有分词，同义词，词干查询的功能，ES天生具有分布式和实时的属性。当然 Elasticsearch 并不仅仅是 Lucene 那么简单，它不仅包括了全文搜索功能，还可以进行以下工作:

分布式实时文件存储，并将每一个字段都编入索引，使其可以被搜索。ElasticSearch 的实现原理主要分为以下几个步骤：

1．用户将数据提交到Elastic Search 数据库中。

2．通过分词控制器去将对应的语句分词，将其权重和分词结果一并存入数据，

3．当用户搜索数据时候，再根据权重将结果排名，打分。

4．将返回结果呈现给用户。

二、基本概念

先说Elasticsearch的文件存储，Elasticsearch是面向文档型数据库，一条数据在这里就是一个文档，用JSON作为文档序列化的格式，比如这条JSON格式的用户数据：{ "id" : 1, "name" : "ZhangSan", "sex" : "Male","age" : 25 }

如果用Mysql这样的关系型数据库存储，我们容易想到建立一张User表，有id，name，sex，age字段，在Elasticsearch中，这些数据就是一个文档，当然这个文档会属于一个User的类型，各种各样的类型存在一个索引中。这里通过下面对照表，将Elasticsearch和关系型数据术语进行对照：

关系数据库: ⇒ 数据库 ⇒ 表 ⇒ 行 ⇒ 列(Columns)

Elasticsearch: ⇒ 索引(Index) ⇒ 类型(type) ⇒ 文档(Docments) ⇒ 字段(Fields)

其余的专业术语以及相关概念知识网上很多，开发者敬请自行去查看，此处不再赘述，下面通过完整的案例来演示从ES环境搭建到ES实现增删改查功能以及ES的常规的Java API。

三、环境搭建

1、安装Java环境

下载安装Java JDK和配置JAVA_HOME环境变量，建议1.8及以上版本的JDK

2、搭建ElasticSearch环境

这里笔者安装的6.3.1的版本，点击这里去官网下载安装包，安装教程非常简单，自行百度。安装完记得修改配置文件配置 elasticsearch-6.3.1/config/elasticsearch.yml。

# 集群名字
cluster.name: es-6.3.1-test
# 节点名字
node.name: node-101
# 标识master节点
node.master: true
# 设成0.0.0.0让任何人都可以访问，线上服务不要这样设置。
network.host: 0.0.0.0
http.port: 9200
# 解决elasticsearch-head 集群健康值: 未连接问题
http.cors.enabled: true
http.cors.allow-origin: "*"

3、安装Ｎodejs环境

按照下面的head插件之前 首先要安装Ｎodejs，下载地址：https://nodejs.org/en/，安装完之后配置环境变量NODE_HOME

4、安装head插件

为了便于管理ES，通常使用elasticsearch-head-master（简称head）插件，这是一款ES的客户端可视化管理工具，在浏览器中显示ES集群，索引等信息，十分简便好用。（其实也就相当于mysql的客户端可视化工具Navicat ）

点这里下载，下载后解压elasticsearch-head-master到 D:\elasticsearch-6.3.1\elasticsearch-head-master目录， 在elasticsearch-head-master目录下执行npm install 安装依赖，安装完依赖修改插件配置文件，修改服务器监听地址：Gruntfile.js   grunt 是基于Node.js的项目构建工具，可以进行打包压缩、测试、执行等工作，head插件就是通过grunt启动。

connect: {
  server: {
	options: {
		port: 9100,
		base: '.',
		keepalive: true,
		hostname: '*'
	}
  }
}

在插件目录执行 grunt server 命令 启动运行head服务 ，如下图表示启动成功。

访问head管理页面，地址:http://localhost:9100/ ，界面如下：

到此服务端环境搭建好了，下面通过一个springboot项目通过ES的Java API实现增删改查功能

四、通过Elasticsearch的Java API实现增删改查

首先创建一个springboot项目，在application.yml修改添加以下配置

spring: 
  application:
    name: springboot-elasticsearch
  instance:
    instance-id: ${spring.application.name}:${server.port} 
  data:
    elasticsearch:
      repositories:
        abled: true
      # 此处填写刚才搭建的服务端环境的IP地址，集群的话，多个之间逗号隔开
      cluster-nodes: 127.0.0.1:9300
      # 集群名字，跟服务端环境配置文件里的名字保持一致
      cluster-name: es-6.3.1-test

pom文件添加elasticsearch的客户端依赖

<dependency>
  <groupId>org.elasticsearch.client</groupId>
  <artifactId>elasticsearch-rest-client</artifactId>
 </dependency>
<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-data-elasticsearch</artifactId>
</dependency>

创建User实体信息，注意注解@Document的属性indexName和type的值，不支持驼峰规则。

这里的indexName 和type ，如果和传统型数据库比较的话，就相当于库和表。需要注意：indexName和type都必须是小写!

@Document(indexName = "sysuser", type = "user")
public class User implements Serializable{

	/**
	 * 
	 */
	private static final long serialVersionUID = -595647652352120839L;
	
	@Id
	private String id;

	private String userName;
	
	private String password;
	
	private Integer sex;

	public String getUserName() {
		return userName;
	}

	public void setUserName(String userName) {
		this.userName = userName;
	}

	public String getPassword() {
		return password;
	}

	public void setPassword(String password) {
		this.password = password;
	}

	public Integer getSex() {
		return sex;
	}

	public void setSex(Integer sex) {
		this.sex = sex;
	}
	
	public String getId() {
		return id;
	}

	public void setId(String id) {
		this.id = id;
	}
}

下面编写接口的Controller

@Controller
@RequestMapping(value="/es/demo")
public class UserController {

	@Autowired
	private IUserService   userServiceImpl;
	
	@GetMapping(value = "/getList")
	@ResponseBody
	public List<User> getList(@RequestParam("name") String name){
		List<User> list = userServiceImpl.getByName(name);
		return list;
	}
	
	@PostMapping(value = "/create")
	@ResponseBody
	public boolean create(@RequestBody User u){
		boolean flag = userServiceImpl.insert(u);
		return flag;
	}
}

下面编写接口的Service

public interface IUserService {

	public List<User> getByName(String name);
	
	public boolean insert(User user) ;
}

下面编写接口的Service实现类

@Service
public class UserServiceImpl implements IUserService {

	@Autowired
	private UserMapper<?>  userMapper;
	
	
	@Override
	public List<User> getByName(String name) {
		QueryBuilder builder = QueryBuilders.prefixQuery("userName",name);
		//QueryBuilder builder = new QueryStringQueryBuilder(name);
		System.out.println("前缀模糊查询的语句:"+builder);
		Iterable<User> searchResult = userMapper.search(builder);
        Iterator<User> iterator = searchResult.iterator();
        List<User> list=new ArrayList<User>();
        while (iterator.hasNext()) {
          list.add(iterator.next());
        }
     return list;
	}

	@Override
	public boolean insert(User user) {
		boolean falg=false;
        try{
        	userMapper.save(user);
            falg=true;
        }catch(Exception e){
            e.printStackTrace();
        }
        return falg;
	}
}

现在在postman上请求数据创建create接口 http://localhost:8080/es/demo/create，创建几条数据，然后请求查询接口getList，对字段userName通过关键字"guo"搜索，可以看到请求的数据是正常的，同时在控制台也打印出了下面的查询日志信息

前缀模糊查询的语句:{
  "prefix" : {
    "userName" : {
      "value" : "guo",
      "boost" : 1.0
    }
  }
}

到此通过完整的流程通过springboot项目集成elasticsearch以及通过ES的Java API实现了增删改查，更多高级功能敬请期待下次教程以及案例分享，联系笔者请假微信：18629374628