Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

faked out in-memory mongo for java

branch: master

This branch is 0 commits ahead and 0 commits behind master

Fetching latest commit…

Cannot retrieve the latest commit at this time

README.md

fongo

Fongo is an in-memory java implementation of mongo. It intercepts calls to the standard mongo-java-driver for finds, updates, inserts, removes and other methods. The primary use is for lightweight unit testing where you don't want to spin up a mongo process.

The original hope was that this would be significantly faster than using a real mongo server, however, it's still not clear if that's the case. Another goal was to make it easier to parallelize tests, but that could also be achieved by fixing each thread to a uniquely named database.

Usage

  1. Clone this repo and build the jar: mvn package
  2. Copy jar to classpath
  3. Use in place of regular com.mongodb.Mongo instance:
import com.foursquare.fongo.Fongo;
import com.mongodb.BasicDBObject;
import com.mongodb.DB;
import com.mognodb.DBCollection;
...
Fongo fongo = new Fongo("mongo server 1");

// once you have a DB instance, you can interact with it
// just like you would with a real one.
DB db = fongo.getDB("mydb");
DBCollection collection = db.getCollection("mycollection");
collection.insert(new BasicDBObject("name", "jon"));

Scope

fongo doesn't implement all mongo functionality. most query and update syntax is supported. MapReduce, gridfs, and capped collections are not supported. Also, there is no index support other than the _id index. Fongo uses a LinkedHashMap internally with the _id as the key.

Implementation Details

Fongo depends on mockito to hijack the com.mongodb.Mongo class. It has a "provided" dependency on the mongo-java-driver and was tested with 2.7.2. It also has a "provided" dependency on sl4j-api for logging. If you don't already have sl4j in your project, you can add a maven dependency to the logback implementation like this:

<dependency> 
  <groupId>ch.qos.logback</groupId>
  <artifactId>logback-classic</artifactId>
  <version>1.0.4</version>
</dependency>

Fongo should be thread safe. All read and write operations on collections are synchronized. It's pretty course, but should be good enough for simple testing. Fongo doesn't have any shared state (no statics). Each Fongo instance is completely independent.

Usage Details

// Fongo instance methods

// get all created databases (they are created automatically the first time requested)
Collection<DB> dbs = fongo.getUsedDatabases();
// also
List<String> dbNames = fongo.getDatabaseNames();
// also
fongo.dropDatabase("dbName");

// get an instance of the hijacked com.mongodb.Mongo
Mongo mongo = fongo.getMongo();

Todo

  • more testing
  • publish to one of the maven repos
  • find an actual use for this project
Something went wrong with that request. Please try again.