# messagewall-backend

**Repository Path**: josnma/messagewall-backend

## Basic Information

- **Project Name**: messagewall-backend
- **Description**: 留言板项目后端。
项目前端地址https://gitee.com/josnma/messagewall-frontend
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-02
- **Last Updated**: 2025-10-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MessageWall 后端项目

这是一个基于 Spring Boot 的后端项目，用于支持一个留言墙应用。该项目提供了基本的留言功能，并集成了 JWT 鉴权、MD5 加密以及雪花算法 ID 生成器。

## 功能特性

- **留言功能**：接收并存储用户留言。
- **JWT 鉴权**：提供基于 JWT 的身份验证支持。
- **MD5 加密**：提供密码加密工具。
- **雪花算法 ID 生成**：使用雪花算法生成唯一 ID。

## 技术栈

- Java 8+
- Spring Boot
- MyBatis
- JWT
- MySQL（未在代码中体现，可根据 Message 实体类推测）

## 项目结构

- `MessagewallBackendApplication.java`：Spring Boot 主启动类。
- `MessagewallController.java`：处理 `/message` 接口，接收留言。
- `MessageMapper.java`：MyBatis Mapper，用于数据库操作。
- `Message.java`：实体类，表示留言数据。
- `utils/`：工具类目录，包含 JWT、MD5 和雪花算法实现。
- `CorsConfig.java`：跨域配置类。
- `application.yml`：配置文件，包含 JWT 和 MD5 的配置。

## 使用说明

### 启动项目

1. 确保已安装 JDK 8+ 和 Maven。
2. 执行以下命令启动项目：

```bash
mvn spring-boot:run
```

或者使用 IDE 直接运行 `MessagewallBackendApplication` 类。

### 接口文档

#### POST /message

接收留言信息。

**参数：**

- `messageinfo`：留言内容（字符串）。

**示例请求：**

```bash
curl -X POST http://localhost:8080/message -d "messageinfo=Hello%20World"
```

## 工具类说明

### JwtUtil

用于生成和解析 JWT Token。

- `getToken(String userId)`：生成 Token。
- `parseToken(String token)`：解析 Token。

### Md5Util

用于生成 MD5 加密字符串。

- `getMd5String(String passwd)`：返回加密后的字符串。

### GenerateSnowidUtil

基于雪花算法的唯一 ID 生成器。

- `nextId()`：生成下一个唯一 ID。

## 测试类

`SpringJwtApplicationTests.java` 包含了对 JWT、MD5 和雪花算法的单元测试。

## 注意事项

- 本项目未包含数据库配置，需根据实际需求在 `application.yml` 中添加数据库连接信息。
- JWT 和 MD5 的配置（如密钥、过期时间等）可在 `application.yml` 中进行修改。

## 开源许可

本项目采用 MIT 许可证。详情请查看项目中的 LICENSE 文件（如有）。