通过前面的分析,我们最终得到了springfox的Documentation文档对象,将我们的RESTful接口最终转换为了文档对象,文档对象是包含了接口列表、分组信息等属性的
在springfox中,为我们提供了springfox-swagger-ui来呈现最终的接口信息.在ui界面中有两个核心接口:
- swagger-resources:swagger分组接口,创建多少Docket,就会有多少分组信息
- /v2/api-docs:Swagger接口示例信息,通过Documentation对象最终输出为Swagger标准信息
先来看接口源码:
@Controller
@ApiIgnore
@RequestMapping("/swagger-resources")
public class ApiResourceController {
@Autowired(required = false)
private SecurityConfiguration securityConfiguration;
@Autowired(required = false)
private UiConfiguration uiConfiguration;
private final SwaggerResourcesProvider swaggerResources;
@Autowired
public ApiResourceController(SwaggerResourcesProvider swaggerResources) {
this.swaggerResources = swaggerResources;
}
@RequestMapping(value = "/configuration/security")
@ResponseBody
public ResponseEntity<SecurityC