Overview
このガイドでは、 BSONデータ形式、 MongoDB でのデータ使用方法、およびKotlinドライバーとは別個にBSONライブラリをインストールする方法について学習できます。
BSON データ形式
BSON（Binary JSON ）は、 MongoDB がデータを整理して保存するために使用するデータ形式です。このデータ形式には、すべてのJSONデータ構造タイプが含まれ、日付、異なるサイズの整数、 値、バイナリObjectId データなどの他のタイプもサポートしています。サポートされているタイプの完全なリストについては、 MongoDBサーバーマニュアルの BSON types ページを参照してください。
バイナリ形式は人間が判読することはできませんが、 Java BSONライブラリを使用してJSON表現に変換できます。これらの形式の関係の詳細については、 JSONとBSONに関する記事を参照してください。
MongoDB と BSON
BSONライブラリを使用するKotlinドライバーは、 BSONインターフェースを実装するオブジェクトタイプのいずれかを使用してBSONデータを操作できます。次の型はBSONインターフェイスを実装します。
ドキュメント（BSONライブラリパッケージ）
BsonDocument（BSONライブラリパッケージ）
RawBsonDocument（BSONライブラリパッケージ）
JsonObject（BSONライブラリパッケージ）
BSON ライブラリのインストール
このセクションでは、 BSONライブラリを依存関係としてプロジェクトに追加する方法を示します。 Kotlinドライバーを依存関係としてプロジェクトに追加した 場合、 BSONライブラリはドライバーの必須依存関係としてすでに含まれているため、この手順をスキップできます。 Kotlinドライバーを依存関係としてプロジェクトに追加する方法については、 「 Kotlinドライバーを使い始める 」ガイドを参照してください。
Tip
ドキュメントの請求書
ドライバー アーティファクトのバージョンを管理するには、アプリケーションにJVMドライバーの請求書（BOM） をアプリケーションに追加することをお勧めします。これにより、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ファイルを直接ダウンロードすることで、それをプロジェクトに含めることができます。