Skip to content

About

java-web学习项目

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

Tlias Web 管理系统

📖 项目简介

本项目是跟随黑马程序员教程开发的 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(已内置在项目中)

1. 数据库配置

  1. 启动你的 MySQL 服务
  2. 创建数据库:
CREATE DATABASE tlias DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
  1. 导入项目根目录下的 表结构.sql 文件:
USE tlias;
SOURCE /path/to/表结构.sql;
  1. 修改后端配置文件 tlias-backend/tlias-web-management/src/main/resources/application.yml,将数据库连接信息替换为你自己的:
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/tlias
    username: your_username  # 👈 改为你的数据库用户名
    password: your_password  # 👈 改为你的数据库密码
  1. 同时在该配置文件中设置 JWT 密钥(格式要求见下方说明):
jwt:
  secret-key: your-secret-key-here  # 👈 改为你自己的JWT密钥

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  # 示例,请自己生成!

⚠️ 重要:请勿直接复制示例密钥,务必自己运行命令生成一个全新的。密钥泄露 = 任何人都可以伪造登录令牌。

  1. 如需使用文件上传功能,还需配置阿里云 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。

2. 启动后端

进入后端项目目录,使用 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。

3. 启动前端 (Nginx)

项目已内置 Nginx,直接启动即可:

cd nginx-1.22.0-web/nginx-1.22.0-web

# Windows 下双击 nginx.exe 或在命令行运行:
start nginx

# Linux/Mac 下:
./nginx

Nginx 默认运行在 90 端口,并已配置好 API 代理转发到后端 8080 端口。

4. 访问系统

打开浏览器访问: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                        # 数据库初始化脚本

⚠️ 注意事项

  1. 配置文件:启动前务必修改 application.yml 中的数据库用户名和密码
  2. JWT 密钥:请务必将 JWT 密钥替换为你自己的安全密钥
  3. 阿里云 OSS:文件上传功能依赖阿里云 OSS,如不需要可暂时跳过配置
  4. 端口占用:确保 3306 (MySQL)、8080 (后端)、90 (前端) 端口未被占用
  5. JDK 版本:项目基于 Java 17,请确保 JDK 版本匹配

🙏 致谢

感谢黑马程序员提供的优质教程,本项目作为 Java Web 学习的起点,帮助我建立了完整的全栈开发认知。


📅 学习记录 | 黑马程序员 Java Web 课程

About

java-web学习项目

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages