1 簡介

在這篇文章中，我們通過使用Spring Boot和Spring Initializr來演示創(chuàng)建簡單的RESTful API的過程。Spring Boot是一個(gè)流行的框架，它簡化了Spring應(yīng)用程序的開發(fā)和部署，而Spring Initializr是一個(gè)基于Web的服務(wù)，它可以根據(jù)你的要求生成項(xiàng)目模板。

下面是關(guān)于如何使用Spring Boot和Spring Initializr創(chuàng)建RESTful API的分步驟指南：

2 使用Spring Initializr設(shè)置項(xiàng)目

進(jìn)入Spring Initializr網(wǎng)站，填寫以下內(nèi)容：

• 項(xiàng)目類型：Maven項(xiàng)目
• 語言：Java
• 包裝：Jar
• Java 版本：11
• 組：com.example
• 神器：restful-api
• 命名：restful-api
• 描述：使用Spring Boot的簡單RESTful API
• 包裝名稱：com.example.restfulapi

在 "選項(xiàng) "下，選擇以下：

• 網(wǎng)絡(luò)：Spring Web
• 開發(fā)工具：Spring Boot DevTools (可選，用于開發(fā)目的)

點(diǎn)擊 "生成"，將項(xiàng)目模板下載為ZIP文件。提取文件并將項(xiàng)目導(dǎo)入你喜歡的IDE。

3 創(chuàng)建模型類

在com.example.restfulapi.model包中創(chuàng)建一個(gè)名為Person的新Java類。這個(gè)類在我們的RESTful API中代表一個(gè)人。

package com.example.restfulapi.model;

public class Person {
    private Long id;
    private String firstName;
    private String lastName;

    // 構(gòu)造函數(shù)、獲取器和設(shè)置器
}

4 創(chuàng)建控制器類

在com.example.restfulapi.controller包中創(chuàng)建一個(gè)名為PersonController的新Java類。這個(gè)類將為我們的RESTful API處理HTTP請(qǐng)求。

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 運(yùn)行應(yīng)用程序

在你的IDE中運(yùn)行RestfulApiApplication類，或者在項(xiàng)目根目錄下使用以下命令：

./mvnw spring-boot:run

6 測(cè)試API

你可以使用Postman或curl等工具來測(cè)試API。這里有一些樣本請(qǐng)求：

• 獲取所有的人：GET http://localhost:8080/api/v1/people
• 創(chuàng)建一個(gè)新的人：POST http://localhost:8080/api/v1/people 與JSON主體 {"firstName"："John", "lastName"："Doe"}
• 通過身份證找一個(gè)人：GET http://localhost:8080/api/v1/people/1
• 更新一個(gè)人：PUT http://localhost:8080/api/v1/people/1 與JSON主體 {"firstName": "Jane", "lastName": "Doe"}
• 刪除一個(gè)人：DELETE http://localhost:8080/api/v1/people/1

7 總結(jié)

在這篇文章中，我們學(xué)習(xí)到了使用Spring Boot和Spring Initializr創(chuàng)建一個(gè)簡單的RESTful API的過程。我們創(chuàng)建了模型類來代表一個(gè)人，實(shí)現(xiàn)了控制器來處理HTTP請(qǐng)求，并使用樣本請(qǐng)求測(cè)試了API。Spring Boot和Spring Initializr讓我們能很容易地構(gòu)建RESTful API和其他類型的應(yīng)用程序，你的下個(gè)項(xiàng)目可以嘗試使用它們!