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

Ajax Cross Domain Resource Access Using jQuery

Some time back in our project we faced a problem while making an Ajax call using jQuery. Chrome Browser console had given some weird error message like below when we try to access one of our web pages: When we try to access the same web page in the Firefox browser, it doesn't give any error in the console but some parsing error occurred. In our case, we were accessing XML as an Ajax request resource. I was curious to check if the non-XML cross-domain resource was successfully loading or not. But finally, I realized that it is not going through. jersey-spring-boot-quick-starter-guide In our Ajax call, requesting domain was not the same as the requested URL domain. $.ajax({ url: "https://10.11.2.171:81/xxxxxx/xxxxxxx.xml" , type : "get" , success: function (response) { alert( "Load was performed." ); }, error : function (xhr, status) {

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