SpringFox swagger2 and SpringFox swagger2 UI 接口文檔生成與查看

依賴：

<!-- https://mvnrepository.com/artifact/io.springfox/springfox-swagger2 -->
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>2.9.2</version>
</dependency>
<!-- https://mvnrepository.com/artifact/io.springfox/springfox-swagger-ui -->
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger-ui</artifactId>
    <version>2.9.2</version>
</dependency>

 

使用：在你要生成接口處加上注解@EnableSwagger2  ，此處是整個項目都要，不建議這么玩， 建議加在controller上

 

@SpringBootApplication
@EnableSwagger2 public class Application {

    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

 

 自定義標題:配置:(這個可以不配置)

@Configuration
@EnableSwagger2
public class Swagger2Config {

	@Bean
	public Docket createRestApi() {
		// ParameterBuilder ticketPar = new ParameterBuilder();
		// List<Parameter> pars = new ArrayList<Parameter>();
		// ticketPar.name("Authorization").description("登錄校驗")//name表示名稱，description表示描述
		// .modelRef(new ModelRef("string")).parameterType("header")
		// .required(false).defaultValue("Bearer
		// ").build();//required表示是否必填，defaultvalue表示默認值
		// pars.add(ticketPar.build());//添加完此處一定要把下邊的帶***的也加上否則不生效

		return new Docket(DocumentationType.SWAGGER_2).apiInfo(apiInfo()).select()
				.apis(RequestHandlerSelectors.basePackage(com.test.move.user.controller))  //指定暴露的AIP接口
				.paths(PathSelectors.any()).build();
		// .globalOperationParameters(pars);
	}

	private ApiInfo apiInfo() {
		return new ApiInfoBuilder().title("XXX api 文檔").description("這是XXX API 文檔的說明")  //自定義標題和說明
				.termsOfServiceUrl("http://www.XXX.com/")   //指定訪問的URL
				.contact(new Contact("xiaowang", "", "[e-mail]")).build();
	}
}

　　

 

 

 

方法描述： 在方法上加上 @ApiOperation

    @ApiOperation(value="這是一個上傳excel的方法")
    @PostMapping("/uploadExcel")
    public CommonResponse uploadOrderExcel(@RequestParam("ePlusExcel") MultipartFile ePlusExcel,
            ) 

 效果：

 

 參數描述：1. 參數是  包裝類 或者模型 如PartDO 　 在屬性上加 @ApiModelProperty(value="")

@ApiModelProperty(value="part 的 描述") private String partDesc;

 參數描述：2. 參數是  普通類型 如String  name 　 在屬性上加@ApiParam(value="")

@GetMapping("/queryInventory")
        public CommonResponse queryInventory(@ApiParam(value="客戶編碼")String customerCode) {

效果：

 

 

 

 

 

 

 查看： http://localhost:9999/swagger-ui.html