Розробка простого RESTfull сервіса засабами Spring Boot

Spring Boot - це Java фреймворк, що є частиною Java-EE фреймоворку Spring Framework. Фактично, Spring Boot являє собою плагін для систем автоматичного збирання проектів Maven та Gradle. Він надає можливості для комфортної розробки та тестування Spring додатків. Окрім того, Spring Boot дозволяє упаковувати додаток в окремий jar-файл із вбудованим повноцінним контейнером Tomcat. Основною перевагою використання Spring Boot є зведення до мінімуму конфігураційних xml файлів, які зазвичай використовуються при розробці Spring додатку.

Власне сам Spring Framework надає надзвичайно широкі можливості для розробки enterprise java-додатків. Його можна описати як множину менших фреймворків, причому більшість цих дочірніх фреймворків можуть працювати незалежно один від одного, однак вони забезпечують найкращу функціональність саме при спільному використанні. Повноцінний огляд усього Spring Framework виходить далеко за межі цієї статті. Детальніше можна ознайомитись на офіційному сайті Проте, варто вказати найбільший недолік Spring - надмірне використання xml конфігурацій при налаштуванні. Саме тому як компроміс між функціональністю та зручністю був створений Spring Boot.

Ми розглянемо створення простого RESTfull сервіса із реалізацією CRUD операцій та MySQL як сховищем даних. Для реалізації задуманого нам нам потрібні Java 8, система автоматичної збірки Maven та MySQL.

• Створюємо базу даних:

 
CREATE DATABASE `springboot`;
 
USE `springboot`;
 
CREATE TABLE `users` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `name` varchar(100) NOT NULL,
  `email` varchar(100) NOT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

• Файли проекту повинні мати таку структуру:

.
├── pom.xml
└── src
    └── main
        ├── java
        │   └── com
        │       └── example
        │           ├── Application.java
        │           ├── controllers
        │           │   └── UserController.java
        │           └── models
        │               ├── Response.java
        │               ├── UserDao.java
        │               └── User.java
        └── resources
            └── application.properties

• Створюємо файл конфігурації Maven проекту pom.xml із наступним вмістом:

 
<?xml version="1.0" encoding="UTF-8"?>
<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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
 
    <groupId>com.example</groupId>
    <artifactId>spring-boot-REST+mysql</artifactId>
    <version>0.0.1-SNAPSHOT</version>
 
    <name>spring-boot-REST+mysql</name>
 
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>1.3.5.RELEASE</version>
        <relativePath/>
    </parent>
 
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-jpa</artifactId>
        </dependency>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
        </dependency>
        <dependency>
            <groupId>com.jayway.jsonpath</groupId>
            <artifactId>json-path</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>
 
    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <start-class>com.example.Application</start-class>
        <java.version>1.8</java.version>
    </properties>
 
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

• Описуємо модель User. Зазначимо, що використання анотацій та реалізація методів геттерів/сеттерів є обов'язковими.

// src/main/java/com/example/models/User.java
 
package com.example.models;
 
import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;
import javax.persistence.Table;
import javax.validation.constraints.NotNull;
 
@Entity
@Table(name = "users")
public class User {
 
  @Id
  @GeneratedValue(strategy = GenerationType.AUTO)
  private long id;
 
  @NotNull
  private String email;
 
  @NotNull
  private String name;
 
  public User() { }
 
  public User(long id) { 
    this.id = id;
  }
 
  public User(String email, String name) {
    this.email = email;
    this.name = name;
  }
 
  public long getId() {
    return id;
  }
 
  public void setId(long value) {
    this.id = value;
  }
 
  public String getEmail() {
    return email;
  }
 
  public void setEmail(String value) {
    this.email = value;
  }
 
  public String getName() {
    return name;
  }
 
  public void setName(String value) {
    this.name = value;
  } 
}

• Створюємо клас Response, що представлятиме відповідь сервера у JSON форматі:

// src/main/java/com/example/models/Response.java
 
package com.example.models;
 
public class Response {
 
    private String summary;
    private Object result;
 
    public Response(String summary, Object result) {
        this.summary = summary;
        this.result = result;
    }
 
    public String getSummary() {
        return summary;
    }
 
    public void setSummary(String summary) {
        this.summary = summary;
    }
 
    public Object getResult() {
        return result;
    }
 
    public void setResult(Object result) {
        this.result = result;
    }
}

• Описуємо DAO інтерфейс UserDao для роботи із базою даних на рівні абстрактних методів findOne(), findAll(), delete(), update(). Окрім того наслідування від інтерфейсу CrudRepository<> дозволяє нам оголосити власні методи для роботи із базою даних, причому вони не потребують реалізації !

// src/main/java/com/example/models/UserDao.java
 
package com.example.models;
 
import javax.transaction.Transactional;
import org.springframework.data.repository.CrudRepository;
 
@Transactional
public interface UserDao extends CrudRepository<User, Long> {
 
    public User findByEmail(String email);
}

• Створюємо контроллер UserController.java який відповідатиме за обробку HTTP-запитів. Оскільки в залежностях проекта використовується бібліотека jsonpath то відповідь сервера (об'єкт типу Response) автоматично буде серіалізуватись у JSON формат:

// src/main/java/com/example/controllers/UserController.java
 
package com.example.controllers;
 
import com.example.models.Response;
import com.example.models.User;
import com.example.models.UserDao;
 
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;
 
 
@Controller
public class UserController {
 
    @Autowired
    private UserDao userDao;
 
    @RequestMapping("/create")
    @ResponseBody
    public Response create(String email, String name) {
 
        User user = null;
 
        try {
            user = new User(email, name);
            userDao.save(user);
        } catch (Exception e) {
 
            return new Response(e.getMessage(), e);
        }
 
        return new Response("Successfully created new user", user);
    }
 
    @RequestMapping("/get")
    @ResponseBody
    public Response get(long id) {
 
        User user = userDao.findOne(id);
        return new Response( user != null ?  "User successfully received" : "User not found", user);
    }
 
    @RequestMapping("/get-by-email")
    @ResponseBody
    public Response getByEmail(String email) {
 
        User user;
        try {
            user = userDao.findByEmail(email);
        } catch (Exception e) {
            return new Response(e.getMessage(), e);
        }
 
        return new Response( user != null ? "Successfully find user by email" : "User not found", user);
    }
 
    @RequestMapping("/get-all")
    @ResponseBody
    public Response getAll() {
 
        return new Response("Successfully received all users", userDao.findAll());
    }
 
    @RequestMapping("/update")
    @ResponseBody
    public Response updateUser(long id, String email, String name) {
 
        User user = userDao.findOne(id);
 
        if(user != null) {
 
            user.setEmail(email);
            user.setName(name);
            userDao.save(user);
            return new Response("User successfully updated", user);
        }
        else {
            return new Response("User not found", null);
        }
    }
 
    @RequestMapping("/delete")
    @ResponseBody
    public Response delete(long id) {
 
        User user = userDao.findOne(id);
 
        if(user != null) {
 
            userDao.delete(user);
            return new Response("User successfully deleted", user);
        }
        else {
            return new Response("User not found", null);
        }
    }
}

• Описуємо точку входу додатка

// src/main/java/com/example/Application.java
package com.example;
 
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
 
@SpringBootApplication
public class Application {
 
  public static void main(String[] args) {
    SpringApplication.run(Application.class, args);
  }
 
}

• Нарешті описуємо властивості Spring Boot проекту. Як бачимо всі налаштування описуються безпосередньо біля коду, що їх використовує, у application.properties містяться найбільш загальні налаштування:

# src/main/resources/application.properties
 
server.port = 3000
 
# Data source
spring.datasource.url = jdbc:mysql://localhost:3306/springboot
 
# DB username and password
spring.datasource.username = your_db_username
spring.datasource.password = your_db_password

• Запускається проект за допомогою Maven

mvn spring-boot:run

• Протестувати сервіс можна за допомогою додатка Postman, утиліти curl або звичайного браузера. Наш сервіс приймає наступні запити:

1. створення користувача - localhost:3000/create?name=<name>&email=<email>
2. отримання інформації про користувача за id - localhost:3000/get?id=<id>
3. отримання інформації про користувача за email - localhost:3000/get-by-email?email=<email>
4. отримання інформації про всіх користувачів - localhost:3000/get-all
5. оновлення інформації про користувача за id - localhost:3000/update?id=<id>&name=<name>&email=<email>
6. видалення користувача за id - localhost:3000/delete?id=<id>

Готовий проект доступний на GitHub

На початок курсу