Відмінності між версіями «Розробка простого RESTfull сервіса засабами Spring Boot»
Рядок 105: | Рядок 105: | ||
* Описуємо модель User. Зазначимо, що використання анотацій та реалізація методів геттерів/сеттерів є обов'язковими. | * Описуємо модель User. Зазначимо, що використання анотацій та реалізація методів геттерів/сеттерів є обов'язковими. | ||
− | |||
<source lang="java"> | <source lang="java"> | ||
Рядок 225: | Рядок 224: | ||
− | * Створюємо контроллер UserController.java який відповідатиме за обробку HTTP-запитів: | + | * Створюємо контроллер UserController.java який відповідатиме за обробку HTTP-запитів. Оскільки в залежностях проекта використовується бібліотека jsonpath то відповідь сервера (об'єкт типу Response) автоматично буде серіалізуватись у JSON формат: |
<source lang="java"> | <source lang="java"> | ||
Рядок 372: | Рядок 371: | ||
mvn spring-boot:run | mvn spring-boot:run | ||
</source> | </source> | ||
+ | |||
+ | |||
+ | * Протестувати сервіс можна за допомогою додатка [https://www.getpostman.com/ Postman], утиліти [https://curl.haxx.se/ curl] або звичайного браузера. Наш сервіс приймає наступні запити: | ||
+ | |||
+ | # створення користувача - <span style="font-family:Courier;">localhost:3000/create?name=<name>&email=<email></span> | ||
+ | # отримання інформації про користувача за id - <span style="font-family:Courier;">localhost:3000/get?id=<id></span> | ||
+ | # отримання інформації про користувача за email - <span style="font-family:Courier;">localhost:3000/get-by-email?email=<email></span> | ||
+ | # отримання інформації про всіх користувачів - <span style="font-family:Courier;">localhost:3000/get-all</span> | ||
+ | # оновлення інформації про користувача за id - <span style="font-family:Courier;">localhost:3000/update?id=<id>&name=<name>&email=<email></span> | ||
+ | # видалення користувача за id - <span style="font-family:Courier;">localhost:3000/delete?id=<id></span> |
Версія за 00:39, 7 листопада 2016
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 або звичайного браузера. Наш сервіс приймає наступні запити:
- створення користувача - localhost:3000/create?name=<name>&email=<email>
- отримання інформації про користувача за id - localhost:3000/get?id=<id>
- отримання інформації про користувача за email - localhost:3000/get-by-email?email=<email>
- отримання інформації про всіх користувачів - localhost:3000/get-all
- оновлення інформації про користувача за id - localhost:3000/update?id=<id>&name=<name>&email=<email>
- видалення користувача за id - localhost:3000/delete?id=<id>