Morphium

A Java ODM for MongoDB that does more than mapping.

Object mapping. Built-in messaging. In-memory testing. One dependency.

Explore Features Read the Docs
v6.2.0 · Quarkus Extension
⚙

Zero-Config ODM

Annotate POJOs, get persistence. @Entity, @Id, @Index — no XML, no codec registries.

✉

Built-in Messaging

MongoDB-backed message queue. No Kafka, no RabbitMQ, no extra infrastructure.

⚡

In-Memory Testing

Full MongoDB emulation in-process. Tests in milliseconds, no Docker required.

☐

Jakarta Data Ready

Declarative @Repository interfaces with build-time query generation.

Data Access & Persistence

Map Java objects to MongoDB documents with annotations, caching, versioning and type-safe queries.

Product Catalog

Core CRUD operations, embedded documents, indexing, LRU caching and field mapping.

@Entity @Index @Embedded @Cache

Blog System

Versioning, cross-collection references, lifecycle callbacks and automatic timestamps.

@Version @Reference @CreationTime @Lifecycle

Polymorphism

Java type hierarchies with automatic type discriminators and custom type mappers.

typeId TypeMapper Inheritance

Advanced Query

Fluent query builder with every MongoDB operator, pagination, projections and text search.

Query API Regex Projection

Jakarta Data 1.0

Declarative @Repository interfaces with query derivation, JDQL and MorphiumRepository escape hatch.

@Repository JDQL @StaticMetamodel

Processing & Analytics

Aggregation pipelines, bulk operations and geospatial queries for data processing at scale.

Sales Analytics

Type-safe aggregation pipelines with group, project, sort, bucket and lookup stages.

Aggregation $group $lookup

Bulk Import

Batch operations, write buffers, cursor-based iteration, sequences and array operations.

storeList Iterator Sequence

Store Locator

Geospatial queries with 2dsphere indexes, $near and $geoWithin operations.

GeoJSON $near $geoWithin

Platform & Operations

Messaging, transactions, audit logging and health monitoring built into the framework.

Messaging

MongoDB-backed message queue with topics, exclusive messages and live updates via SSE.

Messaging Topics SSE

Transactions

@MorphiumTransactional CDI interceptor, atomic inc/dec and version-based locking.

@MorphiumTransactional inc/dec @Version

Audit Log

Capped collections, tailable cursors and lifecycle callbacks for automatic logging.

@Capped Tailable @Lifecycle

Health Checks

MicroProfile Health probes auto-registered by the Quarkus extension. Zero configuration.

Liveness Readiness Startup

Resources

Documentation Hub

Browse the full Morphium documentation: guides, API reference, how-tos and configuration.

Guides API Reference How-Tos