搭建一个基于Spring Boot的校园台球厅人员与设备管理系统可以涵盖多个功能模块，例如用户管理、设备管理、预约管理、计费管理等。以下是一个简化的步骤指南，帮助你快速搭建一个基础的系统。

—

1. 项目初始化

使用 Spring Initializr 生成一个Spring Boot项目：

1. 访问 Spring Initializr。
2. 选择以下依赖：
   • Spring Web（用于构建RESTful API或MVC应用）
   • Spring Data JPA（用于数据库操作）
   • Spring Security（用于用户认证和授权）
   • Thymeleaf（可选，用于前端页面渲染）
   • MySQL Driver（或其他数据库驱动）
   • Lombok（简化代码）
3. 点击“Generate”下载项目。

—帮助链接：通过网盘分享的文件：share
链接: https://pan.baidu.com/s/1Vu-rUCm2Ql5zIOtZEvndgw?pwd=5k2h 提取码: 5k2h

2. 项目结构

项目结构大致如下：

src/main/java/com/example/poolhall
    ├── controller
    ├── service
    ├── repository
    ├── model
    ├── config
    └── PoolHallApplication.java
src/main/resources
    ├── static
    ├── templates
    └── application.properties

3. 配置数据库

在application.properties中配置数据库连接：

spring.datasource.url=jdbc:mysql://localhost:3306/pool_hall
spring.datasource.username=root
spring.datasource.password=yourpassword
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true

4. 创建实体类

在model包中创建实体类，例如User、Equipment、Reservation等。

用户实体类 (User)

package com.example.poolhall.model;

import javax.persistence.*;
import java.util.Set;

@Entity
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String username;
    private String password;
    private String email;
    private String role; // e.g., ADMIN, STUDENT

    @OneToMany(mappedBy = "user", cascade = CascadeType.ALL)
    private Set<Reservation> reservations;

    // Getters and Setters
}

设备实体类 (Equipment)

package com.example.poolhall.model;

import javax.persistence.*;

@Entity
public class Equipment {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String name;
    private String description;
    private boolean available;

    @OneToMany(mappedBy = "equipment", cascade = CascadeType.ALL)
    private Set<Reservation> reservations;

    // Getters and Setters
}

预约实体类 (Reservation)

package com.example.poolhall.model;

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

@Entity
public class Reservation {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @ManyToOne
    @JoinColumn(name = "user_id")
    private User user;

    @ManyToOne
    @JoinColumn(name = "equipment_id")
    private Equipment equipment;

    private LocalDateTime startTime;
    private LocalDateTime endTime;
    private double cost;

    // Getters and Setters
}

5. 创建Repository接口

在repository包中创建JPA Repository接口。

package com.example.poolhall.repository;

import com.example.poolhall.model.Equipment;
import org.springframework.data.jpa.repository.JpaRepository;

public interface EquipmentRepository extends JpaRepository<Equipment, Long> {
}

6. 创建Service层

在service包中创建服务类。

package com.example.poolhall.service;

import com.example.poolhall.model.Equipment;
import com.example.poolhall.repository.EquipmentRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.util.List;

@Service
public class EquipmentService {
    @Autowired
    private EquipmentRepository equipmentRepository;

    public List<Equipment> getAllEquipment() {
        return equipmentRepository.findAll();
    }

    public Equipment getEquipmentById(Long id) {
        return equipmentRepository.findById(id).orElse(null);
    }

    public Equipment saveEquipment(Equipment equipment) {
        return equipmentRepository.save(equipment);
    }

    public void deleteEquipment(Long id) {
        equipmentRepository.deleteById(id);
    }
}

7. 创建Controller层

在controller包中创建控制器类。

package com.example.poolhall.controller;

import com.example.poolhall.model.Equipment;
import com.example.poolhall.service.EquipmentService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.*;

@Controller
@RequestMapping("/equipment")
public class EquipmentController {
    @Autowired
    private EquipmentService equipmentService;

    @GetMapping
    public String listEquipment(Model model) {
        model.addAttribute("equipment", equipmentService.getAllEquipment());
        return "equipment";
    }

    @GetMapping("/new")
    public String showEquipmentForm(Model model) {
        model.addAttribute("equipment", new Equipment());
        return "equipment-form";
    }

    @PostMapping
    public String saveEquipment(@ModelAttribute Equipment equipment) {
        equipmentService.saveEquipment(equipment);
        return "redirect:/equipment";
    }

    @GetMapping("/edit/{id}")
    public String showEditForm(@PathVariable Long id, Model model) {
        model.addAttribute("equipment", equipmentService.getEquipmentById(id));
        return "equipment-form";
    }

    @GetMapping("/delete/{id}")
    public String deleteEquipment(@PathVariable Long id) {
        equipmentService.deleteEquipment(id);
        return "redirect:/equipment";
    }
}

8. 创建前端页面

在src/main/resources/templates目录下创建Thymeleaf模板文件。

equipment.html

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>Equipment</title>
</head>
<body>
    <h1>Equipment</h1>
    <a href="/equipment/new">Add New Equipment</a>
    <table>
        <thead>
            <tr>
                <th>ID</th>
                <th>Name</th>
                <th>Description</th>
                <th>Available</th>
                <th>Actions</th>
            </tr>
        </thead>
        <tbody>
            <tr th:each="equipment : ${equipment}">
                <td th:text="${equipment.id}"></td>
                <td th:text="${equipment.name}"></td>
                <td th:text="${equipment.description}"></td>
                <td th:text="${equipment.available} ? 'Yes' : 'No'"></td>
                <td>
                    <a th:href="@{/equipment/edit/{id}(id=${equipment.id})}">Edit</a>
                    <a th:href="@{/equipment/delete/{id}(id=${equipment.id})}">Delete</a>
                </td>
            </tr>
        </tbody>
    </table>
</body>
</html>

equipment-form.html

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>Equipment Form</title>
</head>
<body>
    <h1>Equipment Form</h1>
    <form th:action="@{/equipment}" th:object="${equipment}" method="post">
        <input type="hidden" th:field="*{id}" />
        <label>Name:</label>
        <input type="text" th:field="*{name}" /><br/>
        <label>Description:</label>
        <input type="text" th:field="*{description}" /><br/>
        <label>Available:</label>
        <input type="checkbox" th:field="*{available}" /><br/>
        <button type="submit">Save</button>
    </form>
</body>
</html>

9. 运行项目

在IDE中运行PoolHallApplication.java，访问http://localhost:8080/equipment即可看到设备列表页面。

10. 进一步扩展

• 用户管理：实现用户注册、登录、权限管理等功能。
• 预约管理：允许用户预约台球设备，并记录预约时间。
• 计费管理：根据预约时间计算费用。
• 设备状态管理：实时更新设备的使用状态。
• 搜索功能：实现设备的搜索功能。
• 分页功能：对设备列表进行分页显示。

通过以上步骤，你可以搭建一个基础的校园台球厅人员与设备管理系统，并根据需求进一步扩展功能。