Spring boot 整合 MongoDB

About Time

1.MongoDB简介

MongoDB 是由C++语言编写的，是一个基于分布式文件存储的开源数据库系统。旨在为WEB应用提供可扩展的高性能数据存储解决方案。MongoDB 将数据存储为一个文档，数据结构由键值(key=>value)对组成。MongoDB 文档类似于 JSON 对象。字段值可以包含其他文档，数组及文档数组。

MongoDB是一个介于关系数据库和非关系数据库之间的产品，是非关系数据库当中功能最丰富，最像关系数据库的。他支持的数据结构非常松散，是类似json的bjson格式，因此可以存储比较复杂的数据类型。Mongo最大的特点是他支持的查询语言非常强大，其语法有点类似于面向对象的查询语言，几乎可以实现类似关系数据库单表查询的绝大部分功能，而且还支持对数据建立索引。

传统的关系数据库一般由数据库（database）、表（table）、记录（record）三个层次概念组成，MongoDB是由数据库（database）、集合（collection）、文档对象（document）三个层次组成。MongoDB对于关系型数据库里的表，但是集合中没有列、行和关系概念，这体现了模式自由的特点。MongoDB支持OS X、Linux及Windows等操作系统，并提供了Python，PHP，Ruby，Java及C++语言的驱动程序。

MongoDB的适合对大量或者无固定格式的数据进行存储，比如：日志、缓存等。对事物支持较弱，不适用复杂的多文档（多表）的级联查询。

MongoDB在企业级项目中一般用于存储文档信息、图片资源等，MongoDB的内容完全是以 JSON字符串的形式进行存储的，所以我们在获取数据时通过简单的 反序列化就可以完成与项目内的实体类转换，不过这个过程是自动的，不需要我们手动进行反序列化处理。

2.下载安装MongoDB

下载地址根据你的系统下载 32 位或 64 位的 .msi 文件，下载后双击该文件，按操作提示安装即可。

创建数据库文件的存放位置
在MongoDB下创建data，在data下再创建db：D:\MongoDB\data\db 因为启动mongodb服务之前需要必须创建数据库文件的存放文件夹，否则命令不会自动创建，而且不能启动成功。

启动MongoDB服务
进入D:\MongoDB\bin目录，输入如下的命令启动mongodb服务：
mongod --dbpath D:\MongoDB\data\db

也可以找到MongoDB\bin\下的mongo.exe双击启动，在浏览器输入http://localhost:27017 查看是否连接成功

3. 配置本地windows mongodb 服务

• 在刚才的data文件下再新建一个log文件夹，用来存放日志文件
• 在Mongodb文件夹下新建配置文件mongo.config
• 用记事本打开mongo.config ，并输入：

dbpath=D:\MongoDB\data\db
logpath=D:\MongoDB\data\log\mongo.log

• cmd到 D:\MongoDB\bin目录下,输入：

mongod --config "D:\Mongodb\mongo.config" --install --serviceName "MongoDB"

即根据刚创建的mongo.config配置文件安装服务，名称为MongoDB

如果成功的话，会发现本地服务多了”MongoDB"服务，之后你就可以通过开机自启动，也可以直接手动启动关闭，命令行net start MongoDB 启动”。

4.构建spring boot项目

pom.xml

<dependencies>
        <!--mongodb依赖-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-mongodb</artifactId>
        </dependency>
        <!--lombok依赖-->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
        <!--fastjson依赖-->
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>fastjson</artifactId>
            <version>1.2.44</version>
        </dependency>
        <!--测试依赖-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

application.yml配置文件

spring:
  application:
    name: spring-boot-mongodb
  data:
    mongodb:
      uri: mongodb://localhost/test
      username: test
      password: 123456

在上面配置中 uri 内的 test 为数据库的名称，username是我们自定义的用户名称，password是自定义用户设置的密码。

实体类

public class Customer implements Serializable{
    private String id;
    private  String userName;
    private  String password;

    public Customer(String userName, String password) {
        this.userName = userName;
        this.password = password;
    }

    @Override
    public String toString() {
        return "Customer{" +
                "id='" + id + '\'' +
                ", userName='" + userName + '\'' +
                ", password='" + password + '\'' +
                '}';
    }
    ......
}

MongoRepository
spring-boot-starter-data-mongodb采用了跟spring-boot-starter-data-jpa同样的方式来完成接口代理类的生成，并且提供了一些常用的单个对象操作的公共方法，MongoRepository接口作用与JPARepository一致，继承了该接口的业务数据接口就可以提供一个被Spring IOC托管的代理实现类，这样我们在注入业务数据接口时就会完成代理实现类的注入。

// MongoRepository <T,PK>同样也是采用了两个泛型参数，
// T：实体类类型。
// PK：T实体类内的主键类型，如：String
public interface CustomerRepository extends MongoRepository<Customer,String>{
}

MongodbApplication
修改MongodbApplication入口类，添加CommandLineRunner接口的实现

@SpringBootApplication
public class MongodbApplication implements CommandLineRunner{

    static Logger logger = LoggerFactory.getLogger(MongodbApplication.class);

    @Autowired
    private CustomerRepository repository;

    @Override
    public void run(String... args){
        repository.save(new Customer("李谦","123456"));
        logger.info(JSON.toJSONString(repository.findAll()));
    }

    public static void main(String[] args) {
        SpringApplication.run(MongodbApplication.class, args);
        logger.info("SpringBoot整合Mongodb启动完成");
    }
}

查看控制台的打印结果

: Opened connection [connectionId{localValue:2, serverValue:2}] to localhost:27017
: [{"id":"5b076b85c051240674feb435","password":"123456","userName":"李谦"}]
: SpringBoot整合Mongodb启动完成

也可以通过db.customer.find()查询数据库验证结果

修改默认扫描路径

如果你不打算使用SpringBoot默认的扫描路径（SpringBoot默认扫描XxxApplication类的同级以及所有子级的package）可以通过@EnableMongoRepositories注解配置basePackages属性完成自定义的MongoDB的MongoRepository实现类的扫描，如下所示：

@SpringBootApplication
@EnableMongoRepositories(basePackages = "com.example.mongodb")
public class MongodbApplication implements CommandLineRunner { }

参考
Install MongoDB on Windows
基于SpringBoot2 & MongoDB完成自动化集成