Holon Platform MongoDB Datastore module. This is the MongoDB implementation of the Datastore API, with asynchronous and reactive interaction support, along with a full Spring and Spring Boot integration.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bom
core-async
core
datastore-async
datastore-reactor
datastore-sync
documentation
spring-boot
spring
starter-reactor
starter
.gitignore
CODEOWNERS
CONTRIBUTING.md
LICENSE
README.md
pom.xml

README.md

Holon platform MongoDB Datastore module

Latest release: 5.2.1

This is the reference MongoDB implementation of the Holon Platform Datastore API, using the MongoDB Java driver for data access and manipulation.

The following interaction models are supported:

  • Synchronous interaction, using the holon-datastore-mongo-sync artifact.
  • Asynchronous interaction, using the holon-datastore-mongo-async artifact.
  • Reactive interaction, using the holon-datastore-mongo-reactor artifact and the Project Reactor library.

See the Datastore API documentation for information about the Holon Platform Datastore API.

A full Spring and Spring Boot integration is provided, which includes auto-configuration facilities and a set of starters to quickly setup project dependencies.

Just like any other platform module, this artifact is part of the Holon Platform ecosystem, but can be also used as a stand-alone library.

See Getting started and the platform documentation for further details.

Code structure

See Holon Platform code structure and conventions to learn about the "real Java API" philosophy with which the project codebase is developed and organized.

Getting started

System requirements

The Holon Platform is built using Java 8, so you need a JRE/JDK version 8 or above to use the platform artifacts.

Releases

See releases for the available releases. Each release tag provides a link to the closed issues.

Obtain the artifacts

The Holon Platform is open source and licensed under the Apache 2.0 license. All the artifacts (including binaries, sources and javadocs) are available from the Maven Central repository.

The Maven group id for this module is com.holon-platform.reactor and a BOM (Bill of Materials) is provided to obtain the module artifacts:

Maven BOM:

<dependencyManagement>
    <dependency>
        <groupId>com.holon-platform.mongo</groupId>
        <artifactId>holon-datastore-mongo-bom</artifactId>
        <version>5.2.1</version>
        <type>pom</type>
        <scope>import</scope>
    </dependency>
</dependencyManagement>

See the Artifacts list for a list of the available artifacts of this module.

Using the Platform BOM

The Holon Platform provides an overall Maven BOM (Bill of Materials) to easily obtain all the available platform artifacts:

Platform Maven BOM:

<dependencyManagement>
    <dependency>
        <groupId>com.holon-platform</groupId>
        <artifactId>bom</artifactId>
        <version>${platform-version}</version>
        <type>pom</type>
        <scope>import</scope>
    </dependency>
</dependencyManagement>

See the Artifacts list for a list of the available artifacts of this module.

Build from sources

You can build the sources using Maven (version 3.3.x or above is recommended) like this:

mvn clean install

Getting help

Examples

See the Holon Platform examples repository for a set of example projects.

Contribute

See Contributing to the Holon Platform.

Gitter chat Join the contribute Gitter room for any question and to contact us.

License

All the Holon Platform modules are Open Source software released under the Apache 2.0 license.

Artifacts list

Maven group id: com.holon-platform.mongo

Artifact id Description
holon-datastore-mongo-core Common operations and data structures
holon-datastore-mongo-core-async Common operations and data structures for the asynchronous Datastore API implementation
holon-datastore-mongo-sync Synchronous MongoDB Datastore API implementation
holon-datastore-mongo-async Asynchronous MongoDB Datastore API implementation
holon-datastore-mongo-reactor Reactive MongoDB Datastore API implementation using Project Reactor
holon-datastore-mongo-spring Spring integration using the @EnableMongoDatastore and EnableMongoAsyncDatastore annotation
holon-datastore-mongo-spring-boot Spring Boot integration for MongoDB Datastore auto-configuration
holon-starter-mongo-datastore Spring Boot starter for the MongoDB Datastore auto-configuration
holon-starter-mongo-datastore-reactor Spring Boot starter for the reactive MongoDB Datastore implementation auto-configuration
holon-datastore-mongo-bom Bill Of Materials
documentation-datastore-mongo Documentation