请假管理系统配置Spring Boot项目，规划RESTful接口

本课将通过配置一个Spring Boot项目并规划RESTful接口的方式，创建一个简单的请假管理系统。我们将学习如何使用Spring Boot框架构建后端服务，设计RESTful API，及其与前端或移动端的交互。

1. Spring Boot简介

Spring Boot是一个基于Spring框架的开发工具，它简化了配置和部署的过程，提供了开箱即用的功能，能够帮助开发者快速构建独立、生产级的应用。

1.1 Spring Boot的特点

自动配置：Spring Boot通过自动配置简化了开发过程，开发者无需手动配置大量的XML文件。
内嵌服务器：Spring Boot内置了Tomcat、Jetty等Web服务器，开发者无需外部服务器支持。
快速开发：Spring Boot基于约定优于配置，极大地提升开发效率。

2. 项目结构和依赖

2.1 创建Spring Boot项目

使用Spring Initializr创建项目：

访问Spring Initializr
填写项目名称，如leave-management-system
选择项目构建工具（Maven/Gradle）和Java版本
添加以下依赖：
- Spring Web
- Spring Data JPA
- H2 Database（可根据需求替换为MySQL或PostgreSQL）
- Spring Boot DevTools（用于热部署）

2.2 项目结构

创建一个Spring Boot项目后，通常的目录结构如下：

src
 ├── main
 │   ├── java
 │   │   └── com
 │   │       └── example
 │   │           └── leave
 │   │               ├── controller
 │   │               ├── model
 │   │               ├── repository
 │   │               ├── service
 │   │               └── LeaveManagementApplication.java
 │   └── resources
 │       ├── application.properties
 │       └── static
 │           └── index.html

3. 设计RESTful接口

在请假管理系统中，我们需要为用户提供以下功能：

用户可以申请请假
用户可以查看请假记录
管理员可以审批请假

根据这些需求，我们可以设计以下RESTful API接口：

POST /leave：申请请假
GET /leave/{id}：查看请假记录
PUT /leave/{id}/approve：审批请假请求
GET /leave：查看所有请假记录

3.1 创建Leave模型类

Leave类表示请假请求，它包含以下属性：请假ID、员工ID、请假开始时间、结束时间、请假类型、审批状态等。

package com.example.leave.model;

import javax.persistence.*;
import java.time.LocalDate;

@Entity
public class Leave {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    
    private String employeeId;
    
    private LocalDate startDate;
    
    private LocalDate endDate;
    
    private String leaveType;
    
    private String status; // "PENDING", "APPROVED", "REJECTED"

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

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

    public String getEmployeeId() {
        return employeeId;
    }

    public void setEmployeeId(String employeeId) {
        this.employeeId = employeeId;
    }

    public LocalDate getStartDate() {
        return startDate;
    }

    public void setStartDate(LocalDate startDate) {
        this.startDate = startDate;
    }

    public LocalDate getEndDate() {
        return endDate;
    }

    public void setEndDate(LocalDate endDate) {
        this.endDate = endDate;
    }

    public String getLeaveType() {
        return leaveType;
    }

    public void setLeaveType(String leaveType) {
        this.leaveType = leaveType;
    }

    public String getStatus() {
        return status;
    }

    public void setStatus(String status) {
        this.status = status;
    }
}

3.2 创建LeaveRepository接口

LeaveRepository接口用于与数据库进行交互，处理请假数据的增删改查（CRUD）操作。

package com.example.leave.repository;

import com.example.leave.model.Leave;
import org.springframework.data.jpa.repository.JpaRepository;

public interface LeaveRepository extends JpaRepository<Leave, Long> {
    // 可以添加自定义查询方法，例如根据员工ID查找请假记录
    List<Leave> findByEmployeeId(String employeeId);
}

3.3 创建LeaveService服务类

LeaveService类用于业务逻辑处理，包括请假申请的提交、审批操作等。

package com.example.leave.service;

import com.example.leave.model.Leave;
import com.example.leave.repository.LeaveRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.util.List;

@Service
public class LeaveService {

    @Autowired
    private LeaveRepository leaveRepository;

    // 提交请假请求
    public Leave applyLeave(Leave leave) {
        leave.setStatus("PENDING"); // 初始状态为待审批
        return leaveRepository.save(leave);
    }

    // 获取员工的请假记录
    public List<Leave> getLeaveByEmployee(String employeeId) {
        return leaveRepository.findByEmployeeId(employeeId);
    }

    // 审批请假请求
    public Leave approveLeave(Long id) {
        Leave leave = leaveRepository.findById(id).orElseThrow(() -> new RuntimeException("Leave not found"));
        leave.setStatus("APPROVED");
        return leaveRepository.save(leave);
    }
}

3.4 创建LeaveController控制器

LeaveController负责提供RESTful API接口，接收客户端请求并返回数据。

package com.example.leave.controller;

import com.example.leave.model.Leave;
import com.example.leave.service.LeaveService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

import java.util.List;

@RestController
@RequestMapping("/leave")
public class LeaveController {

    @Autowired
    private LeaveService leaveService;

    // 申请请假
    @PostMapping
    public Leave applyLeave(@RequestBody Leave leave) {
        return leaveService.applyLeave(leave);
    }

    // 获取员工的请假记录
    @GetMapping("/{employeeId}")
    public List<Leave> getLeaveByEmployee(@PathVariable String employeeId) {
        return leaveService.getLeaveByEmployee(employeeId);
    }

    // 审批请假
    @PutMapping("/{id}/approve")
    public Leave approveLeave(@PathVariable Long id) {
        return leaveService.approveLeave(id);
    }
}

4. 配置应用程序

4.1 配置`application.properties`

在src/main/resources/application.properties文件中配置数据库连接和其他参数。

# 数据库配置（以H2为例）
spring.datasource.url=jdbc:h2:mem:testdb
spring.datasource.driverClassName=org.h2.Driver
spring.datasource.username=sa
spring.datasource.password=password
spring.jpa.hibernate.ddl-auto=update
spring.h2.console.enabled=true

# 服务器端口配置
server.port=8080