Reactive Scala Driver for MongoDB

Asynchronous & Non-Blocking

Running Commands

A MongoDB Command is a special query that returns at most one document. It is run on a database, and may concern a given collection. In ReactiveMongo, you can run commands using db.command(<command>).

The return type of db.command() depends on the kind of command you gave it as a parameter; for example, with Count it would return Future[Int]:

import reactivemongo.core.commands.Count

// count the number of documents which tag equals "closed"
val query = BSONDocument("tag" -> "closed")
val command = Count("collectionName", Some(query))
val result = db.command(command) // returns Future[Int] { numberOfDocs =>
  // do something with this number

Some widely used commands, like Count or FindAndModify, are available in ReactiveMongo. But how to run commands that are not explicitly supported?

Run any command with RawCommand

It is possible to run any kind of commands, even if they are not specifically implemented in ReactiveMongo yet. Since a command in MongoDB is nothing more than a query on the special collection $cmd that returns a document, you can make your own command with RawCommand, which result type is Future[BSONDocument]. Let’s take a look to the following example involving the Aggregation Framework (you can find this example in the MongoDB documentation):

// MongoDB Console example of Aggregate command
  { $match: { status: "A" } },
  { $group: { _id: "$cust_id", total: { $sum: "$amount" } } },
  { $sort: { total: -1 } }

Actually, the MongoDB console sends a document that is a little bit more complex to the server:

// document sent to the database using the MongoDB console
var command =
    "aggregate": "orders", // name of the collection on which we run this command
    "$pipeling": [
      { $match: { status: "A" } },
      { $group: { _id: "$cust_id", total: { $sum: "$amount" } } },
      { $sort: { total: -1 } }
// run the command

We do exactly the same thing with RawCommand, by making a BSONDocument that contains the same fields:

val commandDoc =
    "aggregate" -> "orders", // we aggregate on collection `orders`
    "$pipeline" -> BSONArray(
      BSONDocument("$match" -> BSONDocument("status" -> "A")),
        "$group" -> BSONDocument(
          "_id" -> "$cust_id",
          "total" -> BSONDocument("$sum" -> "$amound"))),
      BSONDocument("$sort" -> BSONDocument("total" -> -1))

// we get a Future[BSONDocument]
val futureResult = db.command(RawCommand(commandDoc)) { result => // result is a BSONDocument
  // ...