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

    /**
     * 用戶名
     * @Column: 映射數(shù)據(jù)庫(kù)字段屬性
     * nullable = false: 數(shù)據(jù)庫(kù)這一列不能為空
     * unique = true: 用戶名必須唯一
     */
    @Column(nullable = false, unique = true, length = 50)
    private String username;
    /**
     * 密碼 (實(shí)際開發(fā)中不能存明文，要存加密后的哈希值)
     */
    @Column(nullable = false, length = 100)
    private String password;
    /**
     * 郵箱
     */
    @Column(length = 100)
    private String email;
    /**
     * 創(chuàng)建時(shí)間
     * 用于記錄這一條數(shù)據(jù)是什么時(shí)候插入生成的
     */
    @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<實(shí)體類類型, 主鍵類型>
 * 
 * 作用：這就是那個(gè)"采購(gòu)員"，Spring Boot 自動(dòng)幫你實(shí)現(xiàn)好了去數(shù)據(jù)庫(kù)拿數(shù)據(jù)的方法：
 * - save(User user): 保存或更新
 * - findById(Long id): 根據(jù)ID查詢
 * - findAll(): 查詢所有
 * - deleteById(Long id): 根據(jù)ID刪除
 */
@Repository // 標(biāo)記這是持久層組件，Spring 會(huì)把它放入容器管理
public interface UserRepository extends JpaRepository<User, Long> {
    /**
     * 自定義查詢方法
     * JPA 的神奇之處：只要按照規(guī)則命名方法，SQL 語句自動(dòng)生成！
     * 
     * 翻譯：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，我要用這個(gè)采購(gòu)員(Repository)，請(qǐng)幫我送進(jìn)來
    private UserRepository userRepository;

    /**
     * 新增用戶 (注冊(cè))
     * 業(yè)務(wù)邏輯：
     * 1. 檢查用戶名是否存在
     * 2. 補(bǔ)全創(chuàng)建時(shí)間
     * 3. 保存到數(shù)據(jù)庫(kù)
     */
    @Transactional // 開啟事務(wù)：保證一系列操作要么全成功，要么全失敗
    public User register(User userData) {
        // 1. 簡(jiǎn)單校驗(yàn)
        if (userData.getUsername() == null) {
            throw new RuntimeException("用戶名不能為空");
        }
        // 2. 檢查是不是重名了
        User existUser = userRepository.findByUsername(userData.getUsername());
        if (existUser != null) {
            throw new RuntimeException("用戶名已存在，換一個(gè)吧");
        }
        // 3. 補(bǔ)全系統(tǒng)字段 (創(chuàng)建時(shí)間)
        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("要?jiǎng)h除的用戶不存在！");
        }
        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 // 聲明這是一個(gè) 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();
    }

    /**
     * 注冊(cè)新用戶
     * URL: POST /api/users
     * @RequestBody: 讀取請(qǐng)求體中的 JSON 數(shù)據(jù)轉(zhuǎn)為 User 對(duì)象
     */
    @PostMapping
    public String add(@RequestBody User user) {
        try {
            userService.register(user);
            return "注冊(cè)成功！"; 
        } catch (Exception e) {
            return "注冊(cè)失敗: " + 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();
        }
    }
}