Skip to main content

Working with request header in Jersey (JAX-RS) guide

In the previous post, we talked about, how to get parameters and their values from the request query string. In this guide learn how to get request header values in Jersey (JAX-RS) based application.

We had tested or used the following tools and technologies in this project:

  1. Jersey (v 2.21)
  2. Gradle Build System (v 2.9)
  3. Spring Boot (v 1.3)
  4. Java (v 1.8)
  5. Eclipse IDE

This is a part of Jersey (JAX-RS) Restful Web Services Development Guides series. Please read Jersey + Spring Boot getting started guide.

Gradle Build File

We are using Gradle for our build and dependency management (Using Maven rather than Gradle is a very trivial task).

File: build.gradle

buildscript {
    ext {
        springBootVersion = '1.3.0.RELEASE'
    }
    repositories {
        mavenCentral()
    }
    dependencies {
        classpath("org.springframework.boot:spring-boot-gradle-plugin:${springBootVersion}") 
    }
}

apply plugin: 'java'
apply plugin: 'eclipse'
apply plugin: 'idea'
apply plugin: 'spring-boot' 

jar {
    baseName = 'jersey-request-header'
    version = '0.0.1-SNAPSHOT'
}
sourceCompatibility = 1.8
targetCompatibility = 1.8

repositories {
    mavenCentral()
}

dependencies {
    compile('org.springframework.boot:spring-boot-starter-jersey')
    testCompile('org.springframework.boot:spring-boot-starter-test') 
}

eclipse {
    classpath {
         containers.remove('org.eclipse.jdt.launching.JRE\_CONTAINER')
         containers 'org.eclipse.jdt.launching.JRE\_CONTAINER/org.eclipse.jdt.internal.debug.ui.launcher.StandardVMType/JavaSE-1.8'
    }
}

task wrapper(type: Wrapper) {
    gradleVersion = '2.7'
}

Spring Boot Main Method Class

Spring Boot Main Method Class is the starting point for the Spring Boot-based application just like a normal java application.

File: JerseyRequestParameterApplication.java

package in.geekmj;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class JerseyRequestHeaderApplication {

    public static void main(String\[\] args) {
        SpringApplication.run(JerseyRequestHeaderApplication.class, args);
    }
}

Jersey Configuration Class

Jersey Configuration class is a ResourceConfig class for providing Jersey-specific configuration and Resources entry.

File: JerseyConfig.java

package in.geekmj.config;

import javax.ws.rs.ApplicationPath;

import org.glassfish.jersey.server.ResourceConfig;
import org.springframework.stereotype.Component;

import in.geekmj.resource.RequestHeaderResource;

@Component
@ApplicationPath("/")
public class JerseyConfig extends ResourceConfig {

	/*
	 * In constructor we can define Jersey Resources & Other Components
	 */
	public JerseyConfig() {
		register(RequestHeaderResource.class);
	}
}

Reading specific request header using @HeaderParam

File: RequestParameterResource.java

package in.geekmj.resource;

import java.util.HashMap;
import java.util.Map;

import javax.ws.rs.GET;
import javax.ws.rs.HeaderParam;
import javax.ws.rs.Path;
import javax.ws.rs.Produces;
import javax.ws.rs.core.Context;
import javax.ws.rs.core.HttpHeaders;
import javax.ws.rs.core.MediaType;

@Path("/request-header")
@Produces(MediaType.APPLICATION\_JSON)
public class RequestHeaderResource {

	/*
	 * We can inject request header as an instance variables using @HeaderParam
	 */

	@HeaderParam("token")
	private String token;

	/* We can inject request header values in method using @HeaderParam */
	@GET
	public Map<String, String> getRequestHeaders(@HeaderParam("content-type") String contentType) {

		Map<String, String> requestHeaders = new HashMap<String, String>();
		requestHeaders.put("token", token);
		requestHeaders.put("contentType", contentType);
		return requestHeaders;
	}

}

We have used @HeaderParam for injecting specific request headers as instance variables and method parameters.

API URI /request-header can read two headers:

  1. token
  2. content-type

In response to this API URI, we show values for these header parameters in JSON structure.

Start Spring Boot Application and test the API using Postman. In Postman we can pass headers. (Refer Spring Boot quick starter guide to understand how to start Spring Boot Application)

Test https://localhost:8080/request-header as shown below in Postman.

!Getting Jersey Request Header Values Getting Jersey Request Header Values

Get all request headers in Map

File: RequestParameterResource.java

package in.geekmj.resource;

import java.util.HashMap;
import java.util.Map;

import javax.ws.rs.GET;
import javax.ws.rs.HeaderParam;
import javax.ws.rs.Path;
import javax.ws.rs.Produces;
import javax.ws.rs.core.Context;
import javax.ws.rs.core.HttpHeaders;
import javax.ws.rs.core.MediaType;

@Path("/request-header")
@Produces(MediaType.APPLICATION\_JSON)
public class RequestHeaderResource {
	/*
	 * We can get a map of all request headers name and value using HttpHeaders
	 * context injection
	 */

	@SuppressWarnings("rawtypes")
	@GET
	@Path("/all")
	public Map getAllRequestHeadersUsingContext(@Context HttpHeaders headers) {
		return headers.getRequestHeaders();
	}
}

We had used @Context to inject HttpHeaders. HttpHeaders has a method getRequestHeaders which returns a map with Key as header name and value as a header value.

Test https://localhost:8080/request-header/all as shown below in Postman.

Jersey gets HTTP request all headers values

References

  1. What is the HTTP request header? (Wikipedia Article)

  2. Official Jersey Documentation

  3. Download the Full Project

  4. Follow Project On Github

Comments

Popular posts from this blog

FastAPI first shot

Setup on my Mac (Macbook Pro 15 inch Retina, Mid 2014) Prerequisite Python 3.6+ (I used 3.7.x. I recently reinstalled OS after cleaning up disk, where stock Python 2.7 was available. I installed Pyenv and then used it to install 3.7.x). I already had a git repo initialized at Github for this project. I checked that out. I use this approach to keep all the source code safe or at a specific place 😀. I set the Python version in .python-version file. I also initialize the virtual environment using pyenv in venv folder. I started the virtual environment. FastAPI specific dependencies setup Now I started with basic pip commands to install dependency for the project. I saved dependencies in requirements.txt  the file. Minimal viable code to spin an API Server FastAPI is as cool as NodeJS or Go Lang (?) to demonstrate the ability to spin an API endpoint up and running in no time. I had the same feeling for the Flask too, which was also super cool. app/main.py: from typing i

Jersey (JAX-RS) @FormParam HTML form data handling

There are multiple ways for consuming HTML form data (application/x-www-form-urlencoded) in Jersey. Using @FormParam annotation we can inject Form values in the Resource method. We can use it just like other @*Param. Jersey resource method needs to know they have to handle HTML form data, for it we explicitly specify  @Consumes("application/x-www-form-urlencoded") . There are multiple ways in which we can handle HTML form data using Jersey. Injecting Form data using @FormParam is one of them. Use @FormParam Using @FormParam we can inject specific HTML form parameters values in the Resource method. Its use is similar to other @*Param annotations. File: FormParamResource.java package in.geekmj.resource; import javax.ws.rs.Consumes; import javax.ws.rs.FormParam; import javax.ws.rs.POST; import javax.ws.rs.Path; import javax.ws.rs.Produces; import javax.ws.rs.core.Context; import javax.ws.rs.core.MediaType; import javax.ws.rs.core.MultivaluedMap; import javax.ws.rs.core.R