ch.squaredesk.nova:rest

Java libraries for rapid (micro) service development

License	Squaredesk Open Source License
Categories	Square Business Logic Libraries Financial
GroupId	ch.squaredesk.nova
ArtifactId	rest
Last Version	7.0.3
Release Date	Mar 7, 2019
Type	jar
Description	Java libraries for rapid (micro) service development

Download rest

Filename	Size
rest-7.0.3.pom
rest-7.0.3.jar	10 KB
rest-7.0.3-sources.jar	7 KB
rest-7.0.3-javadoc.jar	42 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/ch.squaredesk.nova/rest/ -->
<dependency>
    <groupId>ch.squaredesk.nova</groupId>
    <artifactId>rest</artifactId>
    <version>7.0.3</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/ch.squaredesk.nova/rest/
implementation 'ch.squaredesk.nova:rest:7.0.3'

Gradle Kotlin

// https://jarcasting.com/artifacts/ch.squaredesk.nova/rest/
implementation ("ch.squaredesk.nova:rest:7.0.3")

Apache Buildr

'ch.squaredesk.nova:rest:jar:7.0.3'

Apache Ivy

<dependency org="ch.squaredesk.nova" name="rest" rev="7.0.3">
  <artifact name="rest" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='ch.squaredesk.nova', module='rest', version='7.0.3')
)

Scala SBT

libraryDependencies += "ch.squaredesk.nova" % "rest" % "7.0.3"

Leiningen

[ch.squaredesk.nova/rest "7.0.3"]

Dependencies

compile (14)

Group / Artifact	Type	Version
ch.squaredesk.nova : http-spring	jar	7.0.3
org.glassfish.jersey.containers : jersey-container-grizzly2-http	jar	2.25.1
org.glassfish.jersey.media : jersey-media-multipart	jar	2.25.1
org.glassfish.jersey.media : jersey-media-json-jackson	jar	2.25.1
com.fasterxml.jackson.jaxrs : jackson-jaxrs-base	jar	2.9.8
com.fasterxml.jackson.jaxrs : jackson-jaxrs-json-provider	jar	2.9.8
com.fasterxml.jackson.core : jackson-annotations	jar	2.9.8
com.fasterxml.jackson.datatype : jackson-datatype-jsr310	jar	2.9.8
javax.xml.bind : jaxb-api	jar	2.2.11
com.sun.xml.bind : jaxb-core	jar	2.2.11
com.sun.xml.bind : jaxb-impl	jar	2.2.11
javax.activation : activation	jar	1.1.1
org.slf4j : slf4j-api	jar	1.7.25
ch.qos.logback : logback-classic	jar	1.2.3

test (5)

Group / Artifact	Type	Version
ch.squaredesk.nova : rest-test-utils	jar	7.0.1
org.junit.jupiter : junit-jupiter-api	jar	5.2.0
org.junit.jupiter : junit-jupiter-params	jar	5.2.0
org.hamcrest : hamcrest-junit	jar	2.0.0.0
org.awaitility : awaitility	jar	3.1.0

Project Modules

There are no modules declared in this project.

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 (Node for Java). 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,
2. the need to split a long running execution into various parts and emit artificial "sub events", and
3. 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 functionality, used by all other components

• Communication

  • comm: communication base library providing protocol agnostic, reactive message sending and retrieval
  • jms: reactive JMS messaging
  • http: reactive HTTP communication
  • rest: annotation based REST communication according to the JAX-RS spec
  • websockets: reactive WebSocket communication
  • kafka: reactive Kafka communication

• Service related

  • service: Small service skeleton with a defined lifecycle and easy access to Nova and its EventBus
  • metrics-serialization: Utility to easily serialize MetricDumps
  • metrics-elastic: Utility to push Metrics to Elasticsearch
  • metrics-kafka: Utility to push Metrics to Kafka

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:

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>ch.squaredesk.nova</groupId>
            <artifactId>bom</artifactId>
            <version>9.0.0</version>
            <scope>import</scope>
            <type>pom</type>
        </dependency>
    </dependencies>
</dependencymanagement>

Versions

Version
7.0.3 Mar 7, 2019
7.0.2 Dec 13, 2018
7.0.1 Nov 20, 2018
7.0.0 Nov 1, 2018
6.0.0 Oct 3, 2018