Overview
このガイドでは、BSON データ形式、MongoDB でのデータの使用方法、および Scala ドライバーとは別個に BSON ライブラリをインストールする方法について学ぶことができます。
BSON データ形式
BSON, or Binary JSON, is the data format that MongoDB uses to organize and store data. This data format includes all JSON data structure types and also supports other types, including dates, different size integers, ObjectId values, and binary data. For a complete list of supported types, see the BSON Types page in the MongoDB Server manual.
The binary format is not human-readable, but you can use the Java BSON library to convert it to a JSON representation. To learn more about the relationship between these formats, see the JSON and BSON article.
MongoDB と BSON
BSONライブラリを使用するScalaドライバーでは、 BSONインターフェースを実装するオブジェクトタイプのいずれかを使用してBSONデータを操作できます。次の型はBSONインターフェイスを実装します。
ドキュメント(BSONライブラリパッケージ)
BsonDocument(BSONライブラリパッケージ)
RawBsonDocument(BSONライブラリパッケージ)
JsonObject(BSONライブラリパッケージ)
BasicDBObject (JVM package)
BSON ライブラリのインストール
このセクションでは、BSON ライブラリを依存関係としてプロジェクトに追加する方法を示します。Scala ドライバーを依存関係としてプロジェクトに追加した場合、BSON ライブラリはドライバーの必須依存関係としてすでに含まれているため、この手順はスキップできます。Scala ドライバーを依存関係としてプロジェクトに追加する手順については、 Scala ドライバーの使用開始ガイドを参照してください。
Tip
ドキュメントの請求書
ドライバーアーティファクトのバージョンを管理するには、JVMドライバーの部品表 (BOM)をアプリケーションに追加することをお勧めします。これにより、BOMに含まれる個別パッケージのバージョンを指定する必要がなくなり、依存関係のマネジメントが簡素化されます。詳細については、Scalaドライバーを使い始める ガイドを参照してください。
プロジェクトの依存関係を管理するには、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ファイルを直接ダウンロードすることで、それをプロジェクトに含めることができます。