1:引入坐标
<!--swagger-->
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>2.6.1</version>
</dependency>
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger-ui</artifactId>
<version>2.6.1</version>
</dependency>
2:配置swagger2
@EnableWebMvc
@Configuration
@EnableSwagger2
public class SwaggerConfig {
@Bean
public Docket createRestApi() {
return new Docket(DocumentationType.SWAGGER_2)
.apiInfo(apiInfo())
.select()
.apis(RequestHandlerSelectors.basePackage("com.test.swagger.controller"))
.paths(PathSelectors.any())
.build();
}
private ApiInfo apiInfo() {
return new ApiInfoBuilder()
.title("springmvc集成swagger构建api文档")
.description("demo")
.termsOfServiceUrl("http://localhost:8080")
.version("1.0")
.build();
}
}
3:配置controller
@Api(value = "测试",tags = "这个是tag")
@RestController
@RequestMapping("test")
public class TestController {
@ApiOperation(value = "测试方法",tags = "这个是方法上的")
@RequestMapping("hello")
public String test(String msg){
return msg;
}
}
最后一步:
在配置文件中配置bean
<bean id="swaggerConfig2" class="com.test.swagger.config.SwaggerConfig"></bean>
@ApiOperation中使用 value进行解释ui中可以看到tags值一致的对应方法,都会在一个连接中