此版本仍在开发中，尚未被视为稳定版。如需最新稳定版本，请使用 Spring Data MongoDB 5.0.4！spring-doc.cadn.net.cn

从 2.x 迁移到 3.x 的迁移指南

Spring Data MongoDB 3.x 需要 MongoDB Java Driver 4.x
要了解有关驱动程序版本的更多信息，请访问MongoDB 文档.spring-doc.cadn.net.cn

依赖变更

依赖项的变更使得可以在不引入同步驱动的情况下使用响应式支持。 注意：新的同步驱动不再支持 com.mongodb.DBObject。请改用 org.bson.Document。spring-doc.cadn.net.cn

签名变更

  • MongoTemplate 不再支持 com.mongodb.MongoClient 和 com.mongodb.MongoClientOptions。 请改用 com.mongodb.client.MongoClient 和 com.mongodb.MongoClientSettings。spring-doc.cadn.net.cn

如果您正在使用 AbstractMongoConfiguration，请切换到 AbstractMongoClientConfiguration。spring-doc.cadn.net.cn

命名空间变更

切换到 com.mongodb.client.MongoClient 需要更新您的配置 XML（如果有的话）。 提供所需连接信息的最佳方式是使用连接字符串。 详情请参阅 MongoDB 文档。spring-doc.cadn.net.cn

<mongo:mongo.mongo-client id="with-defaults" />
<context:property-placeholder location="classpath:..."/>

<mongo:mongo.mongo-client id="client-just-host-port"
                          host="${mongo.host}" port="${mongo.port}" />

<mongo:mongo.mongo-client id="client-using-connection-string"
                          connection-string="mongodb://${mongo.host}:${mongo.port}/?replicaSet=rs0" />
<mongo:mongo.mongo-client id="client-with-settings" replica-set="rs0">
		<mongo:client-settings cluster-connection-mode="MULTIPLE"
							   cluster-type="REPLICA_SET"
							   cluster-server-selection-timeout="300"
							   cluster-local-threshold="100"
							   cluster-hosts="localhost:27018,localhost:27019,localhost:27020" />
	</mongo:mongo.mongo-client>