- 在 porm.xml 中添加依賴
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>2.2.2</version>
</dependency>
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger-ui</artifactId>
<version>2.2.2</version>
</dependency>
- 2.在 Application 同級目錄中添加 Swagger2 的配置類
@Configuration
@EnableSwagger2
public class Swagger2 {
@Bean
public Docket createRestApi() {
return new Docket(DocumentationType.SWAGGER_2)
.apiInfo(getApiInfo())
.select()
.apis(RequestHandlerSelectors.basePackage("org.xiaocai.web.controller"))
.paths(PathSelectors.any())
.build();
}
private ApiInfo getApiInfo() {
return new ApiInfoBuilder()
.title("小菜在使用swagger")
.description("這是第一個嘗試")
.version("1.0")
.build();
}
}
注意需要配置掃描Controller路徑 .apis(RequestHandlerSelectors.basePackage("org.xiaocai.web.controller"))
- 在 Controller 中添加需要的文檔說明
@RestController
public class CityRestController {
@Autowired
private CityService cityService;
@ApiOperation(value="查找城市", notes="根據(jù)城市名查找城市")
@RequestMapping(value = "/api/city", method = RequestMethod.GET)
public City findOneCity(@ApiParam(name = "cityName", value = "城市名", required = true ) @RequestParam(value = "cityName", required = true) String cityName) {
return cityService.findCityByName(cityName);
}
}
-
- 在瀏覽器中驗(yàn)證
打開：
http://localhost:8080/swagger-ui.html顯示
swagger.png
