12、微服务API文档与数据持久化实践

微服务API文档与数据持久化实践

1. 启动微服务容器与测试

首先，启动缺失的容器，使用以下命令：

cd ../Chapter05
docker-compose up -d

此命令仅启动缺失的 product-composite 容器，因为其他容器已成功启动。启动后，可运行以下命令等待微服务环境启动并验证其是否正常工作：

./test-em-all.bash

2. 探索OpenAPI文档

2.1 使用Swagger UI查看文档

打开浏览器，访问 http://localhost:8080/openapi/swagger-ui.html ，可看到OpenAPI文档页面。该页面包含以下内容：
1. 我们在 springdoc-openapi 的OpenAPI bean中指定的一般信息，以及指向实际OpenAPI文档的链接 /openapi/v3/api-docs ，其指向 http://localhost:8080/openapi/v3/api-docs 。
2. 一个API资源列表，这里是 ProductComposite API 。
3. 页面底部有一个部分，可检查API中使用的模式。

2.2 查看API文档详情