Spring Boot 项目开发全流程实战示例总结

package com.example.demo.entity;
import lombok.Data; // Lombok 插件，自动生成 getter/setter/toString
import javax.persistence.*;
import java.io.Serializable;
import java.util.Date;
/**
 * 用户实体类
 * 对应数据库表：t_user
 */
@Data // Lombok 注解：自动生成 Getter, Setter, ToString, HashCode 等方法，省去手动编写
@Entity // JPA 注解：声明这是一个实体类，与数据库表映射
@Table(name = "t_user") // 指定对应的数据库表名为 t_user
public class User implements Serializable {
    private static final long serialVersionUID = 1L;
    /**
     * 主键 ID
     * @Id: 标识该属性为主键
     * @GeneratedValue: 指定主键生成策略，IDENTITY 表示使用数据库自增 (Auto Increment)
     */
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    // ... 下面继续添加其他字段

    /**
     * 用户名
     * @Column: 映射数据库字段属性
     * nullable = false: 数据库这一列不能为空
     * unique = true: 用户名必须唯一
     */
    @Column(nullable = false, unique = true, length = 50)
    private String username;
    /**
     * 密码 (实际开发中不能存明文，要存加密后的哈希值)
     */
    @Column(nullable = false, length = 100)
    private String password;
    /**
     * 邮箱
     */
    @Column(length = 100)
    private String email;
    /**
     * 创建时间
     * 用于记录这一条数据是什么时候插入生成的
     */
    @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 自动帮你实现好了去数据库拿数据的方法：
 * - save(User user): 保存或更新
 * - findById(Long id): 根据ID查询
 * - findAll(): 查询所有
 * - deleteById(Long id): 根据ID删除
 */
@Repository // 标记这是持久层组件，Spring 会把它放入容器管理
public interface UserRepository extends JpaRepository<User, Long> {
    /**
     * 自定义查询方法
     * JPA 的神奇之处：只要按照规则命名方法，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 // 标记这是业务层组件
public class UserService {
    @Autowired // 依赖注入：告诉 Spring，我要用这个采购员(Repository)，请帮我送进来
    private UserRepository userRepository;

    /**
     * 新增用户 (注册)
     * 业务逻辑：
     * 1. 检查用户名是否存在
     * 2. 补全创建时间
     * 3. 保存到数据库
     */
    @Transactional // 开启事务：保证一系列操作要么全成功，要么全失败
    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. 补全系统字段 (创建时间)
        userData.setCreateTime(new Date());
        // 4. 调用持久层保存
        return userRepository.save(userData);
    }

    /**
     * 查询所有用户列表
     */
    public List<User> findAllUsers() {
        return userRepository.findAll();
    }
    /**
     * 根据 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 风格的控制器
@RequestMapping("/api/users") // 定义统一的基础路径
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 数据转为 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();
        }
    }
}