# springboot2-bucket

**Repository Path**: make-mm/springboot2-bucket

## Basic Information

- **Project Name**: springboot2-bucket
- **Description**: 收集整理SpringBoot2中日常用于功能，目标是平时开发可直接复用各模块功能
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-27
- **Last Updated**: 2025-11-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# springboot2-bucket

这是一个基于 Spring Boot 2 的项目模板，旨在为开发者提供一个快速启动 Spring Boot 应用程序的基础框架。该项目包含一个示例 HTTP 服务模块（`demo-http-service`），可用于构建 RESTful API 服务。

## 项目结构

- **pom.xml**：项目的主 Maven 配置文件，定义了项目的基本信息和依赖管理。
- **demo-http-service/**：示例 HTTP 服务模块，基于 Spring Boot 构建。
  - **pom.xml**：模块级别的 Maven 配置文件。
  - **src/main/java/**：Java 源代码目录，包含控制器、切面、异常处理等组件。
  - **src/main/resources/**：资源文件目录，包含配置文件和静态资源。
  - **src/test/java/**：单元测试代码目录。

## 主要功能

- **日志记录**：通过 `LogAspect` 切面实现方法级别的日志记录，支持自定义注解 `@Log`。
- **全局异常处理**：通过 `GlobalExceptionHandler` 实现统一的异常处理机制，支持多种异常类型。
- **API 请求处理**：提供基础控制器 `BaseController`，支持处理 API 请求并返回标准化的响应格式。
- **响应格式标准化**：通过 `ApiResponse` 类实现统一的 API 响应格式，包含成功和失败的响应方法。

## 快速开始

1. **克隆项目**

   ```bash
   git clone https://gitee.com/make-mm/springboot2-bucket.git
   cd springboot2-bucket
   ```

2. **构建项目**

   ```bash
   mvn clean install
   ```

3. **运行示例服务**

   ```bash
   cd demo-http-service
   mvn spring-boot:run
   ```

4. **访问 API**

   启动后，可以通过 `http://localhost:8080/api/FluxOcpJsonApi` 访问示例 API 接口。

## 贡献指南

欢迎贡献代码和改进项目。请遵循以下步骤：

1. Fork 项目仓库。
2. 创建新分支 (`git checkout -b feature/new-feature`)。
3. 提交更改 (`git commit -am 'Add new feature'`)。
4. 推送分支 (`git push origin feature/new-feature`)。
5. 提交 Pull Request。

## 许可证

本项目采用 MIT 许可证。详情请查看 [LICENSE](LICENSE) 文件。