MongoDB Java驱动程序简介

在过去的Windows 7中安装和运行MongoDB的文章中,您已经了解了如何安装和运行MongoDB数据库服务器。现在,我们将学习如何使用MongoDB Java驱动程序来访问MongoDB数据库中的集合。为了演示这一点,我将使用Maven和IntelliJ IDEA。您当然可以使用其他IDE,例如也支持Maven的Eclipse或NetBeans。

让我们从在IntelliJ IDEA中创建项目开始。我将使用可免费下载的IntelliJ IDEA社区版。以下是在IntelliJ IDEA中创建Maven项目的步骤。

创建Maven项目

  • 启动IntelliJ IDEA。从“欢迎屏幕”中选择“创建新项目”

  • 将显示一个新项目向导。选择侧边栏上的Maven,选中从原型创建复选框,然后选择maven-archetype-quickstart

  • 下一步按钮继续。

  • 在下一个屏幕中,您可以输入Maven项目信息的详细信息,包括GroupIdArtifactIdVersion

  • 下一步按钮继续。

  • 如果需要,您可以在此屏幕中覆盖任何Maven配置设置。您还将看到要创建的Maven项目的摘要。我们不会在此屏幕中修改设置。

  • 下一步按钮继续。

  • 在最后一个屏幕中,我们输入项目名称项目位置目录。

  • 输入这两个信息后,单击“完成”按钮以在IntelliJ IDEA中生成Maven项目。

  • 最后,您在IntelliJ IDEA中创建了Maven项目。

  • 这是在IntelliJ IDEA中生成的Maven项目结构。

编辑pom.xml文件

  • 要在Java应用程序中使用MongoDB Java驱动程序,我们需要做的第一件事是在pom.xml文件中向MongoDB Java Driver添加依赖项。

  • 将以下依赖项配置添加到中pom.xml。

<dependency>
    <groupId>org.mongodb</groupId>
    <artifactId>mongo-java-driver</artifactId>
    <version>2.12.3</version>
</dependency>
  •  然后,您将拥有完整的pom.xml文件,如下所示。

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>org.nhooo.example.mongodb</groupId>
    <artifactId>mongodb-examples</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>jar</packaging>

    <name>mongodb-examples</name>
    <url>http://maven.apache.org</url>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>3.8.1</version>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.mongodb</groupId>
            <artifactId>mongo-java-driver</artifactId>
            <version>2.12.3</version>
        </dependency>
    </dependencies>
</project>

如果本地Maven存储库中不存在所有必需的依赖文件,则IntelliJ IDEA将从Maven Central存储库中下载所有必需的依赖文件。配置Maven之后,我们现在可以创建一个简单的程序来从MongoDB数据库中查找单个集合。

如果您关注的是我在本文开头提到的有关安装和运行MongoDB的最后一篇文章,那么您知道我们的MongoDB数据库中有peopledbandpersons集合。现在,我们将使用Java应用程序中的MongoDB Java驱动程序来阅读它。现在让我们创建应用程序。

创建Java一个简单的MongoDB客户端

  • 我们在org.nhooo.example.mongodb包下创建我们的类。右键单击此包,然后选择NewJava Class创建一个新类。

  • 输入类名称MongoDBHelloWorld,然后按确定按钮。

  • 这是MongoDBHelloWorld类的完整代码段。

package org.nhooo.example.mongodb;

import com.mongodb.*;

import java.net.UnknownHostException;

public class MongoDBHelloWorld {
    public static void main(String[] args) {
        try {
            // 创建MongoDBClient的新实例并连接到localhost
            // 端口27017。
            MongoClient client = new MongoClient(
                    new ServerAddress("localhost", 27017));

            // 从MongoDB实例获取peopledb。
            DB database = client.getDB("peopledb");

            // 从数据库获取人员集合。
            DBCollection collection = database.getCollection("persons");

            // 从此集合中获取单个文档/对象。
            DBObject document = collection.findOne();

            // 打印出文档。
            System.out.println(document);
        } catch (UnknownHostException e) {
            e.printStackTrace();
        }
    }
}
  •  如果运行此代码,您将在屏幕上打印以下输出。

{ "_id" : { "$oid" : "53e317ae420156bce730d1ff"} , "firstName" : "John" , "lastName" : "Doe" , "cityOfBirth" : "New York"}
  •  这是我们存储在peopledbMongoDB数据库中的JSON文档。

上面的Java类是我们有关如何使用MongoDB Java驱动程序访问MongoDB数据库和从中读取文档的第一个示例。我希望这个例子可以为我们更好地了解MongoDB提供一个良好的开端。如有任何疑问,请在本文下面的评论部分中提交。下篇文章见。谢谢!