/katharsis-core

Core for Java JSON:API library

Primary LanguageJavaApache License 2.0Apache-2.0

The Katharsis library adds an additional layer on top of RESTful endpoint to provide easy HATEOAS support for Java by implementing JSON:API standard.

katharsis-core

Build Status Coverage Status Dependency Status Maven Central

Systems nowadays utilize data from various systems to leverage the business needs. To achieve that, many of them provide usually inconsistent REST interface.

Providing homogeneous REST interface

Katharsis implements JSON:API standard which introduce consistent REST interface definition. Now it can be easy to integrate with other systems through uniform mechanisms.

Use the purest form of REST

JSON:API is based on HATEOAS which means Hypermedia as the Engine of Application State. It is the highest form of REST which allows producing and storing as little documentation as possible.


By using Katharsis it is easier to develop both Customer Facing Applications and server side services. The developers can have one unified base for their work.

Consistent resources and repositories

Katharsis introduces a way of defining both resources which can be shared over the REST interface and a repository for their handling.

Integration with other libraries

Because of the usage of JSON:API, Katharsis can be used with many other libraries which support the standard.

Quick start

Add dependency to your pom.xml:

<dependency>
	<groupId>io.katharsis</groupId>
	<artifactId>katharsis-core</artifactId>
	<version>0.9.1</version>
</dependency>

Documentation

Documentation, along with example projects and project details are available on project website katharsis.io

Chat

Need to directly talk to us? Write on gitter:

Join the chat at https://gitter.im/katharsis-project/katharsis-core

Development status

Stories in Ready ![Stories in In Progress](https://badge.waffle.io/katharsis-project/katharsis-core.svg?label=in progress&title=In Progress)

Donations

This library is created and maintained by spending weekends and late nights for free without any company behind it. If you love it and simply wanna support us in our project you can do it via Pledgie, by clicking on the badge below.

donation