Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/oli-d/nova

Java libraries for rapid (micro) service development
https://github.com/oli-d/nova

asynchronous event-driven java micro-framework microservices reactive-programming

Last synced: 5 days ago
JSON representation

Java libraries for rapid (micro) service development

Awesome Lists containing this project

README

        

# Nova

[![Maven Central](https://maven-badges.herokuapp.com/maven-central/ch.squaredesk.nova/bom/badge.svg?style=plastic)](https://maven-badges.herokuapp.com/maven-central/ch.squaredesk.nova/bom)
[![Codeship Status for oli-d/nova](https://app.codeship.com/projects/2283d970-1edb-0135-0041-4ec1c01dd1d7/status?branch=master)](https://app.codeship.com/projects/220890)
[![Codacy Badge](https://api.codacy.com/project/badge/Grade/46d98c14e90b472b8bc550deb0869c72)](https://www.codacy.com/app/oli-d/nova?utm_source=github.com&utm_medium=referral&utm_content=oli-d/nova&utm_campaign=Badge_Grade)

[![Quality gate](https://sonarcloud.io/api/project_badges/quality_gate?project=oli-d_nova)](https://sonarcloud.io/dashboard?id=oli-d_nova)

[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=oli-d_nova&metric=security_rating)](https://sonarcloud.io/dashboard?id=oli-d_nova)
[![Reliability Rating](https://sonarcloud.io/api/project_badges/measure?project=oli-d_nova&metric=reliability_rating)](https://sonarcloud.io/dashboard?id=oli-d_nova)
[![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=oli-d_nova&metric=sqale_rating)](https://sonarcloud.io/dashboard?id=oli-d_nova)

[![Lines of Code](https://sonarcloud.io/api/project_badges/measure?project=oli-d_nova&metric=ncloc)](https://sonarcloud.io/dashboard?id=oli-d_nova)
[![Vulnerabilities](https://sonarcloud.io/api/project_badges/measure?project=oli-d_nova&metric=vulnerabilities)](https://sonarcloud.io/dashboard?id=oli-d_nova)
[![SonarCloud Bugs](https://sonarcloud.io/api/project_badges/measure?project=oli-d_nova&metric=bugs)](https://sonarcloud.io/component_measures/metric/reliability_rating/list?id=oli-d_nova)
[![Code Smells](https://sonarcloud.io/api/project_badges/measure?project=oli-d_nova&metric=code_smells)](https://sonarcloud.io/dashboard?id=oli-d_nova)
[![Technical Debt](https://sonarcloud.io/api/project_badges/measure?project=oli-d_nova&metric=sqale_index)](https://sonarcloud.io/dashboard?id=oli-d_nova)

### 1. Why?
The goal of this project is to provide a small and easy-to-use
library that enables developers to rapidly build systems or
services in an "event driven, asynchronous and reactive style".

The origins of the API were heavily influenced by Node.js and
its underlying programming model, hence the name (**No**de for
Ja**va**). This programming model, which (for those who have
no experience with Node.js) is based on single-threaded event
processing, prove itself to be very helpful in eliminating
nasty concurrency bugs and to allow the programmer to fully
concentrate on the business logic.

However, as everything in life, this also came with a downside.
Mainly, there were three things we had to fight with
1. call back hell for business logic that depends on multiple
data sources,
1. the need to split a long running execution into various parts
and emit artificial "sub events", and
1. improper event processing can easily block your one and only
thread, rendering the whole service unresponsive.

Therefore, we changed the philosophy (and implementation) of the
library and based it on RxJava (2.0) to promote a fully reactive
way of programming.

* Being reactive makes it very easy to express business logic based
on various information sources and define "if this than that" scenarios.
* To the client, it is completely transparent whether information is
delivered synchronously or asynchronously
* The client is under full control over the threading model. It can
chose to go single threaded (if it has to mutate shared state) or
multi threaded (for full system performance) at will. Going
fully functional even eliminates that question

### 2. What's included?

Nova provides a couple of very small libraries. Those libraries try to focus on one (and only one) problem and try to
solve it in a consistent way, making it easy to combine them. They provide solutions for common, technical problems,
allowing service developers to concentrate on the required business logic.

Currently, the following libraries exist:

- Core functionality
* [core](./core/README.md): core functionality, used by all other components

- Communication
* [comm](./comm/README.md): communication base library providing protocol agnostic, reactive message sending and retrieval
* [jms](./jms/README.md): reactive JMS messaging

- spring-boot related
* [nova-starter](./nova-starter/README.md): Module to conveniently use Nova functionality with spring-boot

### 3. How do I integrate it in my projects?

The easiest way is to retrieve Nova from Maven central. We recommend you are using
```maven```'s dependency management feature and import the ```BOM```, so that
you can be sure that all included modules properly work with each other:

```xml



ch.squaredesk.nova
bom
10.0.0
import
pom

```