MongoDB 入门教程:开发环境搭建及 Node.js 和 Java 的读写访问

2023年 7月 11日 42.5k 0

MongoDB 是近年来非常流行的一个介于关系数据库和非关系数据库之间的解决方案,采取面向文档的分布式设计思路,具有强大的可扩展性,表结构自由,并且支持丰富的查询语句和数据类型。时至今日,MongoDB 以其灵活的数据存储方式,逐渐成为 IT 行业非常流行的一种非关系型数据库解决方案。

笔者在项目中也经历了从零开始学习 MongoDB 数据库的过程,因此想把我学习过程中的一些心得通过文章分享出来。

MongoDB 入门教程:开发环境搭建及 Node.js 和 Java 的读写访问

步骤1 - MongboDB 环境搭建

MongoDB 支持的数据结构非常松散,是类似 json 的 bson 格式,这种灵活的格式使得 MongoDB 可以存储比较复杂的数据类型。Mongo 最大的特点是它支持的查询语言(Query Language)非常强大,其语法有点类似于面向对象的查询语言,因此可读性非常好,并且几乎可以实现类似关系数据库单表查询的绝大部分功能。

本步骤介绍 MongoDB 学习的第一步:环境搭建。

从 MongoDB 的 官网下载安装包。

MongoDB 入门教程:开发环境搭建及 Node.js 和 Java 的读写访问

我安装在 C 盘的 MyApp 目录下的 mongoDB,安装完毕后,bin 文件夹里有好几个执行文件。把 bin 文件路径加到 windows 系统的环境变量里。

MongoDB 入门教程:开发环境搭建及 Node.js 和 Java 的读写访问

使用如下命令行启动 MongoDB 服务器:

mongod --dbpath C:MyAppmongoDBjerryserverdb 从控制台打印的 console 里看到下列消息:

Mongo DB starting: pid=16588 port=27017 意思是进程 id 为 16588 的进程启动了 MongoDB,监听端口号为 27017.

MongoDB 入门教程:开发环境搭建及 Node.js 和 Java 的读写访问

console 里还有其他一些有用的提示,比如:

Read and write access to data and configuration is unrestricted - 没有对数据读写设置权限

WARNING: This server is bound to localhost - 这个服务器通过 localhost 访问

MongoDB 入门教程:开发环境搭建及 Node.js 和 Java 的读写访问

在 cmd 里用命令 netstat -ano | find "27017", 发现确实进程 id 为 16588 的进程在端口 27017 监听:

MongoDB 入门教程:开发环境搭建及 Node.js 和 Java 的读写访问

打开 MongoDB Compass, 这是 MongoDB GUI 图形化操作界面,在 MongboDB 安装过程中也自动被安装了。

Hostname 输入 localhost,port 输入 27017,点击 Connect 进行连接:

MongoDB 入门教程:开发环境搭建及 Node.js 和 Java 的读写访问

连接之后,在 admin 数据库下创建一个新的 Collection:

MongoDB 入门教程:开发环境搭建及 Node.js 和 Java 的读写访问

我的例子里,collection 名称为 person,点 INSERT DOCUMENT 创建一条记录, _id 为 MongoDB compass 自动生成的, 另一个字段的名称为 name, 值为 "Jerry":

MongoDB 入门教程:开发环境搭建及 Node.js 和 Java 的读写访问

再点一次 INSERT DOCUMENT, 生成两条 person 记录。

MongoDB 入门教程:开发环境搭建及 Node.js 和 Java 的读写访问

现在我们新开另一个命令提示行窗口来消费在 MongoDB Compass 里创建的两条 person 记录。

命令行 mongo localhost:27017/admin, 意思是连接这个数据库里的 admin 数据库

MongoDB 入门教程:开发环境搭建及 Node.js 和 Java 的读写访问

此时从前一个启动 MongoDB 服务器的命令提示行的控制台输出,能看到 connection accepted from 的输出:

MongoDB 入门教程:开发环境搭建及 Node.js 和 Java 的读写访问

命令行 db.person.find(), 打印出了 admin 数据库里 person 表里的两条记录,说明我们环境配置成功了。

MongoDB 入门教程:开发环境搭建及 Node.js 和 Java 的读写访问

步骤2 - 使用 Node.js 访问 MongoDB

在 localhost:27017 的服务器上,在数据库 admin 下面创建了一个名为 person 的数据库表,并插入了两条记录:

MongoDB 入门教程:开发环境搭建及 Node.js 和 Java 的读写访问

上图是用 MongoDB Compass 查看的成功插入的两条记录。 下面我们用 Node.js 读取这两条记录。 首先在命令行里执行 npm install mongodb, 然后新建一个 JavaScript 文件,复制以下内容:

MongoDB 入门教程:开发环境搭建及 Node.js 和 Java 的读写访问

注意第 12 行的 dbo.collection("person"). find({}).toArray,意思是读取表 person 里的所有记录。

var MongoClient = require('mongodb').MongoClient;
var url = "mongodb://localhost:27017";
MongoClient.connect(url, function(err, db) {
    if (err){
        console.log(err);
        throw err;
    }
    console.log("Jerry DB connection established!");
    var dbo = db.db("admin");
    dbo.collection("person"). find({
    }
    ).toArray(function(err, result) {
        if (err)
        throw err;
        console.log(result);
        db.close();
    }
    );
    db.close();
}
);

如果我只想读取 name 为 Jerry 的那条记录,只需要把 where 条件传入方法 find 即可:

MongoDB 入门教程:开发环境搭建及 Node.js 和 Java 的读写访问

从调试器里能观察到按照期望的方式被读取回来了:

MongoDB 入门教程:开发环境搭建及 Node.js 和 Java 的读写访问

步骤3 - 使用 Java 代码往 MongoDB 里插入数据

如果您是基于 Maven 进行依赖管理的 Java 项目,只需要在您的 pom.xml 里加入下面的依赖定义:


org.mongodb
mongodb-driver
3.6.4

然后使用命令行 mvn clean install 后,您的本地 maven 仓库里会多出三个和用 Java 连接 MongoDB 相关的库:

  • bson
  • mongodb-driver
  • mongodb-driver-core

MongoDB 入门教程:开发环境搭建及 Node.js 和 Java 的读写访问

当然也可以手动逐一下载 jar 文件:https://mongodb.github.io/mongo-java-driver/

MongoDB 入门教程:开发环境搭建及 Node.js 和 Java 的读写访问

本文使用的是这三个文件,将它们下载到本地,再加入 Java 项目的 classpath 里。

MongoDB 入门教程:开发环境搭建及 Node.js 和 Java 的读写访问

Java 代码如下:

MongoDB 入门教程:开发环境搭建及 Node.js 和 Java 的读写访问

package mongoDB;
import java.util.ArrayList;
import java.util.List;
import org.bson.Document;
import com.mongodb.MongoClient;
import com.mongodb.client.FindIterable;
import com.mongodb.client.MongoCollection;
import com.mongodb.client.MongoCursor;
import com.mongodb.client.MongoDatabase;
public class MongoDBTest {
    private static void insert(MongoCollection collection) {
        Document document = new Document("name", "dog");
        List documents = new ArrayList();
        documents.add(document);
        collection.insertMany(documents);
    }
    public static void main(String args[]) {
        MongoClient mongoClient = null;
        try {
            mongoClient = new MongoClient("localhost", 27017);
            MongoDatabase mongoDatabase = mongoClient.getDatabase("admin");
            System.out.println("Connect to database successfully");
            MongoCollection collection = mongoDatabase
            .getCollection("person");
            // insert(collection);
            FindIterable findIterable = collection.find();
            MongoCursor mongoCursor = findIterable.iterator();
            while (mongoCursor.hasNext()) {
                System.out.println(mongoCursor.next());
            }
        }
        catch (Exception e) {
            System.err.println(e.getClass().getName() + ": " + e.getMessage());
        }
        finally{
            mongoClient.close();
        }
    }
}

和本教程步骤 2相比,上述代码的 insert 方法里还展示了如何用 Java 代码给 MongoDB 数据库里增加记录。

private static void insert(MongoCollection collection) {
    Document document = new Document("name", "dog");
    List documents = new ArrayList();
    documents.add(document);
    collection.insertMany(documents);
}

执行 Java 应用,发现通过 insert 方法加到数据库的记录也能被顺利读出来。

MongoDB 入门教程:开发环境搭建及 Node.js 和 Java 的读写访问

总结

MongoDB 是近年来非常流行的一个介于关系数据库和非关系数据库之间的解决方案,采取面向文档的分布式设计思路,具有强大的可扩展性,表结构自由,并且支持丰富的查询语句和数据类型。本文首先介绍了 MongoDB 的本地环境搭建步骤,接着分别介绍了使用 Node.js 和 Java 对本地 MongoDB 进行数据读写的编程细节。

相关文章

Oracle如何使用授予和撤销权限的语法和示例
Awesome Project: 探索 MatrixOrigin 云原生分布式数据库
下载丨66页PDF,云和恩墨技术通讯(2024年7月刊)
社区版oceanbase安装
Oracle 导出CSV工具-sqluldr2
ETL数据集成丨快速将MySQL数据迁移至Doris数据库

发布评论