使用Spring Boot創建Rest API
作者：學研妹
在這篇文章中，我們學習到了使用Spring Boot和Spring Initializr創建一個簡單的RESTful API的過程。我們創建了模型類來代表一個人，實現了控制器來處理HTTP請求，并使用樣本請求測試了API。
1 簡介
在這篇文章中，我們通過使用Spring Boot和Spring Initializr來演示創建簡單的RESTful API的過程。Spring Boot是一個流行的框架，它簡化了Spring應用程序的開發和部署，而Spring Initializr是一個基于Web的服務，它可以根據你的要求生成項目模板。
下面是關于如何使用Spring Boot和Spring Initializr創建RESTful API的分步驟指南：
2 使用Spring Initializr設置項目
進入Spring Initializr網站，填寫以下內容：
- 項目類型：Maven項目
- 語言：Java
- 包裝：Jar
- Java 版本：11
- 組：com.example
- 神器：restful-api
- 命名：restful-api
- 描述：使用Spring Boot的簡單RESTful API
- 包裝名稱：com.example.restfulapi
在 "選項 "下，選擇以下：
- 網絡：Spring Web
- 開發工具：Spring Boot DevTools (可選，用于開發目的)
點擊 "生成"，將項目模板下載為ZIP文件。提取文件并將項目導入你喜歡的IDE。
3 創建模型類
在com.example.restfulapi.model包中創建一個名為Person的新Java類。這個類在我們的RESTful API中代表一個人。
package com.example.restfulapi.model;
public class Person {
private Long id;
private String firstName;
private String lastName;
// 構造函數、獲取器和設置器
}4 創建控制器類
在com.example.restfulapi.controller包中創建一個名為PersonController的新Java類。這個類將為我們的RESTful API處理HTTP請求。
package com.example.restfulapi.controller;
import com.example.restfulapi.model.Person;
import org.springframework.web.bind.annotation.*;
import java.util.ArrayList;
import java.util.List;
import java.util.concurrent.atomic.AtomicLong;
@RestController
@RequestMapping("/api/v1/people")
public class PersonController {
private final List<Person> people = new ArrayList<>();
private final AtomicLong counter = new AtomicLong();
@GetMapping
public List<Person> getAllPeople() {
return people;
}
@PostMapping
public Person createPerson(@RequestBody Person person) {
person.setId(counter.incrementAndGet());
people.add(person);
return person;
}
@GetMapping("/{id}")
public Person getPersonById(@PathVariable("id") Long id) {
return people.stream()
.filter(person -> person.getId().equals(id))
.findFirst()
.orElse(null);
}
@PutMapping("/{id}")
public Person updatePerson(@PathVariable("id") Long id, @RequestBody Person updatedPerson) {
Person person = getPersonById(id);
if (person != null) {
person.setFirstName(updatedPerson.getFirstName());
person.setLastName(updatedPerson.getLastName());
}
return person;
}
@DeleteMapping("/{id}")
public void deletePerson(@PathVariable("id") Long id) {
people.removeIf(person -> person.getId().equals(id));
}
}5 運行應用程序
在你的IDE中運行RestfulApiApplication類，或者在項目根目錄下使用以下命令：
./mvnw spring-boot:run6 測試API
你可以使用Postman或curl等工具來測試API。這里有一些樣本請求：
- 獲取所有的人：GET http://localhost:8080/api/v1/people
- 創建一個新的人：POST http://localhost:8080/api/v1/people 與JSON主體 {"firstName"："John", "lastName"："Doe"}
- 通過身份證找一個人：GET http://localhost:8080/api/v1/people/1
- 更新一個人：PUT http://localhost:8080/api/v1/people/1 與JSON主體 {"firstName": "Jane", "lastName": "Doe"}
- 刪除一個人：DELETE http://localhost:8080/api/v1/people/1
7 總結
在這篇文章中，我們學習到了使用Spring Boot和Spring Initializr創建一個簡單的RESTful API的過程。我們創建了模型類來代表一個人，實現了控制器來處理HTTP請求，并使用樣本請求測試了API。Spring Boot和Spring Initializr讓我們能很容易地構建RESTful API和其他類型的應用程序，你的下個項目可以嘗試使用它們!
責任編輯：武曉燕
來源：
Java學研大本營
