coldbox-orm-cborm

What problem does it solve?

Provide clear, actionable guidance for working with the cborm module in ColdBox so developers can implement reliable ORM services, criteria queries, transactional operations, and ORM event handling without wrestling with low-level Hibernate details.

Core Features & Use Cases

• BaseORMService and ActiveEntity patterns: implement standard CRUD, listing, counting, and HQL execution using a consistent API.
• Criteria and DetachedCriteria queries: build complex filters, projections, joins, pagination, and counts using the cborm fluent criteria API.
• Virtual entity services and DI: inject and use VirtualEntityService@cborm to operate on entities without dedicated service classes.
• ORM events and transactions: register lifecycle handlers (preInsert, preUpdate, preDelete, postInsert) and perform transactional operations with rollback handling.
• Use Case: implement a UserService that lists active users, enforces business rules on delete via an ORM event handler, and performs fund transfers inside transactional boundaries.

Quick Start

Create a BaseORMService method that lists active users using cborm criteria queries and include an example of a transactional save with rollback handling.