/micronaut-predator

Ahead of Time Data Repositories

Primary LanguageJavaApache License 2.0Apache-2.0

Micronaut Predator

Maven Central Build Status

Micronaut Predator (short for Precomputed Data Repositories) is a database access toolkit that uses Ahead of Time (AoT) compilation to pre-compute queries for repository interfaces that are then executed by a thin, lightweight runtime layer.

Predator is inspired by GORM and Spring Data, however improves on those solutions in the following ways:

  • No runtime model - Both GORM and Spring Data maintain a runtime meta-model that uses reflection to model relationships between entities. This model consumes significant memory and memory requirements grow as your application size grows. The problem is worse when combined with Hibernate which maintains its own meta-model as you end up with duplicate meta-models.
  • No query translation - Both GORM and Spring Data use regular expressions and pattern matching in combination with runtime generated proxies to translate a method definition on a Java interface into a query at runtime. No such runtime translation exists in Predator and this work is carried out by the Micronaut compiler at compilation time.
  • No Reflection or Runtime Proxies - Predator uses no reflection or runtime proxies, resulting in better performance, smaller stack traces and reduced memory consumption due to a complete lack of reflection caches (Note that the backing implementation, for example Hibernate, may use reflection).
  • Type Safety - Predator will actively check at compile time that a repository method can be implemented and fail compilation if it cannot.

See also the Predator Announcement for details about how and why Predator was built.

Documentation

See the Snapshot Documentation for the current development docs.

Examples

Examples can be found in the examples directory.