在本教程中,我们将构建一个Spring Boot应用程序,该应用程序演示如何使用MongoTemplate API访问MongoDB数据库中的数据。

对于MongoDB,我们将使用mLab,它提供了MongoDB数据库即服务平台,因此您甚至不必在计算机上安装MongoDB数据库。

配置

为了快速设置我们的项目,我们将使用一个称为Spring Initializr的工具。使用此工具,我们可以快速提供所需的依赖项列表并下载引导程序:

使用Spring Initializr创建新的Spring Boot项目时,仅选择两个依赖项:

  • Web (Spring Boot Starter Web)
  • MongoDB (MongoDB Starter)

Maven Dependencies

当下载使用Spring Initializr生成的项目并打开其pom.xml文件时,您应该看到添加了以下依赖项:

<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-test</artifactId>     <scope>test</scope>  </dependency></dependencies><build>  <plugins>     <plugin>        <groupId>org.springframework.boot</groupId>        <artifactId>spring-boot-maven-plugin</artifactId>     </plugin>  </plugins></build>

项目结构

在继续进行并开始处理该项目的代码之前,让我们介绍一下完成所有代码添加到项目后将拥有的项目结构:

该代码以多个程序包进行组织,因此遵循关注点分离的原则,并且代码保持模块化。

创建数据库

对于MongoDB,我们将使用mLab。您可以使用mLab创建一个免费帐户,并在云中使用MongoDB,而无需在计算机上下载和安装它。

登录到mLab后,您将看到一个类似的仪表板:

要创建一个新的MongoDB数据库,请单击创建新按钮:

输入所有详细信息后,我们可以确认:

完成此操作后,我们将看到一个连接字符串,如下图所示:

在开始使用此数据库之前,我们还需要创建一个用户。让我们在上图所示的“用户”标签上执行此操作:

现在,我们已经准备好继续写些Java代码,因为我们的mLab数据库已经完全准备就绪。

应用配置

使用Spring Boot,仅使用MongoDB连接String的单个必需属性即可轻松配置我们的应用程序:

# application propertiesserver.port=8090# MongoDB propertiesspring.data.mongodb.uri=mongodb://cicoding.cn:password@ds915721.mlab.com:29670/cicoding_db

我们只是提供了一个MongoDB连接字符串,该字符串将由Spring Boot读取,并且将使用内部API建立连接。

建立模型

我们将创建一个简单的Person实体,其中包含一些字段,我们将使用它们来演示简单的MongoDB查询:

package com.cicoding.mongotemplatedemo.model;import org.springframework.data.annotation.Id;import org.springframework.data.mongodb.core.mapping.Document;import java.util.Calendar;import java.util.Date;import java.util.List;import java.util.Locale;import static java.util.Calendar.DATE;import static java.util.Calendar.MONTH;import static java.util.Calendar.YEAR;@Document(collection = "person")public class Person {   @Id   private String personId;   private String name;   private long age;   private List<String> favoriteBooks;   private Date dateOfBirth;   public Person() {   }   public Person(String name, List<String> childrenName, Date dateOfBirth) {       this.name = name;       this.favoriteBooks = childrenName;       this.dateOfBirth = dateOfBirth;       this.age = getDiffYears(dateOfBirth, new Date());   }   // standard getters and setters   private int getDiffYears(Date first, Date last) {       Calendar a = getCalendar(first);       Calendar b = getCalendar(last);       int diff = b.get(YEAR) - a.get(YEAR);       if (a.get(MONTH) > b.get(MONTH) ||               (a.get(MONTH) == b.get(MONTH) && a.get(DATE) > b.get(DATE))) {           diff--;       }       return diff;   }   private Calendar getCalendar(Date date) {       Calendar cal = Calendar.getInstance(Locale.US);       cal.setTime(date);       return cal;   }   @Override   public String toString() {       return String.format("Person{personId='%s', name='%s', age=%d, dateOfBirth=%s}\n",               personId, name, age, dateOfBirth);   }}

除了简单的字段外,我们还添加了一些帮助程序功能,可以在保存用户的出生日期时计算该用户的年龄。这使我们不必计算用户的年龄。

定义数据访问层接口

让我们定义一个数据层接口,该接口将通知我们在应用程序中将演示多少操作。这是界面:

public interface PersonDAL {   Person savePerson(Person person);   List<Person> getAllPerson();   List<Person> getAllPersonPaginated(      int pageNumber, int pageSize);   Person findOneByName(String name);   List<Person> findByName(String name);   List<Person> findByBirthDateAfter(Date date);   List<Person> findByAgeRange(int lowerBound, int upperBound);   List<Person> findByFavoriteBooks(String favoriteBook);   void updateMultiplePersonAge();   Person updateOnePerson(Person person);   void deletePerson(Person person);}

这些是相当多的操作。真正的乐趣是当我们执行这些操作时,接下来将要做的事情。

实施数据访问层

我们将使用MongoTemplate bean,它是由Spring Boot使用上面在application.properties中定义的属性初始化的。让我们看看如何定义所需的bean:

@Repositorypublic class PersonDALImpl implements PersonDAL {    private final MongoTemplate mongoTemplate;    @Autowired    public PersonDALImpl(MongoTemplate mongoTemplate) {        this.mongoTemplate = mongoTemplate;    }    ...}

我们将开始使用简单的方法来理解查询,首先是要保存并从数据库中获取所有人员:

@Overridepublic Person savePerson(Person person) {   mongoTemplate.save(person);   return person;}@Overridepublic List<Person> getAllPerson() {   return mongoTemplate.findAll(Person.class);}

MongoTemplate为我们提供了一些抽象方法,通过这些方法我们可以将对象保存到数据库中,也可以从数据库中获取所有数据。

使用分页查询

上述从数据库中获取所有人的方法的问题在于,数据库中可能有数千个对象。 我们应该始终在查询中实现分页,以便可以确保仅从数据库中提取有限的数据:

@Overridepublic List<Person> getAllPersonPaginated(int pageNumber, int pageSize) {   Query query = new Query();   query.skip(pageNumber * pageSize);   query.limit(pageSize);   return mongoTemplate.find(query, Person.class);}

这样,一次将仅从数据库中获取pageSize个对象。

通过精确值获取对象

我们也可以通过匹配数据库中的精确值来提取对象:

@Overridepublic Person findOneByName(String name) {   Query query = new Query();   query.addCriteria(Criteria.where("name").is(name));   return mongoTemplate.findOne(query, Person.class);}@Overridepublic List<Person> findByName(String name) {   Query query = new Query();   query.addCriteria(Criteria.where("name").is(name));   return mongoTemplate.find(query, Person.class);}

我们展示了两种方法。第一种方法是从数据库中获取单个对象,而第二种方法是从数据库中获取具有匹配条件的所有对象。

按范围和数据列表查找

我们还可以找到具有指定范围内的字段值的对象。或具有特定日期之后的日期数据的对象。让我们看看如何做到这一点,以及如何构造相同的查询:

@Overridepublic List<Person> findByBirthDateAfter(Date date) {   Query query = new Query();   query.addCriteria(Criteria.where("dateOfBirth").gt(date));   return mongoTemplate.find(query, Person.class);}@Overridepublic List<Person> findByAgeRange(int lowerBound, int upperBound) {   Query query = new Query();   query.addCriteria(Criteria.where("age").gt(lowerBound)           .andOperator(Criteria.where("age").lt(upperBound)));   return mongoTemplate.find(query, Person.class);}@Overridepublic List<Person> findByFavoriteBooks(String favoriteBook) {   Query query = new Query();   query.addCriteria(Criteria.where("favoriteBooks").in(favoriteBook));   return mongoTemplate.find(query, Person.class);}

更新对象

我们可以使用Update查询更新MongoDB中的数据。我们可以找到一个对象,然后自己更新提供的字段:

@Overridepublic void updateMultiplePersonAge() {   Query query = new Query();   Update update = new Update().inc("age", 1);   mongoTemplate.findAndModify(query, update, Person.class);;}@Overridepublic Person updateOnePerson(Person person) {   mongoTemplate.save(person);   return person;}

在第一个查询中,由于没有向查询添加任何条件,因此我们收到了所有对象。接下来,我们提供了一个Update子句,其中所有用户的年龄都增加了一个。

删除对象

删除对象也与单个方法调用有关:

@Overridepublic void deletePerson(Person person) {   mongoTemplate.remove(person);}

我们也可以简单地传递Query对象以及要删除的人的ID。

制作命令行运行器

我们将在适当的位置使用命令行运行程序来运行我们的应用程序,该命令行运行程序将提供我们在上面的数据访问层实现中定义的一些功能。这是命令行运行器:

package com.cicoding.mongotemplatedemo;import com.cicoding.mongotemplatedemo.dal.PersonDAL;import com.cicoding.mongotemplatedemo.model.Person;import org.slf4j.Logger;import org.slf4j.LoggerFactory;import org.springframework.beans.factory.annotation.Autowired;import org.springframework.boot.CommandLineRunner;import org.springframework.boot.SpringApplication;import org.springframework.boot.autoconfigure.SpringBootApplication;import java.util.Arrays;import java.util.Date;@SpringBootApplicationpublic class MongoTemplateApp implements CommandLineRunner {  private static final Logger LOG = LoggerFactory.getLogger("cicoding");  private final PersonDAL personDAL;  @Autowired  public MongoTemplateApp(PersonDAL personDAL) {     this.personDAL = personDAL;  }  public static void main(String[] args) {     SpringApplication.run(MongoTemplateApp.class, args);  }  @Override  public void run(String... args) {     personDAL.savePerson(new Person(           "Shubham", Arrays.asList("Harry potter", "Waking Up"), new Date(769372200000L)));     personDAL.savePerson(new Person(           "Sergey", Arrays.asList("Startup Guides", "Java"), new Date(664309800000L)));     personDAL.savePerson(new Person(           "David", Arrays.asList("Harry potter", "Success"), new Date(695845800000L)));     personDAL.savePerson(new Person(           "Ivan", Arrays.asList("Secrets of Butene", "Meeting Success"), new Date(569615400000L)));     personDAL.savePerson(new Person(           "Sergey", Arrays.asList("Harry potter", "Startup Guides"), new Date(348777000000L)));     LOG.info("Getting all data from MongoDB: \n{}",           personDAL.getAllPerson());     LOG.info("Getting paginated data from MongoDB: \n{}",           personDAL.getAllPersonPaginated(0, 2));     LOG.info("Getting person By name 'Sergey': {}",           personDAL.findByName("Sergey"));     LOG.info("Getting all person By name 'Sergey': {}",           personDAL.findOneByName("Sergey"));     LOG.info("Getting people between age 22 & 26: {}",           personDAL.findByAgeRange(22, 26));  }}

我们可以使用一个简单的命令来运行我们的应用程序:

mvn spring-boot:run

运行应用程序后,我们将能够在终端中看到一个简单的输出:

结论

如果我们将MongoTemplate与简单的Spring Data JPA进行比较,它看起来可能很复杂,但是它也使我们对如何构造查询有更多的控制。

Spring Data JPA过多地提取了有关构造什么查询,将哪些条件传递给查询等的详细信息。 使用MongoTemplate,我们可以对查询组成进行更细粒度的控制,Spring Boot为我们提供了易于开发的应用程序。

使用MongoDB的Spring Boot和MongoTemplate教程的更多相关文章

  1. Spring Boot Mybatis 使用教程

    Mybatis 在当下互联网开发环境,十分重要.本章主要讲述 Mybatis 如何使用. 从本系列开始,都需要用到 mysql 数据库 和其他一些参考的数据库.请准备相关环节.本章需要以下环境支撑: ...

  2. Spring Boot JPA 使用教程

    JPA 是 Spring Boot 官方推荐的数据库访问组件,其充分体现了面向对象编程思想,有点像 asp.net 的 EFCore.JPA 也是众多 ORM 的抽象. 从本系列开始,都需要用到 my ...

  3. Spring Boot 2.x教程-Thymeleaf 原理是什么

    layout: post title: Spring Boot 2.x教程-Thymeleaf 原理是什么 categories: SpringBoot description: Spring Boo ...

  4. Spring Boot 2 快速教程:WebFlux 集成 Mongodb(四)

    摘要: 原创出处 https://www.bysocket.com 「公众号:泥瓦匠BYSocket 」欢迎关注和转载,保留摘要,谢谢! 这是泥瓦匠的第104篇原创 文章工程:* JDK 1.8* M ...

  5. WebFlux 集成 Thymeleaf 、 Mongodb 实践 - Spring Boot(六)

    这是泥瓦匠的第105篇原创 文章工程: JDK 1.8 Maven 3.5.2 Spring Boot 2.1.3.RELEASE 工程名:springboot-webflux-5-thymeleaf ...

  6. Spring Boot 2 快速教程:WebFlux 集成 Thymeleaf(五)

    号外:为读者持续整理了几份最新教程,覆盖了 Spring Boot.Spring Cloud.微服务架构等PDF.获取方式:关注右侧公众号"泥瓦匠BYSocket",来领取吧! 摘 ...

  7. Spring Boot 2 快速教程:WebFlux Restful CRUD 实践(三)

    摘要: 原创出处 https://www.bysocket.com 「公众号:泥瓦匠BYSocket 」欢迎关注和转载,保留摘要,谢谢! 这是泥瓦匠的第102篇原创 03:WebFlux Web CR ...

  8. Spring Boot 2 快速教程:WebFlux 快速入门(二)

    摘要: 原创出处 https://www.bysocket.com 「公众号:泥瓦匠BYSocket 」欢迎关注和转载,保留摘要,谢谢! 02:WebFlux 快速入门实践 文章工程: JDK 1.8 ...

  9. Spring Boot 2.0 教程 | AOP 切面统一打印请求日志

    欢迎关注微信公众号: 小哈学Java 文章首发于个人网站 https://www.exception.site/springboot/spring-boot-aop-web-request 本节中,您 ...

随机推荐

  1. Catalan数的理解

    Catalan数的理解 f(0)=1 f(1)=1 f(2)=2 f(3)=5 f(4)=14 f(5)=42     f(2)=f(1)+f(1)   f(3)=f(2)+f(1)*f(1)*f(2 ...

  2. 使用grep过滤make的输出内容

    make的输出内容其实分为两种,有些是到标准输出,有些是到标准错误,由于标准输出和标准错误默认都是屏幕,所以平时区分不出来, 实际上一般是error和warning信息到标准错误,其余的到标准输出. ...

  3. C语言I博客作业07

    这个作业属于那个课程 C语言程序设计II 这个作业要求在哪里 https://edu.cnblogs.com/campus/zswxy/SE2019-1/homework/9931 我在这个课程的目标 ...

  4. [2018-01-12] python 当天学习笔记

    Python模块 Python欧快(Moudule),是一个Python文件,以.py结尾,包含了Python对象定义和Python语句. 模块让你能够有逻辑地组织你的Python代码段. 把相关的代 ...

  5. SasS 设计原则十二因素

    Heroku 是业内知名的云应用平台,从对外提供服务以来,他们已经有上百万应用的托管和运营经验.其创始人 Adam Wiggins 根据这些经验,发布了一个“十二要素应用宣言(The Twelve-F ...

  6. OpenCV图像处理以及人脸识别

    OpenCV基础 OpenCV是一个开源的计算机视觉库.提供了很多图像处理常用的工具 批注:本文所有图片数据都在我的GitHub仓库 读取图片并显示 import numpy as np import ...

  7. 使用Typescript重构axios(九)——异常处理:基础版

    0. 系列文章 1.使用Typescript重构axios(一)--写在最前面 2.使用Typescript重构axios(二)--项目起手,跑通流程 3.使用Typescript重构axios(三) ...

  8. Promise A+ 规范【中文版】

    0. 前言 本文为Promise A+规范的中文译文,Promise A+规范英文版原文链接:Promise A+. 正文如下: 一个开放.健全且通用的 JavaScript Promise 标准.由 ...

  9. ELK分布式日志+NLog在.NetCore中的应用

    一.ELK简介 ELK是Elasticsearch.Logstash和Kibana首字母的缩写.这三者均是开源软件,这三套开源工具组合起来形成了一套强大的集中式日志管理平台 Elasticsearch ...

  10. JavaScript BOM学习

    Mirror王宇阳 2019年11月13日 [首发] 数日没有更新博文了,觉得不好意思了!这不是,整理了一下JavaScript的一下BOM笔记资料,今天贡献出来!(HTML DOM也会随后整理发表) ...