Java驱动程序入门

Overview

Java驾驶员是一个同步API ，可用于从Java应用程序与MongoDB交互。本指南向您展示如何创建一个应用程序，该应用程序使用Java驾驶员连接到MongoDB Atlas上托管的MongoDB 集群并查询集群中的数据。

按照本教程将示例Java应用程序连接到MongoDB Atlas部署。本教程包括以下部分：

• 下载并安装：了解如何安装Java驾驶员。

• 创建MongoDB部署：了解如何在Atlas上创建免费的MongoDB 部署。

• 创建连接字符串：了解如何检索Atlas部署的连接字符串。

• 创建 MongoClient：了解如何创建连接到MongoDB并查询部署中存储的数据的应用程序。

如果希望使用其他驱动程序或编程语言连接 MongoDB，请参阅我们的官方驱动程序列表。

下载并安装

请完成以下步骤，在开发环境中安装Java驾驶员及其依赖项。

<dependencies>
    <dependency>
        <groupId>org.mongodb</groupId>
        <artifactId>mongodb-driver-sync</artifactId>
        <version>5.4.0</version>
    </dependency>
</dependencies>

dependencies {
  implementation 'org.mongodb:mongodb-driver-sync:5.4.0'
}

完成这些步骤后，您就拥有了一个新项目并安装了驾驶员依赖项。

创建 MongoDB 部署

您可以在 MongoDB Atlas 上创建一个免费套餐 MongoDB 部署来存储和管理您的数据。MongoDB Atlas 在云端托管和管理您的 MongoDB 数据库。

完成这些步骤后，您就可以在 Atlas 上有一个新的免费套餐 MongoDB 部署，并建立数据库用户凭证，以及将示例数据加载到数据库中。

创建连接字符串

您可以通过提供连接 URI（也称为连接字符串）来连接到 MongoDB 部署，它指示驱动程序如何连接到 MongoDB 部署以及连接时的行为方式。

连接字符串包含部署的主机名或 IP 地址和端口、身份验证机制、用户档案（如果适用）以及连接选项。

1

查找 MongoDB Atlas 连接字符串

要检索您在上一步中创建的部署的连接字符串，日志登录您的Atlas帐户并导航到 Clusters 部分。单击新部署的 Connect 按钮，如以下屏幕截图所示：

然后，继续执行 Connect your application 部分。从 Driver 选择菜单中选择“Java”，然后从 Version 选择菜单中选择与您安装的版本最匹配的版本。

2

复制连接字符串

单击连接string右侧的按钮将其复制到剪贴板，如以下屏幕截图所示：

3

编辑连接字符串占位符

将连接字符串粘贴到首选文本编辑器中的文件中，并将此文件保存到安全位置以供以后使用。在连接字符串中，将 <db_username> 和 <db_password> 占位符替换为数据库用户的用户名和密码。

完成这些步骤后，您将拥有一个包含数据库用户名和密码的连接字符串。

运行示例查询

检索MongoDB Atlas部署的连接字符串后，您可以从Java应用程序连接到该部署并查询Atlas示例数据集。

import static com.mongodb.client.model.Filters.eq;
import org.bson.Document;
import com.mongodb.client.MongoClient;
import com.mongodb.client.MongoClients;
import com.mongodb.client.MongoCollection;
import com.mongodb.client.MongoDatabase;
public class QuickStart {
    public static void main( String[] args ) {
        // Replace the placeholder with your MongoDB deployment's connection string
        String uri = "<connection string uri>";
        try (MongoClient mongoClient = MongoClients.create(uri)) {
            MongoDatabase database = mongoClient.getDatabase("sample_mflix");
            MongoCollection<Document> collection = database.getCollection("movies");
            Document doc = collection.find(eq("title", "Back to the Future")).first();
            if (doc != null) {
                System.out.println(doc.toJson());
            } else {
                System.out.println("No matching documents found.");
            }
        }
    }
}

{
  _id: ...,
  plot: 'A young man is accidentally sent 30 years into the past...',
  genres: [ 'Adventure', 'Comedy', 'Sci-Fi' ],
  ...
  title: 'Back to the Future',
  ...
}

javax.net.ssl.SSLHandshakeException: extension (5) should not be presented in certificate_request

完成这些步骤后，您就拥有一个Java应用程序，它可以连接到MongoDB 部署、对示例数据运行查询并返回匹配的文档。

后续步骤

恭喜您完成本教程！

在本教程中，您创建了一个Java驾驶员应用程序，该应用程序连接到MongoDB Atlas上托管的MongoDB 部署，并检索与查询匹配的文档。

您可以访问以下指南，继续开发示例应用程序：

• 数据库和集合：了解详情有关与MongoDB数据库和集合交互的更多信息。

• 第三方集成：了解可与Java驾驶员一起使用的第三方集成。