这是一个基于Spring Boot和Spring Cloud的微服务项目,包含API网关、用户服务和公共模块,并集成了Swagger2文档。
microservice-demo/
├── api-gateway/ # API网关服务
├── user-service/ # 用户服务
├── common/ # 公共模块
└── pom.xml # 父POM文件
- Spring Boot 2.7.5
- Spring Cloud 2021.0.5
- Spring Cloud Gateway
- Spring Data JPA
- H2 Database
- Swagger2 / SpringFox 3.0.0
- Lombok
- Maven
- 基于Spring Cloud Gateway的API网关
- 用户服务提供基本的CRUD操作
- 统一的API响应格式
- 全局异常处理
- Swagger2 API文档
- JDK 11+
- Maven 3.6+
mvn clean install- 首先启动Eureka服务注册中心
cd eureka-server
mvn spring-boot:run- 启动用户服务
cd user-service
mvn spring-boot:run- 启动API网关
cd api-gateway
mvn spring-boot:run启动服务后,可以通过以下URL访问Swagger API文档:
- 用户服务API文档:http://localhost:8081/swagger-ui/
- API网关Swagger文档:http://localhost:8080/swagger-ui.html
POST /api/users
请求体:
{
"username": "zhangsan",
"password": "password123",
"email": "zhangsan@example.com",
"fullName": "张三"
}GET /api/users
GET /api/users/{id}
PUT /api/users/{id}
请求体:
{
"username": "zhangsan",
"email": "zhangsan@example.com",
"fullName": "张三"
}DELETE /api/users/{id}
- 本项目使用H2内存数据库,重启服务后数据会丢失