本项目是跟随黑马程序员教程开发的 Java Web 入门项目 —— Tlias(传智乐安寺)Web 管理系统。
这是我学习 Java Web 开发的起点项目,涵盖了企业级开发中最常用的技术栈,包括员工管理、班级管理、学员管理、文件上传等核心功能模块。通过这个项目,可以掌握 Spring Boot + MyBatis + MySQL 的完整后端开发流程。
| 层级 | 技术 |
|---|---|
| 前端 | Vue.js (Vite 构建) + Nginx |
| 后端框架 | Spring Boot 3.2.10 |
| 持久层 | MyBatis + PageHelper 分页插件 |
| 数据库 | MySQL |
| 认证 | JWT (JSON Web Token) |
| 文件存储 | 阿里云 OSS |
| 构建工具 | Maven |
| JDK 版本 | Java 17 |
- 🧑💼 员工管理 — 员工增删改查、条件分页查询、工作经历管理
- 🏫 班级管理 — 班级信息维护、班主任分配
- 🎓 学员管理 — 学员信息管理、违纪记录、学员统计
- 📁 文件上传 — 基于阿里云 OSS 的图片/文件上传
- 🔐 登录认证 — JWT 令牌登录验证
- JDK 17+
- Maven 3.6+
- MySQL 8.0+
- Nginx(已内置在项目中)
- 启动你的 MySQL 服务
- 创建数据库:
CREATE DATABASE tlias DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;- 导入项目根目录下的
表结构.sql文件:
USE tlias;
SOURCE /path/to/表结构.sql;- 修改后端配置文件
tlias-backend/tlias-web-management/src/main/resources/application.yml,将数据库连接信息替换为你自己的:
spring:
datasource:
url: jdbc:mysql://localhost:3306/tlias
username: your_username # 👈 改为你的数据库用户名
password: your_password # 👈 改为你的数据库密码- 同时在该配置文件中设置 JWT 密钥(格式要求见下方说明):
jwt:
secret-key: your-secret-key-here # 👈 改为你自己的JWT密钥本项目使用 HS256(HMAC-SHA256) 算法签名 JWT,密钥可以是任意字符串,但为了安全性建议遵循以下规范:
- 随机生成:不要使用常见单词或短语
- 足够长度:建议 32 字符以上(256 bits)
- Base64 编码:推荐使用 Base64 编码的随机字符串(避免特殊字符转义问题)
生成方法(任选一种):
# Linux / Mac / Windows Git Bash
openssl rand -base64 32
# 输出类似: 7JvM9xLpK3nR8qT2wY5aBcDfGhJkMnOpQrStUvXyZ123456或使用在线工具生成随机 Base64 字符串。
示例配置文件片段:
jwt:
secret-key: 7JvM9xLpK3nR8qT2wY5aBcDfGhJkMnOpQrStUvXyZ123456 # 示例,请自己生成!
⚠️ 重要:请勿直接复制示例密钥,务必自己运行命令生成一个全新的。密钥泄露 = 任何人都可以伪造登录令牌。
- 如需使用文件上传功能,还需配置阿里云 OSS(可选):
aliyun:
oss:
endpoint: https://oss-cn-beijing.aliyuncs.com
bucketName: your-bucket-name
region: cn-beijing并在系统环境变量中设置 OSS_ACCESS_KEY_ID 和 OSS_ACCESS_KEY_SECRET。
进入后端项目目录,使用 Maven 启动:
cd tlias-backend/tlias-web-management
# 编译并启动
mvn spring-boot:run
# 或者先打包再运行
mvn clean package -DskipTests
java -jar target/tlias-web-management-0.0.1-SNAPSHOT.jar后端默认运行在 http://localhost:8080。
项目已内置 Nginx,直接启动即可:
cd nginx-1.22.0-web/nginx-1.22.0-web
# Windows 下双击 nginx.exe 或在命令行运行:
start nginx
# Linux/Mac 下:
./nginxNginx 默认运行在 90 端口,并已配置好 API 代理转发到后端 8080 端口。
打开浏览器访问:http://localhost:90
tliasearn/
├── nginx-1.22.0-web/ # 前端 + Nginx
│ └── nginx-1.22.0-web/
│ ├── html/ # 前端静态文件 (Vue.js)
│ ├── conf/nginx.conf # Nginx 配置(端口、代理等)
│ └── nginx.exe # Nginx 可执行文件
├── tlias-backend/ # 后端 Spring Boot 项目
│ └── tlias-web-management/
│ ├── src/main/java/com/itheima/
│ │ ├── controller/ # 控制器层
│ │ ├── service/ # 业务逻辑层
│ │ ├── mapper/ # MyBatis 数据访问层
│ │ ├── pojo/ # 实体类
│ │ ├── utils/ # 工具类(JWT、OSS等)
│ │ ├── config/ # 配置类
│ │ ├── filter/ # 过滤器
│ │ ├── interceptor/ # 拦截器
│ │ ├── exception/ # 全局异常处理
│ │ └── anno/ # 自定义注解
│ ├── src/main/resources/
│ │ ├── application.yml # 👈 核心配置文件
│ │ └── logback.xml # 日志配置
│ └── pom.xml # Maven 依赖
└── 表结构.sql # 数据库初始化脚本
- 配置文件:启动前务必修改
application.yml中的数据库用户名和密码 - JWT 密钥:请务必将 JWT 密钥替换为你自己的安全密钥
- 阿里云 OSS:文件上传功能依赖阿里云 OSS,如不需要可暂时跳过配置
- 端口占用:确保 3306 (MySQL)、8080 (后端)、90 (前端) 端口未被占用
- JDK 版本:项目基于 Java 17,请确保 JDK 版本匹配
感谢黑马程序员提供的优质教程,本项目作为 Java Web 学习的起点,帮助我建立了完整的全栈开发认知。
📅 学习记录 | 黑马程序员 Java Web 课程