Spring Boot 从入门到精通(十)整合 MongoDB 实现读写非关系型数据库
来源:素文宅博客
地址:https://blog.yoodb.com/yoodb/article/detail/1578
MongoDB是一个开源的NoSQL文档数据库。它可以存储多种数据结构,类似JSON的BSON,可以存储复杂数据类型。
Spring Boot为使用MongoDB提供了很多便利,包括spring-boot-starter-data-mongodb ‘Starter POM‘。本文学习一下Spring Boot中整合MongoDB数据库,来实现以不同方法读写MongoDB数据库,分别是新建接口类实现MongoRepository接口和直接使用MongoTemplate类两种方法。
MongoDB最大的特点是支持的查询语言非常强大,其语法类似面向对象的方式,可以实现类似关系数据库单表查询的绝大部分功能,而且还支持对数据建立索引。
MongoDB下载安装及启动
1、MongoDB下载https://www.mongodb.com/download-center/community?jmp=docs
参考如图所示:
2、下载mongodb-win32-x86_64-2012plus-4.2.5.zip文件压缩包为例,解压文件后目录如下:
3、启动MongoDB服务1)使用cmd命令切换目录,执行命令如下:
cmd E:\tools\mongodb-win32-x86_64-2012plus-4.2.5\mongodb-win32-x86_64-2012plus-4.2.5\bin
2)启动MongoDB服务,执行命令如下:
mongod --dbpath E:\software\MongoDB\data
4、查看启动情况
在浏览器输入http://localhost:27017 (27017是mongodb的端口号)查看,若显示:
则表示连接成功,反之不成功,可以查看端口是否被占用。
配置及实体类文件
1、pom.xml文件
在pom.xml文件中加入spring-boot-starter-data-mongodb引入对mongodb的访问支持依赖,它的实现依赖spring-data-mongodb,配置信息如下:
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-data-mongodb</artifactId> </dependency>
本项目案例中pom.xml文件配置信息如下:
<?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 https://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>2.2.5.RELEASE</version> <relativePath/> </parent> <groupId>com.yoodb.study.demo06</groupId> <artifactId>springboot-study-demo06</artifactId> <version>0.0.1-SNAPSHOT</version> <packaging>war</packaging> <name>springboot-study-demo06</name> <description>Demo project for Spring Boot</description> <properties> <java.version>1.8</java.version> </properties> <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-data-mongodb</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> <exclusions> <exclusion> <groupId>org.junit.vintage</groupId> <artifactId>junit-vintage-engine</artifactId> </exclusion> </exclusions> </dependency> </dependencies> <build> <plugins> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> </plugin> </plugins> </build> </project>
2、数据源配置
在application.properties文件中增加内容如下:
# mongodb 配置 spring.data.mongodb.uri=mongodb://localhost:27017 spring.data.mongodb.database=selection
3、编写BootUser实体对象
BootUser类文件对应MongoDB数据库表的字段属性值,具体代码如下:
package com.yoodb.study.demo06.entity; import java.io.Serializable; public class BootUser implements Serializable { private String id; private String name; private String detail; public String getId() { return id; } public void setId(String id) { this.id = id; } public String getName() { return name; } public void setName(String name) { this.name = name; } public String getDetail() { return detail; } public void setDetail(String detail) { this.detail = detail; } }
MongoDB读写方式
方式一:MongoRepository接口1、定义UserRepository接口类文件新建repository接口并继承MongoRepository接口,具体代码如下:
package com.yoodb.study.demo06.repository; import com.yoodb.study.demo06.entity.BootUser; import org.springframework.data.mongodb.repository.MongoRepository; import org.springframework.stereotype.Service; @Service public interface UserRepository extends MongoRepository<BootUser, String> { public BootUser save(BootUser user); }
注意:定义接口继承MongoRepository类,在Spring Boot框架中若查询一些数据,只需要按照格式写一个接口名和对应的参数即可。
2、定义UserService接口类文件,具体代码如下:
package com.yoodb.study.demo06.service; import com.yoodb.study.demo06.entity.BootUser; import org.springframework.stereotype.Repository; @Repository public interface UserService { public void save(BootUser user); }
3、新建UserService接口类的实现类UserServiceImpl文件,具体代码如下:
package com.yoodb.study.demo06.service.impl; import com.yoodb.study.demo06.entity.BootUser; import com.yoodb.study.demo06.repository.UserRepository; import com.yoodb.study.demo06.service.UserService; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Service; @Service public class UserServiceImpl implements UserService { @Autowired private UserRepository userRepository; public void save(BootUser user) { userRepository.save(user); } }
4、新建HelloWorldController类文件,具体代码如下:
package com.yoodb.study.demo06; import com.yoodb.study.demo06.entity.BootUser; import com.yoodb.study.demo06.service.UserService; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.data.mongodb.core.MongoTemplate; import org.springframework.data.mongodb.core.query.Criteria; import org.springframework.data.mongodb.core.query.Query; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; @RestController public class HelloWorldController { @Autowired private UserService userService; @RequestMapping("save") public boolean save(){ // 插入数据 BootUser user = new BootUser(); user.setId("003"); user.setName("素文宅博客"); user.setDetail("003关注“Java精选”微信公众号,一起进步!"); mongotemplate.save(user); return true; } }
5、启动项目访问地址如下:
http://localhost:8080/save
返回结果如下:
true
数据已存储到MongoDB数据库,如图所示:
方式二:使用MongoTemplate
1、Spring Boot会自动注入mongotemplate,此方式比较简单直接,在之前新建的HelloWorldController类文件,增加代码内容如下:
package com.yoodb.study.demo06; import com.yoodb.study.demo06.entity.BootUser; import com.yoodb.study.demo06.service.UserService; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.data.mongodb.core.MongoTemplate; import org.springframework.data.mongodb.core.query.Criteria; import org.springframework.data.mongodb.core.query.Query; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; @RestController public class HelloWorldController { @Autowired private UserService userService; @Autowired private MongoTemplate mongotemplate; @RequestMapping("save") public boolean save(){ // 插入数据 BootUser user = new BootUser(); user.setId("003"); user.setName("素文宅博客"); user.setDetail("003关注“Java精选”微信公众号,一起进步!"); mongotemplate.save(user); return true; } @RequestMapping("select") public String select(String id){ //查询数据 Query query = new Query(); query.addCriteria(Criteria.where("id").is(id)); String detail = mongotemplate.findOne(query, BootUser.class).getDetail(); return detail; } }
2、启动项目
访问地址如下:
http://localhost:8080/select?id=001
返回结果如下:
001关注“Java精选”微信公众号,一起进步!
本文篇文章的项目源码(springboot-study-demo06)地址:
https://github.com/yoodb/springboot
到此,关于Spring boot整合MongoDB实现读写非关系型数据库的两种方式就讲完了,后续Spring Cloud系列文章也在持续更新中,大家可以收藏便于后面浏览学习参考。下面大家有时间的话可以试一试,有什么疑问欢迎下方留言。