创建MongoClient

本页内容

概述

连接URI
MongoClient
API文档

概述

连接到MongoDB部署，您需要两样东西

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

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

本指南向您展示如何创建连接字符串并使用MongoClient 实例连接到 MongoDB。

连接 URI

标准的连接字符串包括以下组件

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

有关创建连接字符串的更多信息，请参阅连接字符串在 MongoDB 服务器文档中。

MongoClient

要创建与MongoDB的连接，请将连接URI作为字符串传递给构造MongoClient对象的函数。以下示例中，驱动程序使用示例连接URI连接到运行在本地主机localhost上的MongoDB实例的27017端口。

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

连接

下一步

选择连接目标