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