Important JAX-RS annotations explained

In this article, I will be explaining some important annotations in JAX-RS

What is JAX-RS

JAX-RS is a Java API that you can use for building a REST service. JAX-RS stands for Java API for RESTful Web Services (JAX-RS). It is part of the Java EE since Java 6. The latest version of JAX-RS is JAX-RS 2.0 and is part of Java EE 7. JAX-RS is just an API; it has some annotations that you can use to build a REST application.  JAX-RS does not include an implementation. Jersey framework is the reference implementation of JAX-RS specification and implements JAX-RS 2.0. There are other implementations of JAX-RS like RESTEasy, etc.

Important JAX-RS annotations

@Get/@Post/@Put/@Delete/@Head

You need to specify these annotations on a JAX-RS method. These annotations indicate the HTTP method that the JAX-RS method maps to. So when a client request comes in, JAX-RS matches the HTTP method in the client request to the method that has the appropriate annotation. If there is no annotation on a method, JAX-RS assumes that it can cater to all HTTP methods.

@Path

You can use the @Path annotation on any class or method in your code. It identifies the URI to which the class or method maps to. So you need to specify a URI with this annotation. If you specify the annotation at the class level, JAX-RS maps all the methods in the class to the same URI. If you specify the annotation at the method level, the method level annotation overrides the class-level annotation. You need to specify a relative URI with the Path annotation.  You can also specify an expression with the Path annotation which will be matched to the incoming URL.

@Produces and @Consumes

You can specify the @Produces annotation on a JAX-RS service class or method. It defines the media type that a JAX-RS class or method is capable of producing. Similarly, you can use the @Consumes annotation to define the MIME type of the data that a JAX-RS service can accept. So it is basically used to narrow down the method that matches a client request. So when a client request comes in, JAX-RS compares the headers in the request to the metadata in these annotations. JAX-RS invokes the corresponding method only if there is a match. If you specify the annotations at the class level, the MIME type in the annotation is applicable to all the methods in the class. If you specify the annotations at the method level, the method level annotations override the class level annotations. Some of the MIME types that which you can specify with these annotations are text/plain, application/xml, application/json, etc.

 

Variable Extraction Annotations

There are several annotations supported by JAX-RS which you can use to inject values into a JAX-RS method. These are as explained below:

@PathParam

The @PathParam annotation can be used to specify parameters that are specified as part of the URI. So when @PathParam is used, the client application needs to send the parameters as part of the URI. Example is /url/param1/param2.

@QueryParam

This annotation can be used to specify query parameters. So when this annotation is used, the client application needs to send parameters as query parameters in the URL. A Query parameter is of the form name=value and must be specified after a “?” symbol at the end of the URL.  Example is url?param1=value1&&param2=value2.

@HeaderParam

Sometimes, your application may need to find out header information in the incoming request. In such cases, the @HeaderParam annotation is useful. For example, the Accept-Language header specifies the language in which content is acceptable to a client application. Suppose, your REST service needs to find the value of this header in order to send appropriate data to the client.

@FormParam

This annotation is used to accept values which are specified in forms.

@CookieParam

The @javax.ws.rs.CookieParam annotation allows you to inject cookies sent by a client request into your JAX-RS resource methods.

 

 

 

Comments

Post a Comment

Popular posts from this blog

How to use logging in SpringBoot with code samples

Image
In this article, we will learn how to use logging in SpringBoot. Introduction There are several Java logging frameworks like logback, log4j, and so on. Spring Boot supports out-of-the-box support for logback. Let us learn how to use logging in SpringBoot with logback. Step 1 – Create a New Maven Project Create a new Maven project. (Refer to  this  blog post). This will create a project in Eclipse as follows:   Step 2 – Add the Spring Boot Dependencies Add the spring-boot-starter-web dependency to the pom.xml . So, the pom.xml should look as follows: <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.learnjava</groupId> <artifactId>learnjava-springboot-logging-example</artifactId> <version>0.0.1-SNAPSHOT&
Read more

Python While Loop with code samples

Much like a Java while loop, you can use a Python while loop to repeatedly execute a block of code as long as a condition is true. In this article, we will learn more about the Python while loop. Python While loop Syntax A while loop in Python has the following syntax: while <condition>: loop body The while keyword is followed by a condition. If the condition evaluates to true, the body of the loop is executed. Once the body of the loop is completed, the condition is checked again and this is repeated until the condition evaluates to false at which point the loop is exited. While loop Sample Code The following code demonstrates how you can use the while loop: num=10counter=1total=0while counter<=num: total += counter counter+=1print("sum of first 10 numbers is",total) This code adds the numbers from 1 to 10 and prints the sum. It uses a while loop to iterate from 1 to 10. The while loop checks the condition counter <= num and if so adds the current value of count
Read more

How to convert a List to a Set

In this blog post ,I will be showing you how you can convert a List to a Set. Consider the following code snippet: public class ListToSetDemo {public static void main(String[] args) {List<Integer> list = Arrays.asList(5,3,11,15,9);//Method 1Set<Integer> set = new HashSet<Integer>(list);System.out.println("Set is "+set);//method 2Set<Integer> set2 = new HashSet<Integer>();set2.addAll(list);System.out.println("Set is "+set2);}} This code demonstrates two ways to convert a List to a Set. Method 1 Here, we are creating a new HashSet . We are invoking the constructor that accepts a Collection object. Here, we are passing in the input list to this constructor.   Method 2 Here again, we are creating a new HashSet . However, we are using the default constructor. We are then invoking the addAll method and passing in the input list.   When you run this code, it will print the following output: Set is [3, 5, 9, 11, 15]Set is [3, 5, 9, 11, 15] No
Read more