在学习Java编程的过程中，动手实践是掌握知识的关键环节。一个结构清晰、功能完整的小项目管理系统不仅能帮助你巩固语法基础，还能锻炼面向对象设计、数据库操作和前后端交互能力。本文将带你一步步搭建一个基于Java的练手小项目管理系统，适合初学者到中级开发者逐步进阶。
一、项目目标与功能规划
首先明确我们的目标：创建一个简易但具备基本功能的项目管理平台。它应该支持用户注册登录、项目创建与查看、任务分配与状态更新等功能。系统采用B/S架构（浏览器/服务器），后端使用Java Spring Boot框架，前端用HTML+CSS+JavaScript，数据库选用MySQL。
1. 核心功能模块
- 用户管理：注册、登录、权限控制（管理员/普通用户）
- 项目管理：新增、编辑、删除项目，显示项目列表及详情
- 任务管理：为每个项目添加任务，设置负责人、截止日期、进度状态
- 数据持久化：通过JPA或MyBatis实现数据存储与读取
二、技术栈选择与环境准备
为了确保项目的可扩展性和易维护性，我们选择如下技术组合：
- 开发语言：Java 17+
- 框架：Spring Boot 3.x（自动配置、嵌入式Tomcat）
- 数据库：MySQL 8.0（推荐使用Navicat或DBeaver进行可视化管理）
- ORM工具：Spring Data JPA（简化数据库操作）
- 前端：Thymeleaf模板引擎（服务端渲染，适合入门）
- 构建工具：Maven（依赖管理和项目打包）
1. 开发环境搭建步骤
- 安装JDK 17并配置环境变量
- 下载并安装IntelliJ IDEA（或Eclipse）
- 创建Spring Boot项目（官网https://start.spring.io/ 或IDEA内置向导）
- 引入必要依赖：
spring-boot-starter-web、spring-boot-starter-data-jpa、mysql-connector-java、spring-boot-starter-security等 - 配置application.yml文件连接本地MySQL数据库
三、数据库设计与实体类映射
合理设计数据库表结构是整个系统的基石。我们设计三个核心表：用户表（user）、项目表（project）、任务表（task）。
CREATE TABLE user (
id BIGINT PRIMARY KEY AUTO_INCREMENT,
username VARCHAR(50) UNIQUE NOT NULL,
password VARCHAR(255) NOT NULL,
role ENUM('ADMIN', 'USER') DEFAULT 'USER'
);
CREATE TABLE project (
id BIGINT PRIMARY KEY AUTO_INCREMENT,
name VARCHAR(100) NOT NULL,
description TEXT,
creator_id BIGINT,
create_time DATETIME DEFAULT CURRENT_TIMESTAMP,
FOREIGN KEY (creator_id) REFERENCES user(id)
);
CREATE TABLE task (
id BIGINT PRIMARY KEY AUTO_INCREMENT,
title VARCHAR(100) NOT NULL,
description TEXT,
assignee_id BIGINT,
project_id BIGINT,
status ENUM('TODO', 'IN_PROGRESS', 'DONE') DEFAULT 'TODO',
due_date DATE,
create_time DATETIME DEFAULT CURRENT_TIMESTAMP,
FOREIGN KEY (assignee_id) REFERENCES user(id),
FOREIGN KEY (project_id) REFERENCES project(id)
);对应地，在Java中定义Entity类：
@Entity
public class User {
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;
private String username;
private String password;
private String role;
// getter/setter...
}
@Entity
public class Project {
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;
private String name;
private String description;
@ManyToOne(fetch = FetchType.LAZY)
@JoinColumn(name = "creator_id")
private User creator;
// getter/setter...
}四、业务逻辑层实现
使用@Service注解定义服务类，封装CRUD操作。例如：
@Service
public class ProjectService {
@Autowired
private ProjectRepository projectRepository;
public List getAllProjects() {
return projectRepository.findAll();
}
public Project saveProject(Project project) {
return projectRepository.save(project);
}
// 删除、更新等方法... 同时结合Spring Security实现简单权限控制，如仅管理员可删除项目：
@PreAuthorize("hasRole('ADMIN')")
@DeleteMapping("/projects/{id}")
public void deleteProject(@PathVariable Long id) {
projectRepository.deleteById(id);
}五、控制器与页面跳转
使用@Controller和@RequestMapping处理HTTP请求，配合Thymeleaf渲染页面。例如：
@Controller
public class ProjectController {
@Autowired
private ProjectService projectService;
@GetMapping("/projects")
public String listProjects(Model model) {
model.addAttribute("projects", projectService.getAllProjects());
return "projects/list"; // 返回templates/projects/list.html
}
@PostMapping("/projects")
public String createProject(@ModelAttribute Project project, Principal principal) {
User currentUser = userService.findByUsername(principal.getName());
project.setCreator(currentUser);
projectService.saveProject(project);
return "redirect:/projects";
}
}1. 前端页面设计建议
- 使用Bootstrap美化UI，提升用户体验
- 列表页展示项目卡片，包含名称、描述、创建时间
- 详情页显示任务列表，并提供新增任务按钮
- 登录页使用表单验证，防止非法访问
六、测试与部署上线
开发完成后，必须进行充分测试：
- 单元测试：使用JUnit编写Service层测试用例
- 集成测试：模拟真实请求调用API接口
- 手动测试：检查页面跳转、数据一致性、权限限制
部署时可将项目打包成jar文件，通过命令行运行：
mvn clean package
java -jar target/project-manager.jar若需远程部署，可上传至Linux服务器，使用Nginx反向代理，实现对外访问。
七、进阶拓展方向
完成基础版本后，你可以尝试以下扩展：
- 加入JWT Token认证替代Session机制
- 使用Vue.js重构前端，打造SPA应用
- 接入Redis缓存热点数据，提高性能
- 增加日志记录、异常处理、邮件通知等功能
- 部署Docker容器化，便于迁移与维护
八、常见问题与解决方案
- Q: 数据库连接失败怎么办？
- 检查application.yml中的数据库URL、用户名和密码是否正确；确认MySQL服务已启动。
- Q: 页面无法加载静态资源？
- 确保static目录下放置css、js文件，且Spring Boot默认路径为classpath:/static/。
- Q: 登录后无权限访问某些页面？
- 检查SecurityConfig配置是否生效，以及@PreAuthorize注解是否正确使用角色名。
通过这样一个完整的Java练手小项目管理系统开发流程，你不仅能熟练掌握Spring Boot的核心特性，还能积累真实项目开发经验，为未来进入企业级开发打下坚实基础。