ch.squaredesk.nova:rest

Java libraries for rapid (micro) service development

License

License

Squaredesk Open Source License
Categories

Categories

Square Business Logic Libraries Financial
GroupId

GroupId

ch.squaredesk.nova
ArtifactId

ArtifactId

rest
Last Version

Last Version

7.0.3
Release Date

Release Date

Type

Type

jar
Description

Description

Java libraries for rapid (micro) service development

Download rest

How to add to project

<!-- https://jarcasting.com/artifacts/ch.squaredesk.nova/rest/ -->
<dependency>
    <groupId>ch.squaredesk.nova</groupId>
    <artifactId>rest</artifactId>
    <version>7.0.3</version>
</dependency>
// https://jarcasting.com/artifacts/ch.squaredesk.nova/rest/
implementation 'ch.squaredesk.nova:rest:7.0.3'
// https://jarcasting.com/artifacts/ch.squaredesk.nova/rest/
implementation ("ch.squaredesk.nova:rest:7.0.3")
'ch.squaredesk.nova:rest:jar:7.0.3'
<dependency org="ch.squaredesk.nova" name="rest" rev="7.0.3">
  <artifact name="rest" type="jar" />
</dependency>
@Grapes(
@Grab(group='ch.squaredesk.nova', module='rest', version='7.0.3')
)
libraryDependencies += "ch.squaredesk.nova" % "rest" % "7.0.3"
[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

Maven Central Codeship Status for oli-d/nova Codacy Badge

Quality gate

Security Rating Reliability Rating Maintainability Rating

Lines of Code Vulnerabilities SonarCloud Bugs Code Smells Technical Debt

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

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
7.0.2
7.0.1
7.0.0
6.0.0