Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/projectbarbel/barbelhisto-core
Lightweight ultra-fast library to store data in bi-temporal format
https://github.com/projectbarbel/barbelhisto-core
bitemporal framework java
Last synced: 26 days ago
JSON representation
Lightweight ultra-fast library to store data in bi-temporal format
- Host: GitHub
- URL: https://github.com/projectbarbel/barbelhisto-core
- Owner: projectbarbel
- License: mit
- Created: 2018-12-24T09:09:06.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2023-09-19T17:44:47.000Z (about 1 year ago)
- Last Synced: 2024-08-04T23:10:44.309Z (4 months ago)
- Topics: bitemporal, framework, java
- Language: Java
- Homepage:
- Size: 1.29 MB
- Stars: 42
- Watchers: 2
- Forks: 0
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-data-temporality - BarbelHisto - fast Java library to store data in bi-temporal format (Bi-temporality Tools + Modeling)
README
# barbelhisto
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Build Status](https://app.travis-ci.com/projectbarbel/barbelhisto-core.svg?branch=master)](https://app.travis-ci.com/projectbarbel/barbelhisto-core)
[![Maven Central](https://img.shields.io/maven-central/v/org.projectbarbel/barbelhisto.svg)](https://search.maven.org/search?q=barbelhisto)A lightweiht easy to use Java library to store the history of changes of domain objects in bi-temporal format.
`BarbelHisto` tracks two time dimensions for you: **record time** is when a change to a domain object was recorded in the system (created and inactivated) and **effective time** is when this change is opposed to become effective or valid from a business viewpoint.
The library implements Martin Fowlers Temporal Pattern that can be found here: https://martinfowler.com/eaaDev/timeNarrative.html
# Features
- bi-temporal (auditing-proof) data storage based on blazing fast [cqengine](https://github.com/npgall/cqengine) collections
- small easy-to-use API (as simple as bi-temporal data storage can get)
- backed by transactional, high performance collections
- works out of the box with default implementation and configuration
- manage different time zones of client and server
- persistence support for heap, off-heap, disk storage and custom data stores
- provides basic functionality, extendible for individual needs
- remember every change to the data, nothing is ever going to be deleted
- build-in thread safety by minimizing mutability and object locking
- pretty print function to learn about bitemporal data storage# Get a version of BarbelHisto
Get a version on [Maven Central](https://search.maven.org/search?q=barbelhisto).Download the [actual snapshot releases](https://github.com/projectbarbel/barbelhisto-core/releases).
Or clone this git repository to try some of the features of `BarbelHisto`.
# Getting started with POJOs
- [Get started with Spring turorial](https://dzone.com/articles/integrating-bi-temporal-data-in-spring-boot-applic)
- [Get started with Mongo turorial](https://dzone.com/articles/setting-up-mongodb-for-bi-temporal-data-in-5-minut)# Memory analysis
Memory analysis results. One hour run, 5000 Objects saved every 10 seconds. `OnHeapPersistence`.
Result details [here](https://github.com/projectbarbel/barbelhisto-core/blob/master/performance/BarbelCoreSaveMemoryTest.txt).
![Memory](https://user-images.githubusercontent.com/876604/53019849-fb084b00-3455-11e9-8625-6c2bf1be1576.png)