SpringBoot+Swagger_UI怎么配置

本篇內容主要講解“Spring Boot+Swagger_UI怎么配置”，感興趣的朋友不妨來看看。本文介紹的方法操作簡單快捷，實用性強。下面就讓小編來帶大家學習“Spring Boot+Swagger_UI怎么配置”吧!

在東豐等地區，都構建了全面的區域性戰略布局，加強發展的系統性、市場前瞻性、產品創新能力，以專注、極致的服務理念，為客戶提供成都網站建設、網站設計網站設計制作按需設計網站,公司網站建設,企業網站建設,成都品牌網站建設,全網營銷推廣,外貿網站制作,東豐網站建設費用合理。

一：pom.xml 依賴

		<dependency>
			<groupId>io.springfox</groupId>
			<artifactId>springfox-swagger2</artifactId>
			<version>2.8.0</version>
		</dependency>
		<dependency>
			<groupId>io.springfox</groupId>
			<artifactId>springfox-swagger-ui</artifactId>
			<version>2.8.0</version>
		</dependency>

二：application.yaml 開關配置

# swagger
swagger: 
  switch: true

三：SwaggerConfig.java 配置

@Configuration
@EnableSwagger2
public class SwaggerConfig {
	@Value("${swagger.switch}")
	private boolean swaggerSwitch;
	@Bean
	public Docket createRestApi() {
		Docket docket = new Docket(DocumentationType.SWAGGER_2);
		if (swaggerSwitch) {
			docket.enable(true);
		} else {
			docket.enable(false);
		}
		docket.apiInfo(apiInfo()).select()
				// 加了ApiOperation注解的類，才生成接口文檔
				.apis(RequestHandlerSelectors.withMethodAnnotation(ApiOperation.class))
				// 包下的類，才生成接口文檔
				.paths(PathSelectors.any()).build().securitySchemes(security());
		return docket;
	}
	private ApiInfo apiInfo() {
		return new ApiInfoBuilder().title("Demo").description("接口文檔").termsOfServiceUrl("").version("0.1").build();
	}
	private List<ApiKey> security() {
		return newArrayList(new ApiKey("token", "token", "header"));
	}
}

四：接口配置代碼示例

/**
	  * @Title: list
	  * @Description: 測試
	  * @return void    返回類型
	  * @throws
	  */
	@ApiOperation(value="消息列表查詢",notes="消息列表查詢")
	@ApiImplicitParams({@ApiImplicitParam(name="userId",value="用戶ID",required=true,dataType="int")})
	@ApiResponses(value= {@ApiResponse(code = 200,message="Sucess",response=MsgPushInfoEntity.class,responseContainer="List")})
	@RequestMapping(value="/list",method=RequestMethod.POST)
	public List<MsgPushInfoEntity> list(@RequestBody MsgPushInfoEntity msg) {
		logger.info("===========" + msgPushInfoService.list().size() + "===========");
		logger.error("===========" + msgPushInfoService.list().size() + "===========");
		return  new ArrayList<MsgPushInfoEntity>();
	}

五：swagger-ui展示

Spring Boot+Swagger_UI怎么配置

六：Swagger注解說明

1.@Api

該注解將一個Controller（Class）標注為一個swagger資源（API）。在默認情況下，Swagger-Core只會掃描解析具有

@Api注解的類，而會自動忽略其他類別資源（JAX-RS endpoints，Servlets等等）的注解。該注解包含以下幾個重要屬性：

中文字幕第五页-中文字幕第页-中文字幕韩国-中文字幕最新-国产尤物二区三区在线观看-国产尤物福利视频一区二区

SpringBoot+Swagger_UI怎么配置