Відмінності між версіями «Розробка простого RESTfull сервіса засабами Spring Boot»
м |
|||
(не показані 7 проміжних версій ще одного учасника) | |||
Рядок 5: | Рядок 5: | ||
Ми розглянемо створення простого [https://en.wikipedia.org/wiki/Representational_state_transfer RESTfull сервіса] із реалізацією [https://en.wikipedia.org/wiki/Create,_read,_update_and_delete CRUD] операцій та MySQL як сховищем даних. Для реалізації задуманого нам нам потрібні Java 8, система автоматичної збірки Maven та MySQL. | Ми розглянемо створення простого [https://en.wikipedia.org/wiki/Representational_state_transfer RESTfull сервіса] із реалізацією [https://en.wikipedia.org/wiki/Create,_read,_update_and_delete CRUD] операцій та MySQL як сховищем даних. Для реалізації задуманого нам нам потрібні Java 8, система автоматичної збірки Maven та MySQL. | ||
+ | |||
* Створюємо базу даних: | * Створюємо базу даних: | ||
− | <source lang=" | + | |
+ | <source lang="mysql"> | ||
CREATE DATABASE `springboot`; | CREATE DATABASE `springboot`; | ||
+ | |||
USE `springboot`; | USE `springboot`; | ||
+ | |||
CREATE TABLE `users` ( | CREATE TABLE `users` ( | ||
`id` int(11) NOT NULL AUTO_INCREMENT, | `id` int(11) NOT NULL AUTO_INCREMENT, | ||
Рядок 18: | Рядок 22: | ||
</source> | </source> | ||
− | * | + | |
+ | * Файли проекту повинні мати таку структуру: | ||
+ | |||
<source lang="bash"> | <source lang="bash"> | ||
− | + | . | |
├── pom.xml | ├── pom.xml | ||
└── src | └── src | ||
Рядок 29: | Рядок 35: | ||
│ ├── Application.java | │ ├── Application.java | ||
│ ├── controllers | │ ├── controllers | ||
− | |||
│ │ └── UserController.java | │ │ └── UserController.java | ||
│ └── models | │ └── models | ||
Рядок 39: | Рядок 44: | ||
</source> | </source> | ||
− | * Створюємо файл конфігурації Maven проекту | + | |
+ | * Створюємо файл конфігурації Maven проекту pom.xml із наступним вмістом: | ||
+ | |||
<source lang="xml"> | <source lang="xml"> | ||
<?xml version="1.0" encoding="UTF-8"?> | <?xml version="1.0" encoding="UTF-8"?> | ||
Рядок 95: | Рядок 102: | ||
</project> | </project> | ||
</source> | </source> | ||
+ | |||
+ | |||
+ | * Описуємо модель User. Зазначимо, що використання анотацій та реалізація методів геттерів/сеттерів є обов'язковими. | ||
+ | |||
+ | <source lang="java"> | ||
+ | // 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; | ||
+ | } | ||
+ | } | ||
+ | </source> | ||
+ | |||
+ | |||
+ | * Створюємо клас Response, що представлятиме відповідь сервера у JSON форматі: | ||
+ | |||
+ | <source lang="java"> | ||
+ | // 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; | ||
+ | } | ||
+ | } | ||
+ | </source> | ||
+ | |||
+ | |||
+ | * Описуємо [https://en.wikipedia.org/wiki/Data_access_object DAO] інтерфейс UserDao для роботи із базою даних на рівні абстрактних методів findOne(), findAll(), delete(), update(). Окрім того наслідування від інтерфейсу CrudRepository<> дозволяє нам оголосити власні методи для роботи із базою даних, причому вони не потребують реалізації ! | ||
+ | |||
+ | <source lang="java"> | ||
+ | // 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); | ||
+ | } | ||
+ | </source> | ||
+ | |||
+ | |||
+ | * Створюємо контроллер UserController.java який відповідатиме за обробку HTTP-запитів. Оскільки в залежностях проекта використовується бібліотека jsonpath то відповідь сервера (об'єкт типу Response) автоматично буде серіалізуватись у JSON формат: | ||
+ | |||
+ | <source lang="java"> | ||
+ | // 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); | ||
+ | } | ||
+ | } | ||
+ | } | ||
+ | </source> | ||
+ | |||
+ | |||
+ | * Описуємо точку входу додатка | ||
+ | |||
+ | <source lang="java"> | ||
+ | // 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); | ||
+ | } | ||
+ | |||
+ | } | ||
+ | </source> | ||
+ | |||
+ | |||
+ | * Нарешті описуємо властивості Spring Boot проекту. Як бачимо всі налаштування описуються безпосередньо біля коду, що їх використовує, у application.properties містяться найбільш загальні налаштування: | ||
+ | |||
+ | <source lang="python"> | ||
+ | # 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 | ||
+ | |||
+ | </source> | ||
+ | |||
+ | |||
+ | * Запускається проект за допомогою Maven | ||
+ | <source lang="bash"> | ||
+ | mvn spring-boot:run | ||
+ | </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> | ||
+ | |||
+ | |||
+ | Готовий проект доступний на [https://github.com/VTurturika/spring-boot-restfull-service GitHub] | ||
+ | |||
+ | [[ПКДзJ|На початок курсу]] |
Поточна версія на 10:07, 11 січня 2017
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>
Готовий проект доступний на GitHub