Java驱动程序入门

安装驱动程序依赖项

在开始本教程之前，请确保安装以下依赖项：

• JDK 版本 8 或更高版本

• 集成开发环境 (IDE)，例如 IntelliJ IDEA 或 Eclipse

添加Java驱动程序物料清单

在 IDE 中，创建新的Maven或Gradle项目。将MongoDB Java虚拟机（JVM）工件的物料清单 (BOM) 添加到项目中以组织依赖项版本。BOM 通过确保您维护一致且兼容的依赖项版本（例如 Java 驱动程序和核心驱动程序库之间），从而简化依赖项管理。使用 BOM 避免版本冲突并简化升级。

从以下 Maven 和 Gradle 标签页中进行选择，查看为每个依赖项管理器添加 BOM 的说明：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.mongodb</groupId>
            <artifactId>mongodb-driver-bom</artifactId>
            <version>5.6.1</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

dependencies {
    implementation(platform("org.mongodb:mongodb-driver-bom:5.6.1"))
}

要查看 BOM 管理的依赖项列表，请参阅 Maven 存储库网站上的mongodb-driver-bom 依赖项列表。

安装Java驱动程序

如果使用 Maven，请将以下代码添加到 pom.xml 依赖项列表中：

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

如果使用 Gradle，请将以下代码添加到 build.gradle 依赖项列表中：

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

由于您安装了 BOM，因此可以省略Java驱动程序依赖项条目中的版本。您在 BOM 中指定的版本决定了要安装的依赖项版本。

配置依赖项后，运行依赖项管理器并在 IDE 中刷新项目，确保它们可用于您的项目。

在 Atlas 上创建免费的 MongoDB 部署

完成MongoDB入门指南，设立新的Atlas帐户和免费套餐MongoDB 部署。确保加载示例数据并将IP解决添加到IP访问列表。

保存您的档案

创建数据库用户后，请将该用户的用户名和密码保存在一个安全位置，以便在后续步骤中使用。

查找 MongoDB Atlas 连接字符串

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

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

复制连接字符串

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

编辑连接字符串占位符

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

创建Java应用程序文件

在项目的基础包目录中，创建一个名为 QuickStart.java 的文件。将以下代码复制并粘贴到此文件中，以查询 sample_mflix数据库中的 movies集合：

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.");
            }
        }
    }
}

指定连接字符串

将 <connection string uri> 占位符替换为从本指南的“创建连接字符串”步骤中复制的连接字符串。

运行Java应用程序

在 IDE 或Shell中运行应用程序。 输出包含有关检索到的电影文档的详细信息：

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