這篇文章主要介紹“springboot集成swagger的步驟是什么”，在日常操作中，相信很多人在springboot集成swagger的步驟是什么問(wèn)題上存在疑惑，小編查閱了各式資料，整理出簡(jiǎn)單好用的操作方法，希望對(duì)大家解答”springboot集成swagger的步驟是什么”的疑惑有所幫助！接下來(lái)，請(qǐng)跟著小編一起來(lái)學(xué)習(xí)吧！

成都創(chuàng)新互聯(lián)是網(wǎng)站建設(shè)技術(shù)企業(yè)，為成都企業(yè)提供專業(yè)的網(wǎng)站建設(shè)、做網(wǎng)站，網(wǎng)站設(shè)計(jì)，網(wǎng)站制作，網(wǎng)站改版等技術(shù)服務(wù)。擁有十余年豐富建站經(jīng)驗(yàn)和眾多成功案例，為您定制適合企業(yè)的網(wǎng)站。十余年品質(zhì)，值得信賴！

    第一步：maven導(dǎo)入Swagger如下：

 
     io.springfox
     springfox-swagger2
     2.2.2



    io.springfox
    springfox-swagger-ui
    2.2.2

第二步：創(chuàng)建Swagger2配置類，如下所示：

/**
*
*/
package swagger.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

/**
* @author ignore1992
*
*/
@Configuration
@EnableSwagger2
public class SwaggerConfig
{
	@Bean
	public Docket createDocket()
	{
		return new Docket(DocumentationType.SWAGGER_2)
		.apiInfo(createApiInfo())
		.select()
		.apis(RequestHandlerSelectors.basePackage("swagger.api.controller"))
		.paths(PathSelectors.any())
		.build();
	}

	private ApiInfo createApiInfo()
	{
		return new ApiInfoBuilder()
		.title("springboot使用swagger2")
		.description("生成對(duì)應(yīng)接口文檔")
		.termsOfServiceUrl("https://blog.csdn.net/ignorewho")
		.contact("ignore1992")
		.version("1.0")
		.build();
	}
}

第三步：這樣就可以使用swagger提供的注解，來(lái)完成描述，調(diào)用，生成等功能

常用注解如下：

@Api : 用在類上，說(shuō)明該類的主要作用。

@ApiOperation：用在方法上，給API增加方法說(shuō)明。

@ApiImplicitParams : 用在方法上，包含一組參數(shù)說(shuō)明。

@ApiImplicitParam：用來(lái)注解來(lái)給方法入?yún)⒃黾诱f(shuō)明。

使用案例如下：

/**
*
*/
package swagger.api.controller;

import io.swagger.annotations.ApiOperation;

import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RestController;

/**
* @author ignore1992
*
*/
@RestController
@RequestMapping(value = "/swaggerapi")
public class SwaggerApiController
{
	@ApiOperation(value = "測(cè)試swaggerapi接口方法")
	@RequestMapping(value = "/test", method = RequestMethod.GET)
	public String test()throws Exception
	{
		return "swaggerapi 測(cè)試";
	}
}

到此，關(guān)于“springboot集成swagger的步驟是什么”的學(xué)習(xí)就結(jié)束了，希望能夠解決大家的疑惑。理論與實(shí)踐的搭配能更好的幫助大家學(xué)習(xí)，快去試試吧！若想繼續(xù)學(xué)習(xí)更多相關(guān)知識(shí)，請(qǐng)繼續(xù)關(guān)注創(chuàng)新互聯(lián)網(wǎng)站，小編會(huì)繼續(xù)努力為大家?guī)?lái)更多實(shí)用的文章！