Migration Guide from 2.x to 3.x

  • 依赖项更改：替换了 mongo-java-driver，允许使用反应性支持而不提取同步驱动程序。

  • 签名更改：MongoTemplate 不再支持 MongoClient 和 MongoClientOptions，改为使用 com.mongodb.client.MongoClient 和 com.mongodb.MongoClientSettings。

  • 命名空间更改：对于已使用 MongoClient 的配置，需要更新配置 XML。推荐使用连接字符串提供连接信息。

Spring Data MongoDB 3.x 需要 MongoDB Java Driver 4.x。如需详细了解驱动程序版本，请访问 MongoDB Documentation。

Dependency Changes

  • org.mongodb:mongo-java-driver（uber jar）已替换为：

    • bson-jar

    • core-jar

    • sync-jar

依赖项中的更改允许使用反应性支持，而无需提取同步驱动程序。注意：新的同步驱动程序不再支持 com.mongodb.DBObject。请改用 org.bson.Document。

Signature Changes

  • MongoTemplate 不再支持 com.mongodb.MongoClient 和 com.mongodb.MongoClientOptions。请改为使用 com.mongodb.client.MongoClient 和 com.mongodb.MongoClientSettings。

如果你正在使用 AbstractMongoConfiguration，请切换到 AbstractMongoClientConfiguration。

Namespace Changes

如果您有配置文件 XML，则切换到 `com.mongodb.client.MongoClient`需要更新该配置文件。提供所需连接信息最简单的方法是使用连接字符串。有关详情，请参见 MongoDB Documentation。

<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>