12、使用OpenAPI添加API描述及实现数据持久化

使用OpenAPI添加API描述及实现数据持久化

1. OpenAPI添加API描述

当输入负的产品ID时，会返回422“不可处理实体”错误。从配置中我们可以了解到：
- 属性占位符（如 ${api.responseCodes.ok.description} ）会被转换为 OK 。YAML属性文件具有分层结构，示例如下：

api:
  responseCodes:
    ok.description: OK

• 多行值以 | 开头，例如属性 api.get-composite-product.description.notes 。同时，springdoc-openapi支持使用Markdown语法提供多行描述。

1.1 构建和启动微服务

在尝试OpenAPI文档之前，需要构建并启动微服务。操作步骤如下：
1. 进入指定目录：

cd $BOOK_HOME/Chapter05

2. 执行构建和启动命令：

./gradlew build && docker-compose build && docker-compose up -d