プロジェクトに闊歩ドキュメントを追加しようとしています。Sample.class の @RequestBody に @Parameter の複数の例を追加する必要があります。次のコードは、ドキュメントに記載されている方法です。
@PostMapping("/")
public Sample createSample(@Parameter(description="Sample description", examples = {
@ExampleObject(name="foo", description = "na",summary = "na",value = "{\n" +
" \"id\": 10,\n" +
" \"name\": \"ashith\",\n" +
" \"description\": \"none\"\n" +
"}"),
@ExampleObject(name="bar",description = "na",summary = "na",value = "{\n" +
" \"id\": 20,\n" +
" \"name\": \"Akshatha\",\n" +
" \"description\": \"ok\"\n" +
"}")
}
)
@RequestBody Sample sample) {
生成される yaml 出力は次のとおりです。
openapi: 3.0.1
info:
title: OpenAPI definition
version: v0
servers:
- url: 'http://localhost:8080/'
description: Generated server url
paths:
/api/another/:
post:
tags:
- another-controller
operationId: createSample
requestBody:
description: Sample description
content:
application/json:
schema:
$ref: '#/components/schemas/Sample'
required: true
responses:
'200':
description: default response
content:
'*/*':
schema:
$ref: '#/components/schemas/Sample'
'400':
description: default response
content:
'*/*':
schema:
type: string
'404':
description: default response
content:
'*/*':
schema:
type: string
これには、コードに従って追加されるべきであった例が欠けているようです