What is REST API

In this blog post, I will be explaining what a REST API is.

What is REST

REST stands for Representational State Transfer. It is a design pattern for web services. Web services that follow this design pattern are known as RESTful web services. There are 2 main components in a REST API.

Client

The person or application that uses the services is the client. The client can be a web application, mobile application or even an individual developer.

Server

The server provides some functionality. The client application makes an HTTP call to the server. Any HTTP method (i.e. GET, POST, PUT, DELETE) can be used. The server then acts on the request by the client. So if the client sends an HTTP GET request, the server returns the requested information. If the client sends an HTTP POST request, the server performs the necessary operation with the data sent by the client.

How REST works

The server exposes functionality as REST endpoints which are simply URLs. The client application needs to access the URL for the functionality that it wishes to invoke and specify the HTTP method.

For example, suppose we have a stock price application that returns the current price of a particular stock. Suppose, this application is implemented as a REST service. The server might expose a URL like stockapp/getQuote. The client needs to access this URL and specify the HTTP GET request. When the server receives the URL request, it returns the price of the stock specified.

What is special about a RESTful service

The main thing that makes a RESTFul service different is it just returns the data. The data can be in  XML or JSON format. It is up to the client to use the data in whatever way they wish. So if it’s a web application, it may simply put the data returned by the REST service in an HTML format and display it to a user. However, if a standalone application or as middle-tier application, it may simply use the data returned by the REST service for some other computations.

A RESTFul service is also independent of technology. So a REST service can be implemented in Java/Node.js/PHP or some other technology.  So also, the REST client can be implemented in any technology. It can be a web application implemented via JSP/Servlets or Angular JS or it can be a mobile application implemented via Andriod or iOS.

REST Architecture

The following diagram explains the REST architecture:

How to implement a RESTful service in Java

There are a couple of ways that you can implement s RESTFul service in Java

Using JAX-RS and Jersey

Java provides the Java API for RESTful Web Services (JAX-RS). This is part of the JDK since Java 6 and so does not need to be included separately. Jersey is the reference implementation of JAX-RS specification. There are other implementations like RESTEasy as well.

So if you want to create a RESTful service, you need to create a web application in Java. Depending on the Server that you are using, you may or may not need to include a JAX-RS implementation. Some servers like GlassFish are shipped with Jersey so it does not need to be included explicitly. JBoss is shipped with RESTEasy so again if you are using JBoss, you do not need to include any JAX-RS implementation. If you are using Tomcat, it does not come with any implementation, so you need to include the JAR file for Jersey or whichever JAX-RS implementation that you plan to use.

You then need to write the code for your RESTful service endpoint. Finally, you need to deploy your application as in your server. The client can then access the URL of the RESTful service.

Refer to this post to see an example of how to create a REST service using JAX-RS and Jersey

Spring

Spring Framework also provides REST capabilities. It is not a JAX-RS implementation, but it is a Spring alternative to JAX-RS. The annotations provided by JAX-RS and Spring are also slightly different. Again, you need to create a Web application using Spring and write the code for your REST service.

Refer to this post to see an example of how to create a SpringBoot REST service and test it via Postman.

Refer to this post to see an example of how to create a Spring REST service and test it via Postman.

 

 

 

 

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