MongoDB Java Server 技术文档

以下是对 MongoDB Java Server 项目的详细介绍，包括安装指南、使用说明以及 API 使用文档。

1. 安装指南

Maven 依赖

将以下 Maven 依赖添加到您的项目中：

<dependency>
    <groupId>de.bwaldvogel</groupId>
    <artifactId>mongo-java-server</artifactId>
    <version>1.45.0</version>
</dependency>

构建脂肪 JAR

如果您想要构建一个包含所有依赖的脂肪 JAR，可以执行以下步骤：

1. 使用 ./gradlew shadowJar 构建脂肪 JAR。
2. 将 build/libs/mongo-java-server-[version]-all.jar 文件复制到您的项目中，例如复制到 libs 目录。
3. 在 Gradle 中导入该文件夹，例如使用 testCompile fileTree(dir: 'libs', include: '*.jar')。

2. 项目使用说明

MongoDB Java Server 是一个用 Java 实现的 MongoDB 核心服务器的模拟版本，可用于集成测试。以下是一个简单的示例：

class SimpleTest {

    private MongoCollection<Document> collection;
    private MongoClient client;
    private MongoServer server;

    @BeforeEach
    void setUp() {
        server = new MongoServer(new MemoryBackend());

        // 绑定到一个随机本地端口
        String connectionString = server.bindAndGetConnectionString();

        client = MongoClients.create(connectionString);
        collection = client.getDatabase("testdb").getCollection("testcollection");
    }

    @AfterEach
    void tearDown() {
        client.close();
        server.shutdown();
    }

    @Test
    void testSimpleInsertQuery() throws Exception {
        assertThat(collection.countDocuments()).isZero();

        // 在内存中创建数据库和集合并插入对象
        Document obj = new Document("_id", 1).append("key", "value");
        collection.insertOne(obj);

        assertThat(collection.countDocuments()).isEqualTo(1L);
        assertThat(collection.find().first()).isEqualTo(obj);
    }

}

3. 项目 API 使用文档

MongoDB Java Server 提供了多种后端存储选项，包括内存后端、H2 MVStore 后端和 PostgreSQL 后端。

内存后端

内存后端是默认的后端，通常用于集成测试。它支持大多数 CRUD 操作、命令和聚合框架。以下是如何使用内存后端的示例：

MongoServer server = new MongoServer(new MemoryBackend());

H2 MVStore 后端

H2 MVStore 后端可以将服务器连接到一个 MVStore，它可以是内存中的或磁盘上的。以下是如何使用 H2 MVStore 后端的示例：

MongoServer server = new MongoServer(new H2Backend("database.mv"));

PostgreSQL 后端

PostgreSQL 后端是一个概念验证实现，它将服务器连接到一个运行的 PostgreSQL 9.5+ 实例。以下是如何使用 PostgreSQL 后端的示例：

DataSource dataSource = new org.postgresql.jdbc3.Jdbc3PoolingDataSource();
dataSource.setDatabaseName(…);
dataSource.setUser(…);
dataSource.setPassword(…);
MongoServer server = new MongoServer(new PostgresqlBackend(dataSource));

请注意，当前 MongoDB Java Server 不支持事务。如果您需要进行事务测试，可以使用 Testcontainers 或 Embedded MongoDB 来启动一个真实的 MongoDB 实例。