Spring Boot 从入门到精通(十)整合 MongoDB 实现读写非关系型数据库

来源:素文宅博客

地址:https://blog.yoodb.com/yoodb/article/detail/1578

MongoDB是一个开源的NoSQL文档数据库。它可以存储多种数据结构,类似JSON的BSON,可以存储复杂数据类型。

Spring Boot 从入门到精通(十)整合 MongoDB 实现读写非关系型数据库

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

参考如图所示:

Spring Boot 从入门到精通(十)整合 MongoDB 实现读写非关系型数据库

2、下载mongodb-win32-x86_64-2012plus-4.2.5.zip文件压缩包为例,解压文件后目录如下:
Spring Boot 从入门到精通(十)整合 MongoDB 实现读写非关系型数据库

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

Spring Boot 从入门到精通(十)整合 MongoDB 实现读写非关系型数据库
Spring Boot 从入门到精通(十)整合 MongoDB 实现读写非关系型数据库

4、查看启动情况

在浏览器输入http://localhost:27017 (27017是mongodb的端口号)查看,若显示:

Spring Boot 从入门到精通(十)整合 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数据库,如图所示:

Spring Boot 从入门到精通(十)整合 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系列文章也在持续更新中,大家可以收藏便于后面浏览学习参考。下面大家有时间的话可以试一试,有什么疑问欢迎下方留言。