Jersey (JAX-RS) JSON HTTP entity payload processing example

JSON (JavaScript Object Notation) is most used structured data interchange format of current generation. It is very common for REST client to use it for data exchange. Several web client framework (e.g. AngularJS) natively handle JSON requests and responses. Jersey (JAX-RS) JSON support is very effective and easy to use.

Usually client send and receive JSON data as HTTP entity payload with Content-Type header set with value application/json.

JSON HTTP entity payload handling jersey example

JSON HTTP entity payload handling jersey example

In this tutorial we will learn:

  1. Consuming / Reading JSON entity payload to Java Object.
  2. Producing / Writing JSON entity payload from Java Object.
  3. Different JSON processing framework support in Jersey.

This is a part of Jersey (JAX-RS) Restful Web Services Development Guides series. Please read Jersey + Spring Boot getting started guide. Spring Boot, Jersey, Java 8 and Gradle are few technologies used in this project.

Getting started

Jersey inbuilt support three ways to handle JSON data.

  1. POJO based JSON binding – Most widely used approach.
  2. JAXB based JSON binding – It provide XML read and write capability straightaway.
  3. Low level JSON read and write

Jersey support JSON entity provider for these JSON libraries out of the box:

  1. MOXy – Jersey preferred and auto-configure it (if MOXy is on class-path).
  2. Java API for JSON Processing
  3. Jackson – Spring Boot auto configuration register Jackson as JSON entity provider for Jersey. Hence Jackson used in Spring Boot Jersey application by default.
  4. Jettison

🚫 Note: Jettison is not actively developed. We should avoid it.

In this tutorial we will work on Movie entity and use POJO based JSON binding. An example JSON:

{
  "id": 1,
  "title": "The Shawshank Redemption",
  "releaseYear": 1994,
  "imdbRating": 9.3,
  "actors": [
    {
      "id": 200,
      "name": "Tim Robbins"
    },
    {
      "id": 201,
      "name": "Morgan Freeman"
    }
  ]
}

We will create two Java classes to represent Actor and Movie entities.

File: org/geekmj/domain/Actor.java

package org.geekmj.domain;

public class Actor {
	private Long id;
	private String name;

	public Long getId() {
		return id;
	}

	public void setId(Long id) {
		this.id = id;
	}

	public String getName() {
		return name;
	}

	public void setName(String name) {
		this.name = name;
	}

}

File: org/geekmj/domain/Movie.java

package org.geekmj.domain;

import java.util.List;

public class Movie {
	private Long id;
	private String title;
	private Integer releaseYear;
	private Float imdbRating;
	private List<Actor> actors;

	public Long getId() {
		return id;
	}

	public void setId(Long id) {
		this.id = id;
	}

	public String getTitle() {
		return title;
	}

	public void setTitle(String title) {
		this.title = title;
	}

	public Integer getReleaseYear() {
		return releaseYear;
	}

	public void setReleaseYear(Integer releaseYear) {
		this.releaseYear = releaseYear;
	}

	public Float getImdbRating() {
		return imdbRating;
	}

	public void setImdbRating(Float imdbRating) {
		this.imdbRating = imdbRating;
	}

	public List<Actor> getActors() {
		return actors;
	}

	public void setActors(List<Actor> actors) {
		this.actors = actors;
	}
}

Jersey (JAX-RS) JSON payload read and write resource

File: org/geekmj/resource/JsonPayloadResource.java

package org.geekmj.resource;

import javax.ws.rs.Consumes;
import javax.ws.rs.POST;
import javax.ws.rs.Path;
import javax.ws.rs.Produces;
import javax.ws.rs.core.MediaType;

import org.geekmj.domain.Movie;

@Path("/json-payload")
public class JsonPayloadResource {

	/**
	 * This Resource method takes HTTP entity pay-load in JSON format. 
	 * This Resource method gives back HTTP entity pay-load in JSON format. 
	 * Jackson is the default JSON Entity provider for Spring Boot + Jersey application.
	 * It convert JSON in the pay-load to Java Object. 
	 * It also convert Java Object to JSON.
	 */

	@POST
	@Path("/movie")
	@Produces(MediaType.APPLICATION_JSON)
	@Consumes(MediaType.APPLICATION_JSON)
	public Movie takeAndGiveMovie(final Movie movie) {

		System.out.println("Movie Title " + movie.getTitle());
		
		/* Appending (Checked) to title, It will show in response */
		movie.setTitle(movie.getTitle().concat("(Checked)"));
		
		return movie;

	}
}

In above source code, Jersey Resource method takeAndGiveMovie is mapped to POST URI /json-payload/movie.

Jackson is the default JSON Entity provider for Spring Boot + Jersey application. It convert JSON HTTP entity payload into Java Object, which is Movie class object in our example. It also convert Movie Object into JSON which returned as HTTP response payload.

Note: We have appended String (checked) in movie title and it will show in response.

Test this API using Postman

URI : http://localhost:8080/json-payload/movie

Request Header : Content-Type = application/json

JSON Payload Request Data in Postman

JSON Payload Request Data in Postman

JSON Payload Response Data Postman

JSON Payload Response Data Postman

References

  1. Learn about JSON.
  2. Learn about HTTP payload versus form data.
  3. Learn about HTTP entity.
  4. Learn about Java API for JSON Processing.
  5. Learn about reference implementation of Java API for JSON Processing.
  6. Learn about MOXy.
  7. Learn about Jackson.
  8. Learn about Jettison.

Leave a Reply

Your email address will not be published. Required fields are marked *