mybig-event¶

约 597 个字 55 行代码预计阅读时间 4 分钟

项目简介¶

mybig-event 是一个基于 Spring Boot 的事件管理系统，提供用户管理、文章发布、分类管理、文件上传等功能，采用现代化的 Java 技术栈构建，支持高效开发和部署。

技术栈¶

核心框架：Spring Boot 3.1.3
数据访问：MyBatis 3.0.0、PageHelper 1.4.7
数据库：MySQL 8.0.33
缓存：Redis
认证授权：JWT (java-jwt 4.4.0)
文件存储：阿里云 OSS (aliyun-sdk-oss 3.15.1)
数据校验：Spring Boot Starter Validation
工具类：Lombok、MD5 加密
构建工具：Maven
开发工具：IntelliJ IDEA
CI/CD：GitHub Actions

功能模块¶

1. 用户管理模块¶

用户注册与登录（支持 JWT 认证）
个人信息查询与修改
头像上传（对接阿里云 OSS）
密码修改与安全验证

2. 文章管理模块¶

文章发布与编辑
文章分类与状态管理（已发布 / 草稿）
文章列表分页查询
支持按分类和状态筛选

3. 分类管理模块¶

分类的增删改查
分类数据校验

4. 文件上传模块¶

基于阿里云 OSS 的文件存储
支持图片上传并返回访问 URL

项目结构¶

plaintext

Text Only

mybig-event/
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── itheima/
│   │   │       ├── controller/      # 控制器层
│   │   │       ├── service/         # 服务层
│   │   │       ├── mapper/          # 数据访问层
│   │   │       ├── pojo/            # 实体类
│   │   │       └── utils/           # 工具类
│   │   └── resources/
│   │       ├── application.yml      # 全局配置
│   │       └── com/itheima/mapper/  # MyBatis 映射文件
│   └── test/                        # 测试代码
├── .github/workflows/               # GitHub Actions 配置
├── .idea/                           # IDEA 项目配置
├── pom.xml                          # Maven 依赖配置
└── .gitignore                       # Git 忽略文件配置

快速开始¶

环境要求¶

JDK 17+
MySQL 8.0+
Redis 5.0+
Maven 3.6+

配置步骤¶

克隆仓库
bash

Bash

git clone https://github.com/yourusername/mybig-event.git
cd mybig-event

2. 修改配置文件
编辑 src/main/resources/application.yml，配置数据库和 Redis 连接：
yaml

YAML

spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/big_event
    username: 你的数据库用户名
    password: 你的数据库密码
  data:
    redis:
      host: localhost
      port: 6379
      password: 你的Redis密码（如无则留空）

3. 配置阿里云 OSS
编辑 src/main/java/itheima/utils/AliOssUtil.java，修改 OSS 配置：
java

运行

Java

private static final String ENDPOINT = "你的OSS地域节点";
private static final String ACCESS_KEY_ID = "你的ACCESS_KEY_ID";
private static final String ACCESS_KEY_SECRET = "你的ACCESS_KEY_SECRET";
private static final String BUCKET_NAME = "你的Bucket名称";

建议生产环境通过环境变量注入密钥，避免硬编码

创建数据库
在 MySQL 中创建数据库 big_event，并根据实体类创建对应表结构（可通过 MyBatis 逆向工程生成）。

构建与运行
bash

Bash

mvn clean package
java -jar target/mybig-event-1.0-SNAPSHOT.jar

服务将在 http://localhost:9090 启动

API 示例¶

用户注册¶

bash

Bash

POST /user/register
Content-Type: application/json

{
  "username": "testuser",
  "password": "testpass123"
}

文章发布¶

bash

Bash

POST /article
Content-Type: application/json
Authorization: Bearer {your-jwt-token}

{
  "title": "测试文章",
  "content": "这是一篇测试文章",
  "coverImg": "https://example.com/img.jpg",
  "state": "已发布",
  "categoryId": 1
}

开发指南¶

代码规范：遵循阿里巴巴 Java 开发手册
提交规范：使用语义化提交信息（如 feat: 新增文章查询接口）
测试要求：核心功能需编写单元测试
分支管理：使用 master 作为主分支，功能开发使用 feature 分支

自动化构建¶

项目配置了 GitHub Actions 自动化构建流程，当代码推送到 master 分支或创建 Pull Request 时，将自动执行以下操作：

检查代码
构建项目
运行测试
生成依赖报告

mybig-event¶

项目简介¶

技术栈¶

功能模块¶

1. 用户管理模块¶

2. 文章管理模块¶

3. 分类管理模块¶

4. 文件上传模块¶

项目结构¶

快速开始¶

环境要求¶

配置步骤¶

API 示例¶

用户注册¶

文章发布¶

开发指南¶

自动化构建¶

许可证¶