BSONデータとの連携

Overview

このガイドでは、BSON データ形式、MongoDB でのデータの使用方法、および Kotlin 同期ドライバーとは別個に BSON ライブラリをインストールする方法について学習できます。

BSON データ形式

BSON（Binary 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 （JVM パッケージ）

BSON ライブラリのインストール

このセクションでは、BSON ライブラリを依存関係としてプロジェクトに追加する方法を示します。Kotlin Sync ドライバーを依存関係としてプロジェクトに追加した場合は、BSON ライブラリはドライバーの必須依存関係としてすでに含まれているため、この手順はスキップできます。Kotlin Syncドライバーを依存関係としてプロジェクトに追加する方法の詳細については、 Kotlin Syncドライバーを使い始めるガイドを参照してください。

Tip

ドキュメントの請求書

ドライバーアーティファクトのバージョンを管理するには、JVM ドライバーの BOM（Bill of Materials）をアプリケーションに追加することをお勧めします。これにより、BOM に含まれる個別パッケージのバージョンを指定する必要がなくなり、依存関係の管理が簡素化されます。詳細については、Kotlin 同期ドライバーを使い始めるガイドを参照してください。

プロジェクトの依存関係を管理するには、Maven または Gradle ビルドオートメーションツールを使用することをお勧めします。そのツールの依存関係宣言を表示するには、次のタブからを選択します。

次のスニペットは、pom.xml ファイルの dependencies セクション内の依存関係宣言を示しています。

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

次のスニペットは、 build.gradleファイル内のdependenciesオブジェクト内の依存関係宣言を示しています。

dependencies {
    compile 'org.mongodb:bson'
}

前述のツールのいずれも使用していない場合は、sonatypeリポジトリから JARファイルを直接ダウンロードすることで、それをプロジェクトに含めることができます。

戻る

データクラス

時系列