rootid / reladomo

Reladomo is an enterprise grade object-relational mapping framework for Java.

Reladomo

What is it?

Reladomo is an object-relational mapping (ORM) framework for Java with the following enterprise features:

• Strongly typed compile-time checked query language
• Bi-temporal chaining
• Transparent multi-schema support
• Full support for unit-testable code
• See the documentation for more detail.

What can I do with it?

• Model data as objects with meaningful relationships between them
• Define classes and relationships using simple XML files
• Traverse, query, fetch, and update graphs of objects in an idiomatic object-oriented way
• Manage bi-temporal data using built-in methods
• Define, create, query, and update data that has both business date and processing date axes
• Maintain complete and accurate audit history of changes efficiently
• Answer as-of questions such as "what did this object look like at the end of last quarter"
• Build applications as diverse as interactive web-apps to batch-processing
• Leverage transactions and batch operations to support high-performance throughput
• Detach objects to allow users to change data off-line
• Write database vendor-independent code

Detailed feature list

• Strongly typed compile-time checked query language
• Audit-only, Business time-series only, and Bi-temporal chaining
• Transparent multi-schema support (partition data across many databases)
• Object-oriented batch operations
• Flexible object relationship inflation
• Detached objects (allow data to be changed independently (a.k.a. delayed edit functionality) of the DB and then pushed (or reset) as and when required) - useful when users are editing data in a GUI form
• Multi-Threaded matcher Loader (MTLoader) is a high-performance pattern for merging changes from another source (file, feed, other DB, etc.) to your existing DB data. By design it is flexible/customizable and re-runnable
• Tunable caching by object type - partial, full, full off-heap
• Available meta-data - enables higher-level programming paradigms
• Multi-tier operation - obviates the need for direct DB access from client-side apps, enables better connection sharing, with no code changes required
• Full support for unit-testable code
• Databases supported include: Sybase (ASE & IQ), DB2, Oracle, Postgres, MS-SQL, H2, Derby, "generic" ...

Sample Project

To help getting started with Reladomo, a simple project is available with maven and gradle build set-up.

Prerequisite: install maven or gradle.

git clone https://github.com/goldmansachs/reladomo.git
cd samples/reladomo-sample-simple

Maven

mvn clean install

Gradle

gradle clean build

Once build is successful, run src/main/java/sample/HelloReladomoApp to see how it behaves.

Documentation

Documentation is available online and also included within the Reladomo Javadoc jar file. Extract the jar file and refer to the docs below.

Reference	Description	File Path
Tutorial	This tutorial demonstrates the necessary steps to get your Reladomo project started.	userguide/ReladomoTutorial.html
FAQ	Reladomo FAQ	mithrafaq/ReladomoFaq.html
Reladomo Test Resource	This document explains the steps required to use Reladomo objects in unit tests.	mithraTestResource/ReladomoTestResource.html
Reladomo Notification	When you have multiple JVMs connecting to a DB via Reladomo, you need to keep each JVM up-to-date with changes made by any of the other JVMs. Reladomo Notification is the primary mechanism for achieving this and keeping each JVMs Reladomo cache fresh.	notification/Notification.html
Reladomo Primary Key Generator	Primary key generator is an optional feature in Reladomo that allows Reladomo objects to declare how the primary key is going to be generated.	primaryKeyGenerator/PrimaryKeyGenerator.html
Reladomo Database Definition Generators	Database definition language (DDL) file generation is an optional feature in Reladomo that allows users to generate scripts to create tables, indices and foreign keys from the Reladomo object definition XML files.	mithraddl/ReladomoDdlGenerator.html
Reladomo Object XML Generator	To expedite the creation of object XML files from existing schema, an object XML file generator has been created. It connects directly to a database, retrieving a list of the existing tables and generating object XML files that appropriately map to these tables.	objectxmlgenerator/Generator.html
Visualize Domain Model Using Reladomo Metadata	When a persistent set of objects is specified in Reladomo metadata, the objects can be visualized. The output can be used as documentation, or simply browsed through to gain understanding of the domain.	visualization/ReladomoVisualization.html
Reladomo Architecture	Reladomo internal architecture.	architecture/ReladomoInternalArchitecture.html
Presentations	Reladomo presentation materials.	presentations

Acquiring Reladomo

• Versions
• Maven Central