Spring系列之集成MongoDB的2種方法

MongoDB是最流行的NoSQL數據庫，SpringBoot是使用Spring的最佳實踐。今天帶大家講一講SpringBoot集成MongoDB的兩種方式，MongoDB的安裝自行去官網查詢，本地開發最方便的做法是使用Docker方式。

一、准備工作

1、工程生成

老規矩，使用https://start.spring.io/ 選擇我們要依賴的jar包，生成一個demo，然后導入到Idea中

2、配置項

在application.properties文件中，配置MongoDB的地址

spring.data.mongodb.database=springmongo
spring.data.mongodb.username=springmongo
spring.data.mongodb.password=springmongo
spring.data.mongodb.host=localhost
spring.data.mongodb.port=27017
# 以下方式也可以,可以根據喜好來配置
# spring.data.mongodb.uri=mongodb://springmongo:springmongo@localhost:27017/springmongo

二、使用MongoTemplate

1、創建實體UserInfo

import lombok.Data;
import org.springframework.data.annotation.Id;
import org.springframework.data.mongodb.core.mapping.Document;
/**
 * @author 公-眾-號：程序員阿牛
 * @Id是Spring的注解，注意不要和Mybatis的搞混
 * @Document是MongoDB的注解
 */
@Data
@Document
public class UserInfo {
    @Id
    private String userId;
    private String userName;
    private Integer age;
    private String address;
}

@Document與@Entity類似，表明是一個實體，@Id表明是主鍵

其他的Spring data mongoDB注解還有：

@Document

把一個java類聲明為mongodb的文檔，可以通過collection參數指定這個類對應的文檔。@Document(collection="mongodb 對應 collection 名")

@Id

文檔的唯一標識，在mongodb中為ObjectId，它是唯一的

@Indexed

聲明該字段需要索引，建索引可以大大的提高查詢效率。

@CompoundIndex

復合索引的聲明，建復合索引可以有效地提高多字段的查詢效率。

@Field

給映射存儲到 mongodb 的字段取別名

@Dbref

標識引用其他文檔，這個文檔有可能在另外的數據庫中

@Version

標識改屬性作為版本控制

@Transient

默認情況下所有的私有字段都映射到文檔，該注解標識的字段從存儲在數據庫中的字段列中排除（即該字段不保存到 mongodb）

2、定義接口

/**
 * @author 公-眾-號：程序員阿牛
 */
public interface UserInfoDAO {

    public UserInfo save(UserInfo userInfo);

    public UserInfo getUser(String userId);
}

3、接口實現

/**
 * @author 公-眾-號：程序員阿牛
 */
@Repository
public class UserInfoDaoImpl implements UserInfoDAO {
    @Autowired
    private MongoTemplate mongoTemplate;

    @Override
    public UserInfo save(UserInfo userInfo) {
        return mongoTemplate.save(userInfo);
    }

    @Override
    public UserInfo getUser(String userId) {
        UserInfo userInfo = mongoTemplate.findOne(Query.query(Criteria.where("userId").is(userId)),UserInfo.class);
        return userInfo;
    }
}

4、定義調用controller

/**
 * @author 公-眾-號：程序員阿牛
 */
@RestController
public class UserInfoController {
    @Autowired
    private UserInfoDAO userInfoDAO;
    @RequestMapping("/getUser/{userId}")
    public UserInfo getUserInfo(@PathVariable("userId")String userId){
        return userInfoDAO.getUser(userId);
    }

    @PostMapping("/addUser")
    public UserInfo addUserInfo(@RequestBody UserInfo userInfo){
        return userInfoDAO.save(userInfo);
    }

}

5、結果

使用idea自帶的httpclient測試一下

測試結果如下：

三、使用MongoRepository

1、定義接口

/**
 * @author 公-眾-號：程序員阿牛
 * 這里使用的spring-data抽象的Repository接口，有興趣的可以自己去研究一下    
 */
@Repository
public interface UserInfoRepository extends MongoRepository<UserInfo, String> {
}

通過繼承接口，spring data會自動實現基本的crud方法，同時，還支持通過方法的形式擴展自己想要的方法，例如通過以下關鍵詞擴展(圖片在網上找的)：

自定義查詢方法，格式為“find/get/readBy+字段名+方法后綴”，方法傳進的參數即字段的值。

支持的部分常用方法后綴有：

2、定義調用的controller

/**
 * @author 公-眾-號：程序員阿牛
 */
@RestController
public class UserInfo2Controller {
    @Autowired
    private UserInfoRepository userInfoRepository;
    @RequestMapping("/getUser2/{userId}")
    public Optional<UserInfo> getUserInfo(@PathVariable("userId")String userId){
        return userInfoRepository.findById(userId);
    }

    @PostMapping("/addUser2")
    public UserInfo addUserInfo(@RequestBody UserInfo userInfo){
        return userInfoRepository.save(userInfo);
    }

}

3、結果

使用idea自帶的httpclient測試一下

測試結果如下：

小結

本文基於的SpringBoot版本是2.5.4，兩種方式都可以實現與Spring的集成，具體使用哪一種根據實際的需要即可
關注我，下一篇繼續