Skip to content
Open source tools to simplify Akka event sourcing, journaling/persistence, serialization, clustering and sharding.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
akka-tools-cluster
akka-tools-common/src/main/scala/no/nextgentel/oss/akkatools
akka-tools-jdbc-journal
akka-tools-json-serializing Started to remove deprecated code Nov 30, 2016
akka-tools-persistence Added AggregateV3 - with improved usability and DM-as-function Oct 17, 2018
examples GeneralAggregateView is now working as before - now using PersistentQ… Apr 21, 2017
img
project
.gitignore
.travis.yml
BUILD-howto.md
CHANGES.md
LICENSE.txt
MIGRATION-info.md
README.md
build.sbt
version.sbt

README.md

NextGenTel - Akka Tools

Build Status Maven Central

This project contains various addons to Akka useful when working with:

  • Cluster
  • Sharding
  • Persistence and Eventsourcing
  • Serializing

This code has turned out to be quite useful for NextGenTel and is used in production.

Version-information:

Akka akka-tools branch
2.5 2.5.x.x master
2.4 1.1.2 1.1

Changelog

The changes can be found in this file.

Migration from akka-tools 1.0.x

Info about how to migrate your source from akka-tools 1.0.x to 1.1.x can be found in MIGRATION-info.md.

Below is a summary of the various modules

akka-tools-persistence

akka-tools-persistence's main purpose is to make Akka Persistence more easy to use.

The main components are:

  • GeneralAggregate - which is built on top of PersistentActor
  • GeneralAggregateView - which is built on top of PersistentQuery

It includes features like:

  • Separation of aggregate, view and state(machine)
  • both aggregate and view understands the same events and uses the same "state machine"
  • integrated cluster/sharding-support
  • Simplified AtLeastOnceDelivery-support
  • Automatic starting and stopping (of idle) aggregates and views
  • Automatic working view that supports getting the current state (ie. to be used from REST) and the full event history (nice when debugging)

akka-tools-json-serializing

akka-tools-json-serializing is an Akka Serializer implementation that uses Jackson Json.

Json is a good match for evolving data-structures, but this serializer also supports coded data-structure-upgrading

akka-tools-jdbc-journal

akka-tools-jdbc-journal is a JDBC journal-plugin for Akka Persistence.

When used together with akka-tools-json-serializing, it also writes the json as 'plain-text' so that a human can understand the written data.

It supports Persistence Query with EventsByTagQuery (Also multiple tags in the same stream) amongst others

akka-tools-cluster

akka-tools-cluster contains cluster-related utilities like:

  • dynamic seedNode-resolving
  • Split-brain detection and recovering
  • ClusterSingletonHelper

examples

examples contains example code

You can’t perform that action at this time.