ドキュメントのデータ形式: BSON

Overview

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

BSON データ形式

BSON（Binary JSON）は、MongoDB がデータを整理して保存するために使用するデータ形式です。このデータ形式には、すべての JSON データ構造タイプが含まれています。また、日付、異なるサイズの整数、ObjectId 値、バイナリ データなどのタイプもサポートしています。サポートされているタイプの完全なリストについては、MongoDB Server マニュアルの BSON types ページを参照してください。

バイナリ形式は人間が判読することはできませんが、Java BSON ライブラリを使用して JSON 表現に変換できます。これらの形式の関係について詳しくは、JSON と BSON 記事を参照してください。

MongoDB と BSON

BSONライブラリを使用するJavaドライバーでは、BSONインターフェースを実装するRealm オブジェクトタイプのいずれかを使用してBSONデータを操作できますBSON interface。次のタイプはBSONインターフェースを実装します。

• ドキュメント（BSONライブラリパッケージ）

• BsonDocument（BSONライブラリパッケージ）

• RawBsonDocument（BSONライブラリパッケージ）

• JsonObject（BSONライブラリパッケージ）

• BasicDBObject （JVM パッケージ）

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

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

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

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

dependencies {
    compile 'org.mongodb:bson'
}

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

よくある質問

このセクションでは、 BSONデータ形式を使用する際に発生し得る質問に答えます。

// incorrectly formatted update document
collection.updateOne(
    new Document().append("name", "fizz"),
    new Document().append("name", "buzz")
);

// Builder class imports
import static com.mongodb.client.model.Filters.*;
import static com.mongodb.client.model.Updates.*;
// ...
collection.updateOne(eq("name", "fizz"), set("name", "buzz"));