使用 Spring Boot 和 Docker 建立用戶 CRUD 應用程式

介紹

Spring Boot 是一個使用 Spring 框架簡化生產就緒應用程式開發的框架。它提供了一組工具和約定來幫助您快速且有效率地建立應用程式。借助 Spring Boot，您可以透過最少的配置輕鬆建立獨立的生產級應用程式。

本指南將引導您使用 Spring Boot 建立一個簡單的使用者 CRUD（建立、讀取、更新、刪除）應用程式。我們還將使用 Docker 將應用程式容器化，以確保不同環境之間的一致性。

先決條件

確保您已安裝以下軟體：

• Java JDK 11 或更高版本
• Maven
• 碼頭工人
• Git

步驟1：創建一個新的Spring Boot項目

生成專案

使用 Spring Initializr 產生新的 Spring Boot 專案：

• 專案：Maven 專案
• 語言：Java
• Spring Boot：3.2.0
• 群組：com.example
• 神器：user-crud
• 依賴項：Spring Web、Spring Data JPA、H2 資料庫

點選「產生」下載項目，然後解壓縮。

導航到專案目錄

cd user-crud

步驟 2：定義使用者實體

建立實體類別

在 src/main/java/com/example/usercrud 中建立一個名為 User.java 的新 Java 類別：

package com.example.usercrud;

import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;

@Entity
public class User {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    private String name;
    private String email;

    // Getters and Setters
    public Long getId() {
        return id;
    }

    public void setId(Long id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getEmail() {
        return email;
    }

    public void setEmail(String email) {
        this.email = email;
    }
}

第 3 步：建立使用者儲存庫

建立儲存庫介面

在 src/main/java/com/example/usercrud 中建立一個名為 UserRepository.java 的新 Java 介面：

package com.example.usercrud;

import org.springframework.data.jpa.repository.JpaRepository;

public interface UserRepository extends JpaRepository<User, Long> {
}

第 4 步：建立使用者控制器

建立 REST 控制器

在 src/main/java/com/example/usercrud 中建立一個名為 UserController.java 的新 Java 類別：

package com.example.usercrud;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;

import java.util.List;
import java.util.Optional;

@RestController
@RequestMapping("/api/users")
public class UserController {

    @Autowired
    private UserRepository userRepository;

    @PostMapping
    public ResponseEntity<User> createUser(@RequestBody User user) {
        User savedUser = userRepository.save(user);
        return new ResponseEntity<>(savedUser, HttpStatus.CREATED);
    }

    @GetMapping
    public List<User> getAllUsers() {
        return userRepository.findAll();
    }

    @GetMapping("/{id}")
    public ResponseEntity<User> getUserById(@PathVariable Long id) {
        Optional<User> user = userRepository.findById(id);
        return user.map(ResponseEntity::ok).orElseGet(() -> ResponseEntity.notFound().build());
    }

    @PutMapping("/{id}")
    public ResponseEntity<User> updateUser(@PathVariable Long id, @RequestBody User user) {
        if (!userRepository.existsById(id)) {
            return ResponseEntity.notFound().build();
        }
        user.setId(id);
        User updatedUser = userRepository.save(user);
        return ResponseEntity.ok(updatedUser);
    }

    @DeleteMapping("/{id}")
    public ResponseEntity<Void> deleteUser(@PathVariable Long id) {
        if (!userRepository.existsById(id)) {
            return ResponseEntity.notFound().build();
        }
        userRepository.deleteById(id);
        return ResponseEntity.noContent().build();
    }
}

第 5 步：建立 Dockerfile

新增 Dockerfile

在專案的根目錄中建立一個名為 Dockerfile 的文件，其中包含以下內容：

# Use a base image with Java 11
FROM openjdk:11-jdk-slim

# Set the working directory
WORKDIR /app

# Copy the jar file from the target directory
COPY target/user-crud-0.0.1-SNAPSHOT.jar app.jar

# Expose port 8080
EXPOSE 8080

# Run the application
ENTRYPOINT ["java", "-jar", "/app/app.jar"]

建置 Docker 映像

首先，使用 Maven 打包您的應用程式：

./mvnw clean package

然後建置 Docker 映像：

docker build -t user-crud .

第 6 步：運行 Docker 容器

運行容器

使用以下指令執行 Docker 容器：

docker run -p 8080:8080 user-crud

驗證應用程式

造訪 http://localhost:8080/api/users 以確保應用程式在 Docker 容器中正確運作。您可以使用curl或Postman等工具來測試CRUD端點。

結論

您已經使用 Spring Boot 成功創建了一個簡單的 User CRUD 應用程序，使用 Docker 將其容器化，並驗證了其操作。此設定可讓您在不同環境中一致地部署和管理應用程序，您可以使用其他功能擴展此範例或將其整合到更大的系統中。
請隨時提出您的問題...祝您編碼愉快！

更多資訊請參考：

• Spring Boot 文件
• Docker 文件

以上是使用 Spring Boot 和 Docker 建立用戶 CRUD 應用程式的詳細內容。更多資訊請關注PHP中文網其他相關文章！