Docs 主页

/ /

连接

Docs 主页

/ /

Java Reactive Streams 驱动程序

Java Reactive Streams 驱动程序

连接

创建 MongoClient

Overview

要连接到 MongoDB 部署，您需要满足两个条件：

A 连接 URI，也称为 连接字符串，它告诉 Java Reactive Streams 驱动程序要连接到哪个 MongoDB 部署。
一个MongoClient实例，用于创建与MongoDB 部署的连接并允许您对其执行操作。

您还可以使用这些组件来自定义Java Reactive Streams驱动程序在连接到MongoDB时的行为方式。

本指南介绍如何创建连接string并使用 MongoClient实例连接到MongoDB 。

连接 URI

标准连接string包括以下组件：

组件	说明
`mongodb://`	必需。在标准连接格式中将 URI 标识为string的前缀。
`username:password`	可选。身份验证凭证。如果包含这些内容，客户端将根据`authSource`中指定的数据库对用户进行身份验证。有关`authSource`连接选项的更多信息，请参阅身份验证指南。
`host[:port]`	必需。运行 MongoDB 的主机和端口号。如果未包含端口号，驱动程序将使用默认端口 `27017`。
`/defaultauthdb`	可选。如果连接string包含 `username:password@` 身份验证档案但不包含 `authSource` 选项，则要使用的身份验证数据库。如果不包含此组件，客户端将根据`admin`数据库对用户进行身份验证。
`?<options>`	可选。一个查询string ，它将特定于连接的选项指定为 `<name>=<value>` 对。有关这些选项的完整说明，请参阅“指定连接 URI 选项”指南。

有关创建连接string 的更多信息，请参阅 MongoDB Server文档中的连接字符串。

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文档：

MongoClient

后退

连接

来年

选择连接目标