uk.dioxic.mgenerate:mgenerate-parent

mgenerate4j is a tool for generating rich JSON documents from a template.

It can be used as a standalone application or as a library and is also extendable if you need to do something that isn't covered by the out-of-the-box functions.

The core syntax is largely the same as mgeneratejs by Thomas Rueckstiess.

To find out more, please check out the mgenerate4j wiki.

Example

Here we have a template that defines 3 fields; a random name, a random age and an array with 2 random email address.

Template

{ "name": "$name", "age": "$age", "emails": { "$array": { "of": "$email", "number": 2} } }

Output

{"name": "Jeffery Dooley", "age": 71, "emails": ["[e-mail]", "[e-mail]"]}
{"name": "Durward Morar", "age": 3, "emails": ["[e-mail]", "[e-mail]"]}
{"name": "Reyes Cartwright", "age": 42, "emails": ["[e-mail]", "[e-mail]"]}
{"name": "Naomi Nicolas", "age": 117, "emails": ["[e-mail]", "[e-mail]"]}
{"name": "Athena Buckridge", "age": 36, "emails": ["[e-mail]", "[e-mail]"]}

Quickstart

Assuming git and Maven installed:

$ git clone https://github.com/dioxic/mgenerate4j.git
$ mvn clean package
$ java -jar mgenerate-core/target/mgenerate.jar example-template.json

To import as a maven dependency:

<dependency>
    <groupId>uk.dioxic.mgenerate</groupId>
    <artifactId>mgenerate-core</artifactId>
    <version>0.0.5</version>
</dependency>

To import as a gradle dependency:

dependencies {
    compile 'uk.dioxic.mgenerate:mgenerate-core:0.0.5'
}

Note: precompiled executable jars are also available in releases.

Usage

Standalone

Usage: mgenerate [-h] [--debug] [-n=<number>] [-o=<output>] TEMPLATE
      TEMPLATE            template file path
      --debug             debug logging
  -h, --help              display a help message
  -n, --number=<number>   number of documents to generate (default: 10)
  -o, --out=<output>      output file path

$ java -jar mgenerate.jar template.json

Library

MongoClientSettings mcs = MongoClientSettings.builder()
        .codecRegistry(TemplateCodec.getCodecRegistry())
        .build();

Template template = Template.from("c:\\tmp\\mongo.json");
MongoCollection<Template> collection = MongoClients.create(mcs)
        .getDatabase("test")
        .getCollection("mgen", Template.class);

collection.insertOne(template);
collection.insertOne(template);
collection.insertOne(template);

This will result in 3 different documents being inserted since the template is hydrated during encoding.

License

Apache 2.0