1、修改配置文件
@Configuration
@EnableSwagger2
@EnableSwaggerBootstrapUI
@Import(BeanValidatorPluginsConfiguration.class)
public class Swagger2 {
private String basePackage="com.XXX";
private String title="XXXX开发接口文档";
/**
* @Description:swagger2的配置文件,这里可以配置swagger2的一些基本的内容,比如扫描的包等等
*/
@Bean
public Docket createRestApi() {
return new Docket(DocumentationType.SWAGGER_2).apiInfo(apiInfo()).select()
.apis(RequestHandlerSelectors.basePackage(basePackage))
.paths(PathSelectors.any()).build();
}
/**
* @Description: 构建 api文档的信息
*/
private ApiInfo apiInfo() {
return new ApiInfoBuilder()
.title(title)
.contact(new Contact("", "http://www.whbswdt.com", ""))
.description("欢迎访问武汉百胜开发接口文档")
.version("20.8.28").build();
}
}
2、注解使用
@PostMapping("/createOrder421")
@ApiOperation(value = "fastjson-JSONObject-动态创建显示参数")
@ApiOperationSupport(params = @DynamicParameters(name = "CreateOrderModel",properties = {
@DynamicParameter(name = "id",value = "注解id",example = "X000111",required = true,dataTypeClass = Integer.class),
@DynamicParameter(name = "name",value = "订单编号",required = false)
}))
public Rest<JSONObject> createOrder12222(@RequestBody JSONObject jsonObject){
Rest<JSONObject> r=new Rest<>();
r.setData(jsonObject);
return r;
}
@PostMapping("/createOrder422")
@ApiOperation(value = "jdk-Map-动态创建显示参数")
@DynamicParameters(name = "CreateOrderMapModel",properties = {
@DynamicParameter(name = "id",value = "注解id",example = "X000111",required = true,dataTypeClass = Integer.class),
@DynamicParameter(name = "name",value = "订单编号"),
@DynamicParameter(name = "name1",value = "订单编号1"),
@DynamicParameter(name = "orderInfo",value = "订单信息",dataTypeClass = Order.class),
})
public Rest<Map> createOrder12232(@RequestBody Map map){
Rest<Map> r=new Rest<>();
r.setData(map);
return r;
}
最终,页面效果呈现如下:
————————————————
版权声明:本文为CSDN博主「墨着染霜华」的原创文章,遵循CC 4.0 BY-SA版权协议,转载请附上原文出处链接及本声明。
原文链接:https://blog.csdn.net/chengmin123456789/article/details/108345669