package com.example.demo.entity;
import lombok.Data; // Lombok 插件，自動生成 getter/setter/toString
import javax.persistence.*;
import java.io.Serializable;
import java.util.Date;
/**
 * 用戶實體類
 * 對應(yīng)數(shù)據(jù)庫表：t_user
 */
@Data // Lombok 注解：自動生成 Getter, Setter, ToString, HashCode 等方法，省去手動編寫
@Entity // JPA 注解：聲明這是一個實體類，與數(shù)據(jù)庫表映射
@Table(name = "t_user") // 指定對應(yīng)的數(shù)據(jù)庫表名為 t_user
public class User implements Serializable {
    private static final long serialVersionUID = 1L;
    /**
     * 主鍵 ID
     * @Id: 標(biāo)識該屬性為主鍵
     * @GeneratedValue: 指定主鍵生成策略，IDENTITY 表示使用數(shù)據(jù)庫自增 (Auto Increment)
     */
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    // ... 下面繼續(xù)添加其他字段

    /**
     * 用戶名
     * @Column: 映射數(shù)據(jù)庫字段屬性
     * nullable = false: 數(shù)據(jù)庫這一列不能為空
     * unique = true: 用戶名必須唯一
     */
    @Column(nullable = false, unique = true, length = 50)
    private String username;
    /**
     * 密碼 (實際開發(fā)中不能存明文，要存加密后的哈希值)
     */
    @Column(nullable = false, length = 100)
    private String password;
    /**
     * 郵箱
     */
    @Column(length = 100)
    private String email;
    /**
     * 創(chuàng)建時間
     * 用于記錄這一條數(shù)據(jù)是什么時候插入生成的
     */
    @Column(name = "create_time")
    private Date createTime;
}

package com.example.demo.repository;
import com.example.demo.entity.User;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.stereotype.Repository;
/**
 * 用戶持久層接口
 * 繼承 JpaRepository<實體類類型, 主鍵類型>
 * 
 * 作用：這就是那個"采購員"，Spring Boot 自動幫你實現(xiàn)好了去數(shù)據(jù)庫拿數(shù)據(jù)的方法：
 * - save(User user): 保存或更新
 * - findById(Long id): 根據(jù)ID查詢
 * - findAll(): 查詢所有
 * - deleteById(Long id): 根據(jù)ID刪除
 */
@Repository // 標(biāo)記這是持久層組件，Spring 會把它放入容器管理
public interface UserRepository extends JpaRepository<User, Long> {
    /**
     * 自定義查詢方法
     * JPA 的神奇之處：只要按照規(guī)則命名方法，SQL 語句自動生成！
     * 
     * 翻譯：select * from t_user where username = ?
     */
    User findByUsername(String username);
    /**
     * 翻譯：select * from t_user where email = ?
     */
    User findByEmail(String email);
}

package com.example.demo.service;
import com.example.demo.entity.User;
import com.example.demo.repository.UserRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
import java.util.Date;
import java.util.List;
@Service // 標(biāo)記這是業(yè)務(wù)層組件
public class UserService {
    @Autowired // 依賴注入：告訴 Spring，我要用這個采購員(Repository)，請幫我送進(jìn)來
    private UserRepository userRepository;

    /**
     * 新增用戶 (注冊)
     * 業(yè)務(wù)邏輯：
     * 1. 檢查用戶名是否存在
     * 2. 補全創(chuàng)建時間
     * 3. 保存到數(shù)據(jù)庫
     */
    @Transactional // 開啟事務(wù)：保證一系列操作要么全成功，要么全失敗
    public User register(User userData) {
        // 1. 簡單校驗
        if (userData.getUsername() == null) {
            throw new RuntimeException("用戶名不能為空");
        }
        // 2. 檢查是不是重名了
        User existUser = userRepository.findByUsername(userData.getUsername());
        if (existUser != null) {
            throw new RuntimeException("用戶名已存在，換一個吧");
        }
        // 3. 補全系統(tǒng)字段 (創(chuàng)建時間)
        userData.setCreateTime(new Date());
        // 4. 調(diào)用持久層保存
        return userRepository.save(userData);
    }

    /**
     * 查詢所有用戶列表
     */
    public List<User> findAllUsers() {
        return userRepository.findAll();
    }
    /**
     * 根據(jù) ID 刪除用戶
     */
    @Transactional
    public void deleteUser(Long id) {
        if (!userRepository.existsById(id)) {
            throw new RuntimeException("要刪除的用戶不存在！");
        }
        userRepository.deleteById(id);
    }
}

package com.example.demo.controller;
import com.example.demo.entity.User;
import com.example.demo.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;
import java.util.List;
/**
 * 用戶管理控制器
 * @RestController = @Controller + @ResponseBody
 */
@RestController // 聲明這是一個 REST 風(fēng)格的控制器
@RequestMapping("/api/users") // 定義統(tǒng)一的基礎(chǔ)路徑
public class UserController {
    @Autowired
    private UserService userService; // 注入大廚 (Service)

    /**
     * 獲取用戶列表
     * URL: GET /api/users
     */
    @GetMapping 
    public List<User> list() {
        return userService.findAllUsers();
    }

    /**
     * 注冊新用戶
     * URL: POST /api/users
     * @RequestBody: 讀取請求體中的 JSON 數(shù)據(jù)轉(zhuǎn)為 User 對象
     */
    @PostMapping
    public String add(@RequestBody User user) {
        try {
            userService.register(user);
            return "注冊成功！"; 
        } catch (Exception e) {
            return "注冊失敗: " + e.getMessage();
        }
    }

    /**
     * 刪除用戶
     * URL: DELETE /api/users/{id} (例如 /api/users/5)
     * @PathVariable: 從 URL 路徑中提取 {id} 的值
     */
    @DeleteMapping("/{id}")
    public String delete(@PathVariable Long id) {
        try {
            userService.deleteUser(id);
            return "刪除成功";
        } catch (Exception e) {
            return "刪除失敗: " + e.getMessage();
        }
    }
}