如何手动描述java@RequestBody的示例输入 Map<String，String>？

java spring-boot springfox swagger

2022-09-04 02:23:01

我正在设计一个api，其中一个POST方法采用任何键值对。Map<String, String>

@RequestMapping(value = "/start", method = RequestMethod.POST)
public void startProcess(
    @ApiParam(examples = @Example(value = {
        @ExampleProperty(
            mediaType="application/json",
            value = "{\"userId\":\"1234\",\"userName\":\"JoshJ\"}"
        )
    }))
    @RequestBody(required = false) Map<String, String> fields) {
    // .. does stuff
}

我想提供一个示例输入，但我似乎无法让它在swagger输出中呈现。这不是正确的使用方式吗？fields@Example

答案 1

@g00glen00b的答案中提到的问题似乎已得到解决。下面是如何完成的代码片段。

在控制器类中：

// omitted other annotations
@ApiImplicitParams(
        @ApiImplicitParam(
                name = "body",
                dataType = "ApplicationProperties",
                examples = @Example(
                        @ExampleProperty(
                                mediaType = "application/json",
                                value = "{\"applicationName\":\"application-name\"}"
                        )
                )
        )
)
public Application updateApplicationName(
        @RequestBody Map<String, String> body
) {
    // ...
}

// Helper class for Swagger documentation - see http://springfox.github.io/springfox/docs/snapshot/#q27
public static class ApplicationProperties {

    private String applicationName;

    public String getApplicationName() {
        return applicationName;
    }

    public void setApplicationName(String applicationName) {
        this.applicationName = applicationName;
    }

}

此外，您需要将以下行添加到 Swagger 配置中：

// omitted other imports...
import com.fasterxml.classmate.TypeResolver;

@Bean
public Docket api(TypeResolver resolver) {
    return new Docket(DocumentationType.SWAGGER_2)
            .select()
            .apis(RequestHandlerSelectors.any())
            .paths(PathSelectors.any())
            .build()
            .apiInfo(apiInfo())
            // the following line is important!
            .additionalModels(resolver.resolve(DashboardController.ApplicationProperties.class));
}

更多文档可以在这里找到：http://springfox.github.io/springfox/docs/snapshot/#q27

答案 2

Swagger只提供API，这些注释仍然需要集成到Springfox框架中才能工作。在发布这个问题时，Springfox既没有得到支持，也没有得到Springfox的支持。这可以在#853和#1536中看到。@ExampleProperty@Example

从版本 2.9.0 开始，这已经实现。例如，您可以检查此答案。