BSON
Overview
このガイドでは、BSON データ形式、MongoDB が BSON を使用してデータを整理および保存する方法、および Kotlin Sync ドライバーとは別個に BSON ライブラリをインストールする方法について学習できます。
BSON データ形式
BSON （Binary JSON）は、MongoDB がデータを整理して保存するために使用するデータ形式です。 このデータ形式には、すべての JSON データ構造タイプが含まれ、日付、異なるサイズの整数（ 32ビットと64ビット）、ObjectId、バイナリ データなどのタイプのサポートが追加されています。 サポートされているタイプの完全なリストについては、 のドキュメントのBSON types MongoDB Serverを参照してください。
BSON は人間が判読することはできませんが、 BSON ライブラリを使用して人間が判読できる JSON 表現に変換できます。 これらの形式の関係の詳細については、MongoDB ウェブサイトのJSON と BSONのガイドを参照してください。
MongoDB と BSON
BSON インターフェース を実装する次のいずれかのオブジェクトタイプを使用して、 Kotlin Sync ドライバー アプリケーションで BSON データを操作できます。
ドキュメント （BSON ライブラリ パッケージ）
BsonDocument （BSON ライブラリ パッケージ）
RawBsonDocument （BSON ライブラリ パッケージ）
JsonObject （BSON ライブラリ パッケージ）
BSON ライブラリのインストール
次の手順では、BSON ライブラリを依存関係としてプロジェクトに追加する方法について詳しく説明します。
注意
すでにプロジェクトに Kotlin Sync ドライバーを依存関係として追加している場合は、この手順をスキップできます。 これは、BSON ライブラリがドライバーの必須依存関係としてすでに含まれているためです。
MongoDB Kotlin Sync ドライバーを依存関係としてプロジェクトに追加する方法の詳細については、「 使い始める 」ガイドの「ドライバーのインストール」セクションを参照してください。
Maven を使用することをお勧めします または Gradle Kotlin プロジェクトの依存関係を管理するためのビルド自動化ツール。次の手順では、Maven と Gradle の両方の依存関係宣言を詳しく説明します。
次のスニペットは、pom.xml ファイルの dependencies セクション内の依存関係宣言を示しています。
<dependencies> <dependency> <groupId>org.mongodb</groupId> <artifactId>bson</artifactId> <version>5.4.0</version> </dependency> </dependencies>
次のスニペットは、 build.gradleファイル内のdependenciesオブジェクト内の依存関係宣言を示しています。
dependencies { implementation("org.mongodb:bson:5.4.0") }
前述のツールのいずれも使用していない場合は、 sonatype リポジトリから JAR ファイルを直接ダウンロードすることで、プロジェクトに BSON 依存関係を含めることができます。