詳解spring boot rest例子
簡介：本文將幫助您使用 Spring Boot 創(chuàng)建簡單的 REST 服務。
你將學習
- 什么是 REST 服務？
- 如何使用 Spring Initializr 引導創(chuàng)建 Rest 服務應用程序？
- 如何創(chuàng)建獲取 REST 服務以檢索學生注冊的課程？
- 如何為學生注冊課程創(chuàng)建 Post REST 服務？
- 如何利用 postman 執(zhí)行 rest 服務？
本教程使用的 rest 服務
在本教程中，我們將使用適當?shù)?URI 和 HTTP 方法創(chuàng)建三個服務：
@GetMapping（“/ students / {studentId} / courses”）：您可以使用請求方法 Get 和示例 uri / students / Student1 / courses 來查詢特定學生已注冊的課程。
@GetMapping(“/students/{studentId}/courses/{courseId}”)：您可以使用請求方法 Get 和示例 uri / students / Student1 / courses / Course1 獲取特定學生的特定課程。
@PostMapping(“/students/{studentId}/courses”) ：您可以通過向 UURI /students/Student1/courses 發(fā)送 POST 請求來為學生注冊一門課程
您將需要的工具
- Maven 3.0+ 是您的構建工具
- 你最喜歡的 IDE。我們使用 Eclipse。
- JDK 1.8+
完整的 spring booot rest Maven 項目代碼示例子
我們的 Github 存儲庫包含所有代碼示例 - https://github.com/in28minutes/in28minutes.github.io/tree/master/code-zip-files
帶有單元和集成測試的 REST 服務
Website-springbootrestservices-simplerestserviceswithunitandintegrationtests.zip
什么是 REST？
REST 代表 REpresentational State Transfer。REST 指定了一組體系結構約束。任何滿足以下這些條件的服務都稱為 RESTful 服務。
RESTful Web Service 的五個重要條件：
- 客戶端 - 服務器：應該有一個服務生產者和一個服務使用者。
- 接口（URL）是統(tǒng)一的并且暴露資源。
- 該服務是無狀態(tài)的。
- 服務結果應該是可緩存的。例如 HTTP 緩存。
- 服務應該采用分層架構。客戶端不應該直接連接到服務器 - 它可能從中間層獲取信息 - 緩存。
理查森成熟度模型
Richardson 成熟度模型用于識別 Restful Web Service 的成熟度級別。以下是不同級別和特點：
級別 0：以 REST 風格公開 SOAP Web 服務。公開的操作使用 REST 服務（http：// server / getPosts，http：// server / deletePosts，http：// server / doThis，http：// server / doThat 等）。
級別 1：使用正確的 URI（使用名詞）公開資源。例如：http：// server / accounts，http：// server / accounts / 10。但是，HTTP 方法并未使用。
級別 2：資源使用正確的 URI + HTTP 方法。例如，要更新一個賬戶，你需要做一個 PUT。創(chuàng)建一個帳戶，你做一個 POST。Uri 看起來像 posts/1/comments/5 和 accounts/1/friends/1.
等級 3：HATEOAS (Hypermedia as the engine of application state)。您不僅可以了解所請求的信息，還可以了解服務消費者可以采取的下一個可能的操作。當請求有關 Facebook 用戶的信息時，REST 服務可以返回用戶詳細信息以及有關如何獲取他最近的帖子，如何獲取他最近的評論以及如何檢索他朋友的列表的信息。
使用適當?shù)恼埱蠓椒?/strong>
始終使用 HTTP 方法。有關每種 HTTP 方法的最佳做法如下所述：
GET：不應該更新任何東西。應該是冪等的（多次調用相同的結果）?？赡艿姆祷卮a 200（OK）+ 404（NOT FOUND）+400（BAD REQUEST）
POST：應該創(chuàng)建新的資源。理想情況下返回 JSON 和鏈接到新創(chuàng)建的資源。盡可能使用相同的返回碼。另外：返回碼 201（創(chuàng)建）是可能的。
PUT：更新已知資源。例如：更新客戶詳細信息?？赡艿姆祷卮a：200（OK）
DELETE：用于刪除資源。
項目結構
以下屏幕截圖顯示了我們將創(chuàng)建的項目的結構。
一些細節(jié)：
- StudentController.java - rest 控制器提供上面討論的所有三種服務方法。
- Course.java, Student.java, StudentService.java - 應用程序的業(yè)務邏輯。StudentService 提供了一些我們從 Rest 控制器中消耗的方法。
- StudentControllerIT.java - rest 服務的集成測試。
- StudentControllerTest.java - test 服務的單元測試。
- StudentServicesApplication.java - Spring Boot 應用程序的啟動器。要運行該應用程序，只需將該文件作為 Java 應用程序啟動。
- pom.xml - 包含構建此項目所需的所有依賴。我們將使用 Spring Boot Starter Web。
使用 Spring Initializr 引導創(chuàng)建 REST 服務
用 Spring Initializr 創(chuàng)建一個 REST 服務是非常的容易小菜一碟。我們將使用 Spring Web MVC 作為我們的 web 層框架。
Spring Initializr http://start.spring.io/ 是引導創(chuàng)建 Spring Boot 項目的好工具。
如上圖所示，必須執(zhí)行以下步驟
啟動 Spring Initializr 并選擇以下內容
選擇 com.in28minutes.springboot 為 Group
選擇 student-services 為 Artifact
選擇以下依賴項
- Web
- Actuator
- DevTools
點擊生成項目。
將項目導入 Eclipse。文件 - > 導入 - > 現(xiàn)有的 Maven 項目。
如果你想了解這個項目的所有文件，你可以繼續(xù)向下閱讀。
應用業(yè)務層實現(xiàn)
所有應用都需要數(shù)據(jù)。我們將使用 ArrayList 這種內存數(shù)據(jù)存儲，而不是與真實數(shù)據(jù)庫交互。
一名學生可以參加多門課程。課程有一個 ID，名稱，說明和完成課程需要完成的步驟列表。學生有一個身份證，姓名，說明和他 / 她目前注冊的課程列表。StudentService 提供以下公開方法
public List retrieveAllStudents() - 檢索所有學生的詳細信息
public Student retrieveStudent(String studentId) - 檢索特定的學生詳細信息
public List retrieveCourses(String studentId) - 檢索學生注冊的所有課程
public Course retrieveCourse(String studentId, String courseId) - 檢索學生注冊的特定課程的詳細信息
public Course addCourse(String studentId, Course course) - 為現(xiàn)有學生添加課程
請參閱下面這些文件，具體的實現(xiàn)服務類 StudentService 和模型類 Course 和 Student。
- src/main/java/com/in28minutes/springboot/model/Course.java
- src/main/java/com/in28minutes/springboot/model/Student.java
- src/main/java/com/in28minutes/springboot/service/StudentService.java
添加幾個 GET Rest 服務
Rest 服務 StudentController 暴露了幾個 get 服務。
- @Autowired private StudentService studentService ：我們使用 Spring Autowiring 將 student 服務自動注入到 StudentController。
- @GetMapping(“/students/{studentId}/courses”)：以 studentId 作為路徑變量公開獲取服務
- @GetMapping(“/students/{studentId}/courses/{courseId}”)：公開獲取服務以檢索學生的特定課程。
- @PathVariable String studentId：來自 uri 的 studentId 的值將映射到此參數(shù)。
package com.in28minutes.springboot.controller;
import java.util.List;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RestController;
import com.in28minutes.springboot.model.Course;
import com.in28minutes.springboot.service.StudentService;
@RestController
public class StudentController {
@Autowired
private StudentService studentService;
@GetMapping("/students/{studentId}/courses")
public List<Course> retrieveCoursesForStudent(@PathVariable String studentId) {
return studentService.retrieveCourses(studentId);
}
@GetMapping("/students/{studentId}/courses/{courseId}")
public Course retrieveDetailsForCourse(@PathVariable String studentId,
@PathVariable String courseId) {
return studentService.retrieveCourse(studentId, courseId);
}
}
使用 Postman 執(zhí)行獲取服務
我們將向 http：// localhost：8080 / students / Student1 / courses / Course1 發(fā)起請求以測試該服務。回應如下所示。
{
"id": "Course1",
"name": "Spring",
"description": "10 Steps",
"steps": [
"Learn Maven",
"Import Project",
"First Example",
"Second Example"
]
}
下面的圖片顯示了我們如何執(zhí)行 Postman 的 Get Service - 我最喜歡的運行 rest 服務的工具。
添加 POST Rest 服務
當資源創(chuàng)建成功時，POST 服務應該返回創(chuàng)建的狀態(tài)（201）。
- @PostMapping(“/students/{studentId}/courses”)：為 POST 請求映射 URL
- @RequestBody Course newCourse：使用綁定將請求正文綁定到課程對象。
- ResponseEntity.created(location).build()：返回已創(chuàng)建的狀態(tài)。還將創(chuàng)建資源的位置作為響應標題返回。
@PostMapping("/students/{studentId}/courses")
public ResponseEntity<Void> registerStudentForCourse(
@PathVariable String studentId, @RequestBody Course newCourse) {
Course course = studentService.addCourse(studentId, newCourse);
if (course == null)
return ResponseEntity.noContent().build();
URI location = ServletUriComponentsBuilder.fromCurrentRequest().path(
"/{id}").buildAndExpand(course.getId()).toUri();
return ResponseEntity.created(location).build();
}
執(zhí)行 POST Rest 服務
示例請求如下所示。它包含了學生注冊課程的所有細節(jié)。
{
"name": "Microservices",
"description": "10 Steps",
"steps": [
"Learn How to Break Things Up",
"Automate the hell out of everything",
"Have fun"
]
}
下圖顯示了我們如何從 Postman 執(zhí)行 Post 服務 - 我最喜歡的運行 rest 服務的工具。確保你去 Body 選項卡并選擇 raw。從下拉菜單中選擇 JSON。將上述請求復制到 body 中。
我們使用的 URL 是 http：// localhost：8080 / students / Student1 / courses。
完整的代碼示例
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.in28minutes.springboot</groupId> <artifactId>student-services</artifactId> <version>0.0.1-SNAPSHOT</version> <packaging>jar</packaging> <name>student-services</name> <description>Demo project for Spring Boot</description> <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>1.4.4.RELEASE</version> <relativePath/> <!-- lookup parent from repository --> </parent> <properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding> <java.version>1.8</java.version> </properties> <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-actuator</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-devtools</artifactId> <scope>runtime</scope> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-test</artifactId> <scope>test</scope> </dependency> </dependencies> <build> <plugins> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> </plugin> </plugins> </build> </project>
src/main/java/com/in28minutes/springboot/controller/StudentController.java
import java.net.URI;
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.RestController;
import org.springframework.web.servlet.support.ServletUriComponentsBuilder;
import com.in28minutes.springboot.model.Course;
import com.in28minutes.springboot.service.StudentService;
@RestController
public class StudentController {
@Autowired
private StudentService studentService;
@GetMapping("/students/{studentId}/courses")
public List<Course> retrieveCoursesForStudent(@PathVariable String studentId) {
return studentService.retrieveCourses(studentId);
}
@GetMapping("/students/{studentId}/courses/{courseId}")
public Course retrieveDetailsForCourse(@PathVariable String studentId,
@PathVariable String courseId) {
return studentService.retrieveCourse(studentId, courseId);
}
@PostMapping("/students/{studentId}/courses")
public ResponseEntity<Void> registerStudentForCourse(
@PathVariable String studentId, @RequestBody Course newCourse) {
Course course = studentService.addCourse(studentId, newCourse);
if (course == null)
return ResponseEntity.noContent().build();
URI location = ServletUriComponentsBuilder.fromCurrentRequest().path(
"/{id}").buildAndExpand(course.getId()).toUri();
return ResponseEntity.created(location).build();
}
}
src/main/java/com/in28minutes/springboot/model/Course.java
import java.util.List;
public class Course {
private String id;
private String name;
private String description;
private List<String> steps;
// Needed by Caused by: com.fasterxml.jackson.databind.JsonMappingException:
// Can not construct instance of com.in28minutes.springboot.model.Course:
// no suitable constructor found, can not deserialize from Object value
// (missing default constructor or creator, or perhaps need to add/enable
// type information?)
public Course() {
}
public Course(String id, String name, String description, List<String> steps) {
super();
this.id = id;
this.name = name;
this.description = description;
this.steps = steps;
}
public String getId() {
return id;
}
public void setId(String id) {
this.id = id;
}
public String getDescription() {
return description;
}
public String getName() {
return name;
}
public List<String> getSteps() {
return steps;
}
@Override
public String toString() {
return String.format(
"Course [id=%s, name=%s, description=%s, steps=%s]", id, name,
description, steps);
}
@Override
public int hashCode() {
final int prime = 31;
int result = 1;
result = prime * result + ((id == null) ? 0 : id.hashCode());
return result;
}
@Override
public boolean equals(Object obj) {
if (this == obj)
return true;
if (obj == null)
return false;
if (getClass() != obj.getClass())
return false;
Course other = (Course) obj;
if (id == null) {
if (other.id != null)
return false;
} else if (!id.equals(other.id))
return false;
return true;
}
}
src/main/java/com/in28minutes/springboot/model/Student.java
package com.in28minutes.springboot.model;
import java.util.List;
public class Student {
private String id;
private String name;
private String description;
private List<Course> courses;
public Student(String id, String name, String description,
List<Course> courses) {
super();
this.id = id;
this.name = name;
this.description = description;
this.courses = courses;
}
public String getId() {
return id;
}
public void setId(String id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getDescription() {
return description;
}
public void setDescription(String description) {
this.description = description;
}
public List<Course> getCourses() {
return courses;
}
public void setCourses(List<Course> courses) {
this.courses = courses;
}
@Override
public String toString() {
return String.format(
"Student [id=%s, name=%s, description=%s, courses=%s]", id,
name, description, courses);
}
}
src/main/java/com/in28minutes/springboot/service/StudentService.java
package com.in28minutes.springboot.service;
import java.math.BigInteger;
import java.security.SecureRandom;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;
import org.springframework.stereotype.Component;
import com.in28minutes.springboot.model.Course;
import com.in28minutes.springboot.model.Student;
@Component
public class StudentService {
private static List<Student> students = new ArrayList<>();
static {
//Initialize Data
Course course1 = new Course("Course1", "Spring", "10 Steps", Arrays
.asList("Learn Maven", "Import Project", "First Example",
"Second Example"));
Course course2 = new Course("Course2", "Spring MVC", "10 Examples",
Arrays.asList("Learn Maven", "Import Project", "First Example",
"Second Example"));
Course course3 = new Course("Course3", "Spring Boot", "6K Students",
Arrays.asList("Learn Maven", "Learn Spring",
"Learn Spring MVC", "First Example", "Second Example"));
Course course4 = new Course("Course4", "Maven",
"Most popular maven course on internet!", Arrays.asList(
"Pom.xml", "Build Life Cycle", "Parent POM",
"Importing into Eclipse"));
Student ranga = new Student("Student1", "Ranga Karanam",
"Hiker, Programmer and Architect", new ArrayList<>(Arrays
.asList(course1, course2, course3, course4)));
Student satish = new Student("Student2", "Satish T",
"Hiker, Programmer and Architect", new ArrayList<>(Arrays
.asList(course1, course2, course3, course4)));
students.add(ranga);
students.add(satish);
}
public List<Student> retrieveAllStudents() {
return students;
}
public Student retrieveStudent(String studentId) {
for (Student student : students) {
if (student.getId().equals(studentId)) {
return student;
}
}
return null;
}
public List<Course> retrieveCourses(String studentId) {
Student student = retrieveStudent(studentId);
if (student == null) {
return null;
}
return student.getCourses();
}
public Course retrieveCourse(String studentId, String courseId) {
Student student = retrieveStudent(studentId);
if (student == null) {
return null;
}
for (Course course : student.getCourses()) {
if (course.getId().equals(courseId)) {
return course;
}
}
return null;
}
private SecureRandom random = new SecureRandom();
public Course addCourse(String studentId, Course course) {
Student student = retrieveStudent(studentId);
if (student == null) {
return null;
}
String randomId = new BigInteger(130, random).toString(32);
course.setId(randomId);
student.getCourses().add(course);
return course;
}
}
src/main/java/com/in28minutes/springboot/StudentServicesApplication.java
package com.in28minutes.springboot;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class StudentServicesApplication {
public static void main(String[] args) {
SpringApplication.run(StudentServicesApplication.class, args);
}
}
以上就是本文的全部內容，希望對大家的學習有所幫助，也希望大家多多支持腳本之家。
- SpringBoot構建Restful service完成Get和Post請求
- Spring Boot(四)之使用JWT和Spring Security保護REST API
- Spring Boot集成springfox-swagger2構建restful API的方法教程
- SpringBoot集成Swagger2實現(xiàn)Restful(類型轉換錯誤解決辦法)
- 詳解Spring Boot實戰(zhàn)之Rest接口開發(fā)及數(shù)據(jù)庫基本操作
- 詳解使用Spring Boot開發(fā)Restful程序
- 詳解SpringBoot restful api的單元測試
- Spring Boot 實現(xiàn)Restful webservice服務端示例代碼
- 使用SpringBoot開發(fā)Restful服務實現(xiàn)增刪改查功能
相關文章
這篇文章主要介紹了Java數(shù)組反轉方式,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2024-06-06
這篇文章主要介紹了Java Object類中的常用API介紹,本文通過實例代碼給大家介紹的非常詳細，對大家的學習或工作具有一定的參考借鑒價值，需要的朋友可以參考下2022-11-11
springBoot+mybatis-plus實現(xiàn)監(jiān)聽mysql數(shù)據(jù)庫的數(shù)據(jù)增刪改
mybatis-plus技術是簡化了繁瑣的代碼操作,把增刪改查的語句都內置了,直接調用就可以實現(xiàn)數(shù)據(jù)庫的增刪改查了,這篇文章主要給大家介紹了關于springBoot+mybatis-plus實現(xiàn)監(jiān)聽mysql數(shù)據(jù)庫數(shù)據(jù)增刪改的相關資料,需要的朋友可以參考下2024-01-01
java實戰(zhàn)案例之用戶注冊并發(fā)送郵件激活/發(fā)送郵件驗證碼
現(xiàn)在很多的網站都提供有用戶注冊功能,當我們注冊成功之后就會收到封注冊網站的郵件,郵件里包含了我們的注冊的用戶名和密碼及激活賬戶的超鏈接等信息,這篇文章主要給大家介紹了關于java實戰(zhàn)案例之用戶注冊并發(fā)送郵件激活/發(fā)送郵件驗證碼的相關資料,需要的朋友可以參考下2021-09-09
這篇文章主要介紹了Java雪花算法的原理和實現(xiàn)方法,雪花算法是一種分布式唯一ID生成算法,可以生成全局唯一的ID標識符,就像自然界中雪花一般沒有相同的雪花,下面將詳細介紹,感興趣的可以學習一下2023-10-10
下面小編就為大家?guī)硪黄猨dbc結合dpcp連接池的封裝實例。小編覺得挺不錯的，現(xiàn)在就分享給大家，也給大家做個參考。一起跟隨小編過來看看吧2017-10-10
消息隊列是最古老的中間件之一，從系統(tǒng)之間有通信需求開始，就自然產生了消息隊列。本文告訴什么是消息隊列，為什么需要消息隊列，常見的消息隊列有哪些，RabbitMQ的部署和使用2021-09-09
SpringSecurity實現(xiàn)登陸認證并返回token方式
這篇文章主要介紹了SpringSecurity實現(xiàn)登陸認證并返回token方式,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2024-03-03
SpringBoot項目中HTTP請求體只能讀一次的解決方案
在基于Spring開發(fā)Java項目時,可能需要重復讀取HTTP請求體中的數(shù)據(jù),例如使用攔截器打印入?yún)⑿畔⒌?但當我們重復調用getInputStream()或者getReader()時,通常會遇到SpringBoot HTTP請求只讀一次的問題,本文給出了幾種解決方案,需要的朋友可以參考下2024-08-08
這篇文章主要介紹了Lombok的@Data等注解無效的解決，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2020-11-11