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文档之前，需要构建和启动微服务环境，可使用以下命令：

cd $BOOK_HOME/Chapter05
./gradlew build && docker-compose build && docker-compose up -d

若遇到端口8080已被分配的错误信息，可运行以下命令找出正在执行的容器名称：

docke