How to create Spring Boot REST Service and Test it via Postman

In this blog post, I will be explaining how you can create a Spring Boot REST service.  If you would like to see how to create a basic HelloWorld Spring Boot application refer to this blog post.

Edit

Project Creation and Setup

Step 1 – Create a new Maven Project (Refer to this blog post)

 

Step 2 – Add the following Spring Boot dependencies to the POM file and save.

	<parent>  <groupId>org.springframework.boot</groupId>  <artifactId>spring-boot-starter-parent</artifactId>  <version>2.1.2.RELEASE</version></parent><dependencies><dependency>  <groupId>org.springframework.boot</groupId>  <artifactId>spring-boot-starter-web</artifactId></dependency></dependencies>

Edit

Writing Code

Step 3 – Create Person class as follows

package com.learnjava.model;public class Person {    private int id;  private String name;  private int age;    public int getId() {    return id;  }  public void setId(int id) {    this.id = id;  }    public Person(){      }    public Person(int id,String name, int age) {    super();    this.id=id;    this.name = name;    this.age = age;  }//getter and setter methods}

Person class

This is the model class. It represents a Person. It has 3 fields, id, name and age.

Step 4 – Create a PersonController class as follows:

package com.learnjava.controller;import java.util.ArrayList;import java.util.List;import org.springframework.beans.factory.annotation.Autowired;import org.springframework.http.ResponseEntity;import org.springframework.web.bind.annotation.GetMapping;import org.springframework.web.bind.annotation.PathVariable;import org.springframework.web.bind.annotation.PostMapping;import org.springframework.web.bind.annotation.RequestBody;import org.springframework.web.bind.annotation.RequestMapping;import org.springframework.web.bind.annotation.RestController;import com.learnjava.model.Person;@RestControllerpublic class PersonController {    @GetMapping("/person")  public List<Person> getAllPersons(){    //Returns hardcoded data, a real world application would return from the database    List<Person> personList = new ArrayList<Person>();    personList.add(new Person(1,"Mickey Mouse", 30));    personList.add(new Person(2,"Donald Duck", 35));    personList.add(new Person(3,"Peppa Pig", 15));    return personList;  }     @GetMapping("/person/{personId}")  public Person getPersonWithId(@PathVariable Integer personId){    //Returns hardcoded data, a real world application would return from the database    return new Person(3,"Peppa Pig", 15);  }       @PostMapping("/person/newperson")  public void addPerson(@RequestBody Person person){    //Just has a Sysout stmt, a real world application would save this record to the database    System.out.println("Saving person information");      }}

PersonController class

This is a Controller class. It specifies the method which will handle the requests from the client. It has the following methods.

Methods

getAllPersons

This returns all Person objects. A real-world application would query a database and return the Person objects. This code simply returns a List of Person objects.

getPersonWithId
This returns a Person object corresponding to the id specified. A real-world application would query a database and return a Person objects corresponding to the id specified. This code simply returns a hard-coded Person object

addPerson

This saves the Person object passed in. A real-world application would save the Person object into the database. This code simply executes a Sysout statement.

Annotations

@RestController annotation

This is specified at the class level. This designates the class as a REST controller, i.e. a controller that handles REST requests. It internally includes the @ResponseBody annotation which converts the Java value returned by the method into JSON. This annotation was added since Spring 4.0. It is a convenience annotation that combines the @Controller and @ResponseBody annotations.

@GetMapping Annotation

This annotation specifies the URL that this method maps to and also specifies that it is an HTTP GET Request. It is a composite annotation that acts as a shortcut for @RequestMapping(method = RequestMethod.GET). This is specified for the getAllPersons and getPersonWithId methods.

@PostMapping Annotation

This annotation specifies the URL that this method maps to and also specifies that it is an HTTP POST Request. It is a  composite annotation that acts as a shortcut for @RequestMapping(method = RequestMethod.POST). This is specified on the addPerson method

@RequestBody Annotation

This annotation needs to be specified when an object is passed to a method. It automatically deserializes the JSON object to a Java object.

Step 5 – Finally, create a Main.java as follows:

package com.learnjava;import org.springframework.boot.SpringApplication;import org.springframework.boot.autoconfigure.EnableAutoConfiguration;import org.springframework.boot.autoconfigure.SpringBootApplication;import org.springframework.web.bind.annotation.RequestMapping;import org.springframework.web.bind.annotation.RestController;@SpringBootApplicationpublic class Main {    public static void main(String[] args) {          SpringApplication.run(Main.class, args);      }}

Main

This is the starting point of the application.

Running the Application

Step 6 – Run Main.java as a Java application as follows:

This will display the following on the console:

Testing Via Browser

Get All Persons

Open a browser window and type the following URL:

http://localhost:8080/person/

This will display the following:

Get Person By Id

Open a browser window and type the following URL:

http://localhost:8080/person/3

This will display the following:

Add Person

This cannot be tested in a Browser as it is a POST request

Testing Via Postman

Postman is a client-side application that allows you to test REST services easily. You can download Postman from the Postman like here. Once download is complete, you can click the desktop shortcut to launch Postman.

Get All Persons

  1. Select Request Type as “GET”
  2. Enter URL as “http://localhost:8080/person/”
  3. Click on “Send”.
  4. This will show the “JSON” response sent by the server in the body below as follows:

Get Person By Id

  1. Select Request Type as “GET”
  2. Enter URL as “http://localhost:8080/person/3”,
  3. Click on “Send”.
  4. This will show the “JSON” response sent by the server in the body below as follows:

Add Person

  1. Select Request Type as “POST”
  2. Enter URL as “http://localhost:8080/person/newPerson”.
  3. Click Body
  4. Select “Raw”
  5. Type as “JSON(Application/JSON”),
  6. Enter the data to be saved in JSON format as shown below.
  7. Click on “Send”.
  8. This will show the HTTP Status 200 sent by the server.

You can download the source code for this project via the Github repository here.

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