Spring MVC集成springfox-swagger2构建restful API的方法详解

前言

在集成springfox-swagger2之前，我也尝试着集成了swagger-springmvc，方式差不多，但是swagger-springmvc相对麻烦一点，因为要把它的静态文件copy到自己的项目中。所以还是用新版本的。

至于两者有什么不同，为什么进行版本变更请参见

方法如下

这里先写下需要的pom.xml配置（我引用的2.4.0，相对稳定）

<dependency> 
 <groupid>io.springfox</groupid> 
 <artifactid>springfox-swagger2</artifactid> 
 <version>2.4.0</version> 
 </dependency> 
 <dependency> 
 <groupid>io.springfox</groupid> 
 <artifactid>springfox-swagger-ui</artifactid> 
 <version>2.4.0</version> 
 </dependency> 

还需要在spring-mvc.xml中添加映射静态的配置：

<mvc:default-servlet-handler />

然后就是swagger2的配置类：

package com.xingguo.logistics.swagger;

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.service.contact;
import springfox.documentation.spi.documentationtype;
import springfox.documentation.spring.web.plugins.docket;
import springfox.documentation.swagger2.annotations.enableswagger2;

@configuration
@enableswagger2
public class swaggerconfig {

 @bean
 public docket builddocket(){
 return new docket(documentationtype.swagger_2)
  .apiinfo(buildapiinf())
  .select() .apis(requesthandlerselectors.basepackage("com.xingguo.logistics.controller"))//controller路径
  .paths(pathselectors.any())
  .build();
 }

 private apiinfo buildapiinf(){
 return new apiinfobuilder()
  .title("xingguo大标题")
  .termsofserviceurl("http://blog.csdn.net/u014231523网址链接")
  .description("springmvc swagger2")
  .contact(new contact("diaoxingguo", "http://blog.csdn.net/u014231523", "[e-mail]"))
  .build();

 }
}

然后运行项目，输入自己的url。

http://{ip}:{port}/{projectname}/swagger-ui.html#/

我的url:

http://localhost:8989/logistics/swagger-ui.html#/

然后就可以看到效果图：

它会把按照controller,把所有的接口都加载进来。

我的目录结构如图：

然后，就是接口名称和参数的说明：

常用注解：

      - @api()用于类名

      - @apioperation()用于方法名

      - @apiparam()用于参数说明

      - @apimodel()用于实体类

      - @apimodelproperty用于实体类属性

更详细的说明请参见官方注解说明文档

使用方法如图：

@controller
//类上使用@api
@api(value="用户controller",description="用户相关操作")
public class usercontroller {

 @requestmapping(value="index",method=requestmethod.post)
 //方法上使用@apioperation
 @apioperation(value="首页",notes="跳转到首页")
 //参数使用@apiparam
 public object getindex(@apiparam(name="topic实体",value="json格式",required=true) @requestbody topic topic){
 //业务内容，被我删除了，请忽略，主要看上面的注解
 object obj = new object();
 return obj;
 }
}

//一般添加个@apimodel（）就可以，看情况使用里面的属性
@apimodel(value="topic", discriminator = "foo", subtypes = {topic.class})
public class topic{

}

效果图如下：

我在springboot中也集成了swagger2，集成方式基本相同，使用方式也基本一样。请参考spring boot集成springfox-swagger2构建restful api的方法教程

总结

以上就是这篇文章的全部内容了，希望本文的内容对大家的学习或者工作能带来一定的帮助，如有疑问大家可以留言交流，谢谢大家对的支持。