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 ライブラリがドライバーの必須依存関係としてすでに含まれているためです。
Kotlinプロジェクトの依存関係を管理するには、 Maven または Gradle ビルドオートメーションツールを使用する ことをお勧めします。次の手順では、Maven と Gradle の両方の依存関係宣言を詳しく説明します。
次のスニペットは、pom.xml ファイルの dependencies セクションにある依存関係宣言を示しています。
<dependencies> <dependency> <groupId>org.mongodb</groupId> <artifactId>bson</artifactId> <version>5.0.0</version> </dependency> </dependencies>
次のスニペットは、 build.gradleファイル内のdependenciesオブジェクト内の依存関係宣言を示しています。
dependencies { implementation("org.mongodb:bson:5.0.0") }
前述のツールのいずれも使用していない場合は、sonatypeリポジトリから JARファイルを直接ダウンロードすることで、プロジェクトにBSON依存関係を含めることができます。