Skip to content

Latest commit

 

History

History

katharsis-core

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 

Katharsis logo

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 introduces 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>2.4.1</version>
</dependency>

Documentation and examples

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

Contributing

Please submit pull-requests for new features and/or bugs.

The project uses git flow development where master branch builds the latest stable release and develop contains the latest features getting worked on and soon to be released. Please make pull requests on develop branch.

Git flow tools and detailed description are available at git flow .

Chat

Need to directly talk to us? Write on gitter:

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