Skip to content
This repository


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

A Vert.x busmod for mocking out the mongo-persistor using fongo

branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

This is a Vert.x busmod providing a Fongo database. The primary intention is for replacing a real Mongo persistor busmod on the event bus in Java or Groovy unit tests. However, it is also possible to deploy as in a Vert.x container just like any other busmod.


  • Clone this repository.
  • Ensure that you have the environment variable VERTX_MODS set to the directory where you want mods to be installed.
  • Use ./gradlew install to install the busmod.

Using embedded

You can use the Fongo Persistor as an event bus handler when using embedded vert.x in your tests (see Testing With Embedded Vert.x).


private Vertx vertx = Vertx.newVertx();
FongoPersistor persistor = new FongoPersistor();

@Before void startFongo() {

@After void stopFongo() {


@Shared Vertx vertx = Vertx.newVertx()
def persistor = new FongoPersistor()

void setup() {
    persistor.vertx = vertx.toJavaVertx()

void cleanup() {

Using as a busmod

The Fongo Persistor needs to be installed in VERTX_MODS then you can simply register it as you would any other busmod using deployVerticle('fongo-persistor')

 Example app

There is an example app in examples/webapp. This is simply the standard Vert.x webapp example but using a fongo-persistor instead of a mongo-persistor.

To run the example ensure that you have the VERTX_MODS environment variable set, then:

./gradlew install
cd examples/web-app
vertx run App.groovy

then point your browser at https://localhost:8080/index.html

Something went wrong with that request. Please try again.