创建 MongoClient
Overview
要连接到 MongoDB 部署,您需要满足两个条件:
连接 URI (也称为连接string ),用于告知Java Reactive Streams驾驶员要连接到哪个MongoDB部署。
一个MongoClient实例,用于创建与MongoDB 部署的连接并允许您对其执行操作。
您还可以使用这些组件来自定义Java Reactive Streams驾驶员在连接到MongoDB时的行为方式。
本指南介绍如何创建连接string并使用 MongoClient
实例连接到MongoDB 。
连接 URI
标准连接string包括以下组件:
组件 | 说明 |
---|---|
mongodb:// | 必需。 在标准连接格式中将 URI 标识为string的前缀。 |
username:password | 可选。 身份验证凭证。 如果包含这些内容,客户端将根据 有关 |
host[:port] | 必需。 运行MongoDB的托管和端口号。 如果未包含端口号,驾驶员将使用默认端口 27017 。 |
/defaultauthdb | 可选。 如果连接string包含 username:password@ 身份验证档案但不包含 authSource 选项,则要使用的身份验证数据库。 如果不包含此组件,客户端将根据admin 数据库对用户进行身份验证。 |
?<options> | 可选。 一个查询string ,它将特定于连接的选项指定为 有关这些选项的完整说明,请参阅“指定连接 URI 选项”指南。 |
MongoClient
要创建与MongoDB的连接,请将连接 URI 以string形式传递给构造 MongoClient
对象的方法。 在以下示例中,驾驶员使用示例连接 URI 连接到localhost
的端口27017
上的MongoDB实例:
import com.mongodb.reactivestreams.client.MongoClients; import com.mongodb.reactivestreams.client.MongoClient; public class MongoConnection { public static void main(String[] args) { String uri = "mongodb://localhost:27017/"; try (MongoClient client = MongoClients.create(uri)) { // use `client` here } } }
提示
重用客户端
由于每个MongoClient
实例都有与数据库的连接池,因此大多数应用程序只需要一个MongoClient
实例,即使在多个请求中也是如此。
API 文档
要学习;了解有关在Java Reactive Streams驾驶员中创建MongoClient
实例的更多信息,请参阅以下API文档: