# Blog

**Repository Path**: bian-xianqing/blog

## Basic Information

- **Project Name**: Blog
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-09-11
- **Last Updated**: 2026-04-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# Blog Project

博客系统是一个基于 Spring Boot 框架开发的轻量级博客平台，提供文章管理、用户管理、文件上传等功能。

## 技术栈

- **后端框架**: Spring Boot 2.x
- **持久层框架**: MyBatis Plus
- **数据库**: MySQL
- **缓存**: Redis
- **日志**: Logback
- **构建工具**: Maven

## 项目结构

```
blog_project/
├── src/
│   ├── main/
│   │   ├── java/com/blog/blog_project/
│   │   │   ├── aop/              # AOP 切面
│   │   │   ├── config/           # 配置类
│   │   │   ├── controller/      # 控制器
│   │   │   ├── entry/           # 实体类
│   │   │   ├── mapper/           # 数据访问层
│   │   │   ├── service/          # 业务接口
│   │   │   ├── service/impl/     # 业务实现
│   │   │   └── utils/            # 工具类
│   │   └── resources/            # 资源配置
│   │       ├── application.yaml
│   │       └── logback-spring.xml
│   └── test/                     # 测试类
└── pom.xml
```

## 功能特性

### 文章管理
- 获取文章列表（分页）
- 根据 ID 获取文章详情
- 添加新文章
- 更新文章
- 删除文章

### 用户管理
- 获取用户列表（分页）
- 添加用户
- 更新用户信息
- 删除用户

### 文件管理
- 文件上传
- 文件下载
- 文件列表查看

### 其他特性
- AOP 请求日志记录
- Redis 缓存支持
- 统一响应结果封装

## 快速开始

### 环境要求

- JDK 1.8+
- Maven 3.x+
- MySQL 5.7+
- Redis

### 配置说明

在 `application.yaml` 中配置数据库和 Redis 连接信息：

```yaml
server:
  port: 8080

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/blog
    username: your_username
    password: your_password
  redis:
    host: localhost
    port: 6379

mybatis-plus:
  configuration:
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl

pic:
  upload-path: /your/upload/path/
```

### 运行项目

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

访问 `http://localhost:8080` 即可进入博客系统。

## API 接口

### 文章接口

| 方法 | 路径 | 描述 |
|------|------|------|
| GET | /article/list | 获取文章列表 |
| GET | /article/{id} | 获取文章详情 |
| POST | /article | 添加文章 |
| PUT | /article | 更新文章 |
| DELETE | /article/{id} | 删除文章 |

### 用户接口

| 方法 | 路径 | 描述 |
|------|------|------|
| GET | /users/list | 获取用户列表 |
| POST | /users | 添加用户 |
| PUT | /users | 更新用户 |
| DELETE | /users/delete/{id} | 删除用户 |

### 文件接口

| 方法 | 路径 | 描述 |
|------|------|------|
| POST | /upload | 上传文件 |
| GET | /download | 下载文件 |
| GET | /list | 获取文件列表 |

## 响应格式

所有接口返回统一格式的 JSON 数据：

```json
{
  "code": 200,
  "msg": "success",
  "data": {}
}
```

## 许可证

本项目仅供学习交流使用。