本文的Spring Boot版本为1.5.9,Elasticsearch版本为2.4.4,话不多说,直接上代码。
一、启动Elasticsearch
在官网上下载Elasticsearch后,打开bin目录下的elasticsearch.bat,出现下面的图,就证明成功启动了。
二、新建项目,添加依赖
在创建spring boot项目中,可以在nosql中选择添加Elasticsearch的依赖,完整的依赖如下:
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion> <groupId>cmo.jf.cloud</groupId>
<artifactId>resourceCente</artifactId>
<version>1.0.0</version>
<packaging>war</packaging> <name>Elasticsearch</name>
<description>搜索引擎</description> <parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>1.5.9.RELEASE</version>
<relativePath/> <!-- lookup parent from repository -->
</parent> <properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
<java.version>1.8</java.version>
</properties> <dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-elasticsearch</artifactId>
</dependency> <dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency> <dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-tomcat</artifactId>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
</dependencies> <build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build> </project>
需要注意的是:
1.spring boot2.X版本必须使用Elasticsearch 5.X版本
2.Elasticsearch 2.X的版本必须使用spring boot1.5版本
3.目前spring-boot-starter-data-elasticsearch还不支持Elasticsearch 6.X版本
如果出现版本不兼容,这会出现下面的错误:
NoNodeAvailableException[None of the configured nodes are available: [{#transport#-1}{729dgKKVSF-ti27v2_w68g}{127.0.0.1}{127.0.0.7:9300}]]
三、Elasticsearch的配置文件
和操作数据库一样,我们需要配置好配置文件,才能访问Elasticsearch,配置文件如下:
##端口号
server.port=8888
##es地址
spring.data.elasticsearch.cluster-nodes =127.0.0.1:9300
四、Elasticsearch的实体类
在Elasticsearch中,我们需要创建一个实体类作为索引,简单的理解就是在Elasticsearch中创建数据库和表。
利用@Document注解可以创建数据库和表。其中Document中的参数意义为:
indexName:索引名称 可以理解为数据库名 必须为小写不然会报org.elasticsearch.indices.InvalidIndexNameException异常
type:类型 可以理解为表名
代码如下:
import java.io.Serializable; import org.springframework.data.elasticsearch.annotations.Document; //indexName索引名称 可以理解为数据库名 必须为小写 不然会报org.elasticsearch.indices.InvalidIndexNameException异常
//type类型 可以理解为表名
@Document(indexName = "class",type = "user")
public class User implements Serializable {
//定义成员属性
private Integer id;
private String name;
private Integer age;
private String sex;
public Integer getId() {
return id;
}
public void setId(Integer id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public Integer getAge() {
return age;
}
public void setAge(Integer age) {
this.age = age;
}
public String getSex() {
return sex;
}
public void setSex(String sex) {
this.sex = sex;
}
public User(Integer id, String name, Integer age, String sex) {
super();
this.id = id;
this.name = name;
this.age = age;
this.sex = sex;
}
public User() {
super();
} }
五、创建一个数据访问层
同样,和其他的数据库访问操作一样,我们需要创建一个dao层来操作Elasticsearch,这个dao层类似于mongodb的操作,只需要继承ElasticsearchRepository接口就能实现。
import org.springframework.context.annotation.Configuration;
import org.springframework.data.elasticsearch.repository.ElasticsearchRepository; import cmo.jf.cloud.bean.User; @Configuration
public interface UserMapper extends ElasticsearchRepository<User,Long>{ }
六、创建controller层测试
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController; import cmo.jf.cloud.bean.User;
import cmo.jf.cloud.dao.UserMapper; @RestController
public class UserController {
@Autowired
UserMapper userMapper; // 访问接口地址:localhost:8888/save
//存储数据
@GetMapping("save")
public String save(){
User user = new User(1,"张三",15,"男");
userMapper.save(user);
return "success";
} //访问接口地址:localhost:8888/delete?id=1
//根据ID删除数据
@GetMapping("delete")
public String delete(long id){
userMapper.delete(id);
return "success";
} //访问接口地址:localhost:8888/getOne?id=1
//根据ID查询数据
@GetMapping("getOne")
public User getOne(long id){
User user = userMapper.findOne(id);
return user;
}
}
在添加几条数据后我们访问head插件---ES管理界面可以看到我们添加的数据库在页面上
在数据浏览界面中可以看到我们添加的数据
在基本查询中可以根据表名和条件,查询我们刚才插入的数据
七、项目中出现的错误
直接上错误代码:
Description: Cannot determine embedded database driver class for database type NONE Action: If you want an embedded database please put a supported one on the classpath.
If you have database settings to be loaded from a particular profile you may need to active it (no profiles are currently active).
这个错误是由于打开了spring boot的自动配置数据,但是没有配置数据源,所以报错,解决的方案是直接关闭数据源自动配置,
只需要在启动类上加入:@SpringBootApplication(exclude = {DataSourceAutoConfiguration.class})即可
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration; @SpringBootApplication(exclude = {DataSourceAutoConfiguration.class})
public class ElasticsearchApplication { public static void main(String[] args) {
SpringApplication.run(ElasticsearchApplication.class, args);
}
}
八、小结
这就是spring boot1.5整合ElasticSearch 2.X的操作,本文作为初级学习起来还是有帮助,但是ElasticSearch 中的一些高级操作如:同步数据库,分词器,高亮等都将在后面的文章中进行书写。ElasticSearch 6.X、ElasticSearch 5.X的API方式也和ElasticSearch 2.X不同,我也会放在后面进行讲解。