使用BSON数据

Overview

在本指南中，您可以了解 BSON 数据格式、MongoDB 如何使用它，以及如何独立于 Kotlin 同步驱动程序安装 BSON 库。

BSON 数据格式

BSON 或二进制 JSON 是 MongoDB 用来组织和存储数据的数据格式。这种数据格式包括所有 JSON 数据结构类型，并且支持其他类型，包括日期、不同大小的整数、ObjectId 值和二进制数据。有关支持类型的完整列表，请参阅 MongoDB Server 手册中的 BSON types 页面。

二进制格式不适合人类阅读，但您可以使用 Java BSON 库将其转换为 JSON 表示形式。要了解这些格式之间的关系，请参阅 JSON 和 BSON 文章。

MongoDB 和 BSON

使用 BSON 库的 Kotlin 同步驱动程序，允许您使用实现 BSON 接口 的 Realm 对象类型之一来处理 BSON 数据。以下类型实现 BSON 接口：

• 文档（BSON 库包）

• BsonDocument（BSON 库包）

• RawbsonDocument（BSON 库包）

• jsonObject （BSON 库包）

• BasicDBObject（Java虚拟机（JVM）包）

安装 BSON 库

本节介绍如何将 BSON 库作为依赖项添加到项目中。如果您已将Kotlin 同步驱动程序作为依赖项添加到项目中，则可以跳过此步骤，因为BSON库已作为驱动程序的必需依赖项包含在内。有关如何将Kotlin 同步驱动程序作为依赖项添加到项目中的说明，请参阅开始使用Kotlin 同步驱动程序指南。

建议您使用 Maven 或 Gradle 来构建自动化工具，从而管理项目的依赖项。从以下标签页进行选择，从而查看该工具的依赖项声明：

<dependencies>
    <dependency>
        <groupId>org.mongodb</groupId>
        <artifactId>bson</artifactId>
    </dependency>
</dependencies>

dependencies {
    compile 'org.mongodb:bson'
}

如果您未使用上述工具之一，则可以直接从sonatype存储库。下载 JAR文件，将其包含在您的项目中。