如何在 SpringDoc OpenAPI 3 中引用文件？

Question

我有一个 Springboot 项目，我想在其中记录我的 API:

这里是正在处理的 Web 服务示例：

    @ApiResponses(
        value = {
                @ApiResponse(responseCode = "200", content =  @Content(
                        mediaType = "*/*",
                        schema = @Schema(implementation = Object.class),
                        examples = {
                                @ExampleObject(name = "boo",
                                summary = "example of boo",
                                ref = "#/swagger/Planner/semi_planif_200_response.json")
                        }

                ))
        }
)
@PostMapping(value = "/startSemiPlanification", produces = "application/json")
private ResponseEntity<Object> startSemiPlanner( @RequestBody PlanificationDto planificationData,
                                                @RequestParam(name = "groupByUserCode", required = false) Optional<Boolean> groupByUserCode,
                                            @RequestParam(name = "range", defaultValue = "18") Integer range

我的问题是 Swagger 无法解析此引用 ref = "#/swagger/Planner/semi_planif_200_response.json" 我什至尝试过绝对路径并且它没有工作：

这是文件路径：

Answer 1

引用未在编译时解析，而是在运行项目之后 swagger 引擎将解析引用，因为它们是服务器中的静态资源：

 $ref= resources/swagger/user.json

如果我们是运行我们在本地主机中的实例，那么资源将从这个 url 中获取：localhost:8080/resources/swagger/user.json

提示：确保spring资源处理程序将目标资源放置在指定位置！

如何在 SpringDoc OpenAPI 3 中引用文件？

How to refrence files in SpringDoc OpenAPI3?

java

spring-boot

swagger-ui

openapi