MongoDB 数据访问

Spring Data MongoDB 客户端路由、具名数据源切换和客户端生命周期。

连接与路由

组件以 Spring Boot 创建的默认 MongoClient 为基础。默认连接使用 spring.mongodb.uri;默认数据库名优先取 spring.mongodb.database,未设置时取 URI 中的数据库名。配置 lodsve.mongo.data-source 后,组件会为每个具名连接创建客户端,并通过路由客户端向 Spring Data MongoDB 提供访问入口。每个具名连接 URI 必须包含数据库名。lodsve.mongo.default-data-source-name 指定默认数据源名称,默认值为 default;此名称保留给默认客户端,不能再作为具名数据源配置。

方法级 @SwitchMongoDataSource 可以在一次 Spring Bean 调用期间选择具名数据源:

@Service
public class ArchiveService {
    private final DemoRepository repository;

    public ArchiveService(DemoRepository repository) {
        this.repository = repository;
    }

    @SwitchMongoDataSource("archive")
    public List<Demo> listArchived() {
        return repository.findAll();
    }
}

注解方法必须通过 Spring 代理调用;同一个对象内部的自调用不会触发切面。异步任务不继承当前线程的数据源选择。需要在代码块中手动切换时,可使用 MongoDataSourceContextHolder.open(name) 并以 try-with-resources 关闭作用域。

连接配置与限制

每个具名数据源只需提供 MongoDB 连接 URI;URI 中的数据库名决定该数据源的默认库。默认连接和具名连接的完整 YAML 见MongoDB 配置示例,属性表见配置参考。Spring Data Repository、MongoTemplate 等 API 仍按 Spring Data MongoDB 的方式使用;Starter 接入见MongoDB Starter。

ClientSession 绑定到创建它的 MongoClient,不能在切换客户端后继续复用。因此一次事务或会话应固定使用同一个数据源。组件负责关闭它创建的具名客户端;默认客户端的生命周期仍由 Spring Boot 管理。

架构图