springboot集成swagger的步骤是什么-成都创新互联网站建设

关于创新互联

多方位宣传企业产品与服务 突出企业形象

公司简介 公司的服务 荣誉资质 新闻动态 联系我们

springboot集成swagger的步骤是什么

这篇文章主要介绍“springboot集成swagger的步骤是什么”,在日常操作中,相信很多人在springboot集成swagger的步骤是什么问题上存在疑惑,小编查阅了各式资料,整理出简单好用的操作方法,希望对大家解答”springboot集成swagger的步骤是什么”的疑惑有所帮助!接下来,请跟着小编一起来学习吧!

成都创新互联是网站建设技术企业,为成都企业提供专业的网站建设、做网站,网站设计,网站制作,网站改版等技术服务。拥有十余年丰富建站经验和众多成功案例,为您定制适合企业的网站。十余年品质,值得信赖!

    第一步:maven导入Swagger如下:

    

 
     io.springfox
     springfox-swagger2
     2.2.2



    io.springfox
    springfox-swagger-ui
    2.2.2

第二步:创建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("生成对应接口文档")
.termsOfServiceUrl("https://blog.csdn.net/ignorewho")
.contact("ignore1992")
.version("1.0")
.build();
}
}

第三步:这样就可以使用swagger提供的注解,来完成描述,调用,生成等功能

常用注解如下:

@Api : 用在类上,说明该类的主要作用。

@ApiOperation:用在方法上,给API增加方法说明。

@ApiImplicitParams : 用在方法上,包含一组参数说明。

@ApiImplicitParam:用来注解来给方法入参增加说明。

使用案例如下:

/**
*
*/
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 = "测试swaggerapi接口方法")
@RequestMapping(value = "/test", method = RequestMethod.GET)
public String test()throws Exception
{
return "swaggerapi 测试";
}
}

到此,关于“springboot集成swagger的步骤是什么”的学习就结束了,希望能够解决大家的疑惑。理论与实践的搭配能更好的帮助大家学习,快去试试吧!若想继续学习更多相关知识,请继续关注创新互联网站,小编会继续努力为大家带来更多实用的文章!


文章标题:springboot集成swagger的步骤是什么
网页路径:http://kswsj.cn/article/pdpocc.html

其他资讯