前言

之前跟大家分享了Spring MVC集成springfox-swagger2构建restful API，简单写了如何在springmvc中集成swagger2。这边记录下在springboot中如何集成swagger2。其实使用基本相同。

方法如下：

首先还是引用相关jar包。我使用的maven，在pom.xml中引用相关依赖(原来我使用的是2.2.0的，现在使用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>

第二步就是创建swagger的配置类：

这个配置类和springmvc的写法完全一致。为了区分我又重命名一个。

package com.xingguo.springboot;

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 Swagger2Configuration {

 @Bean
 public Docket buildDocket(){
  return new Docket(DocumentationType.SWAGGER_2)
    .apiInfo(buildApiInf())
    .select()
    .apis(RequestHandlerSelectors.basePackage("com.xingguo.springboot.controller"))
    .paths(PathSelectors.any())
    .build();
 }

 private ApiInfo buildApiInf(){
  return new ApiInfoBuilder()
     .title("xingguo大标题")
     .description("springboot swagger2")
     .termsOfServiceUrl("http://blog.csdn.net/u014231523网址链接")
     .contact(new Contact("diaoxingguo", "http://blog.csdn.net/u014231523", "diaoxingguo@163.com"))
     .build();

 }

}

在原来2.2.0的版本中使用new ApiInfo()的方法已经过时，使用new ApiInfoBuilder()进行构造，需要什么参数就添加什么参数。当然也可以什么都添加。如：

private ApiInfo buildApiInfo(){
 return new ApiInfoBuilder().build();
}

那么页面显示的效果如图：

使用new ApiInfoBuilder().build()；

添加属性：

点击ApiInfoBuilder.Java的源码可以看到相关方法使用。

第三步就是在自己的controller添加相关的注解：

原来使用在类上使用@controller，现在可以使用@RestController，然后方法的@ResponseBody就可以不用写了，因为@RestController的注解接口上已经添加了，要求版本在4.0.1之后。

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Controller
@ResponseBody
public @interface RestController {

 /**
  * The value may indicate a suggestion for a logical component name,
  * to be turned into a Spring bean in case of an autodetected component.
  * @return the suggested component name, if any
  * @since 4.0.1
  */
 String value() default "";

}

常用的注解如下：

      - @Api()用于类名

      - @ApiOperation()用于方法名

      - @ApiParam()用于参数说明

      - @ApiModel()用于实体类

      - @ApiModelProperty用于实体类属性

更加详细的含义可以参考官方说明wiki

下面会用代码和示例图说明。

第四部就是在启动项目在浏览器上输入url:

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

我在application.properties中设置的自己的端口号为9090(如果不设置，默认为8080)

server.port=9090

所以我的url是：http://localhost:9090/swagger-ui.html

如图：

这里会把相应包下的所有controller按类进行显示。

我们看下其中一个类UserController.java,（请忽略业务逻辑，只看注解）

package com.xingguo.springboot.controller;

import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import io.swagger.annotations.ApiParam;

import javax.annotation.Resource;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.bind.annotation.RestController;

import com.xingguo.springboot.model.User;
import com.xingguo.springboot.service.UserService;

/**
 * Created by diaoxingguo on 2016/10/24.
 */
@Api(value="用户controller",description="用户操作",tags={"用户操作接口"})
@RestController
public class UserController {

 @Resource
 private UserService userService;

 @ApiOperation("获取用户信息")
 @GetMapping("/getUserInfo")
 public User getUserInfo(@ApiParam(name="id",value="用户id",required=true) Long id,@ApiParam(name="username",value="用户名") String username) {
  User user = userService.getUserInfo();
  return user;
 }


 @ApiOperation("更改用户信息")
 @PostMapping("/updateUserInfo")
 public int updateUserInfo(@RequestBody @ApiParam(name="用户对象",value="传入json格式",required=true) User user){
  int num = userService.updateUserInfo(user);
  return num;
 }

 @ApiOperation("添加用户信息")
 @PostMapping("/saveUser")
 public String saveUser(@RequestBody @ApiParam(name="user",value="json fromat",required=true) User user) {
  userService.saveUser(user);
  return "success";
 }
}

这里说明下，在使用对象作为参数时，可以在对象上添加相应的注解，用户页面显示。

如：

package com.xingguo.springboot.model;

import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;

import java.util.List;

/**
 * Created by diaoxingguo on 2016/10/24.
 */
@ApiModel(description="用户对象user")
public class User {
 @ApiModelProperty(value="用户名",name="username")
 private String username;
 @ApiModelProperty(value="状态",name="state",required=true)
 private Integer state;
 private String password;
 private String nickName;
 private Integer isDeleted;

 private String[] ids;
 private List<String> idList;

 public String getUsername() {
  return username;
 }

 public void setUsername(String username) {
  this.username = username;
 }

 public Integer getState() {
  return state;
 }

 public void setState(Integer state) {
  this.state = state;
 }

 public String getPassword() {
  return password;
 }

 public void setPassword(String password) {
  this.password = password;
 }

 public String[] getIds() {
  return ids;
 }

 public void setIds(String[] ids) {
  this.ids = ids;
 }

 public List<String> getIdList() {
  return idList;
 }

 public void setIdList(List<String> idList) {
  this.idList = idList;
 }

 public String getNickName() {
  return nickName;
 }

 public void setNickName(String nickName) {
  this.nickName = nickName;
 }

 public Integer getIsDeleted() {
  return isDeleted;
 }

 public void setIsDeleted(Integer isDeleted) {
  this.isDeleted = isDeleted;
 }


}

显示的效果如图：

看上图红框的部分，其中一个是json格式的点击就可以获取参数格式。

第二张中可以看到字段相应的注释和是否必填。

如果在字段上添加注释@ApiModelProperty(required=true)就是必填（默认是false），相应的页面optional标识也会消失，标识这个字段必填。

点击下面的try it out按钮就可以进行调试。

在使用单个参数时，如上面代码中的getUserInfo（）方法，对应的效果图如下：

这里如果是添加required=true， @ApiParam(required=true)则会在页面上显示required的标识。同样默认为false。

其他的使用方式可以自己动手试试。

总结

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

# swagger  # spring  # boot  # springfox  # swagger2  # Spring MVC集成springfox-swagger2构建restful API的方法详解  # Springboot整合Swagger2和Swagger3全过程  # SpringBoot Swagger2 接口规范示例详解  # Springboot整合Swagger2后访问swagger-ui.html 404报错问  # 解决springboot接入springfox-swagger2遇到的一些问题  # 自己的  # 如图  # 必填  # 就可以  # 可以看到  # 写了  # 其中一个  # 默认为  # 的是  # 我在  # 就是在  # 也会  # 如有  # 其他的  # 我又  # 也可  # 实体类  # 可以使用  # 会把  # 这篇文章 

相关栏目： 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571 】

相关推荐： Laravel怎么集成Vue.js_Laravel Mix配置Vue开发环境  js代码实现下拉菜单【推荐】  Laravel怎么导出Excel文件_Laravel Excel插件使用教程  如何快速重置建站主机并恢复默认配置？  网站优化排名时，需要考虑哪些问题呢？  怎么制作网站设计模板图片,有电商商品详情页面的免费模板素材网站推荐吗？  Laravel怎么生成二维码图片_Laravel集成Simple-QrCode扩展包与参数设置【实战】  如何在Windows 2008云服务器安全搭建网站？  如何快速生成凡客建站的专业级图册？  MySQL查询结果复制到新表的方法(更新、插入)  PHP正则匹配日期和时间(时间戳转换)的实例代码  弹幕视频网站制作教程下载,弹幕视频网站是什么意思？  如何在搬瓦工VPS快速搭建网站？  Laravel如何理解并使用服务容器（Service Container）_Laravel依赖注入与容器绑定说明  夸克浏览器网页跳转延迟怎么办 夸克浏览器跳转优化  Laravel如何生成URL和重定向？（路由助手函数）  laravel怎么在请求结束后执行任务（Terminable Middleware）_laravel Terminable Middleware请求结束任务执行方法  深圳网站制作培训,深圳哪些招聘网站比较好？  HTML5建模怎么导出为FBX格式_FBX格式兼容性及导出步骤【指南】  Laravel路由Route怎么设置_Laravel基础路由定义与参数传递规则【详解】  高防服务器租用首荐平台，企业级优惠套餐快速部署  如何在不使用负向后查找的情况下匹配特定条件前的换行符  香港代理服务器配置指南：高匿IP选择、跨境加速与SEO优化技巧  Laravel项目怎么部署到Linux_Laravel Nginx配置详解  bootstrap日历插件datetimepicker使用方法  Laravel怎么多语言本地化设置_Laravel语言包翻译与Locale动态切换【手册】  ChatGPT怎么生成Excel公式_ChatGPT公式生成方法【指南】  头像制作网站在线观看,除了站酷，还有哪些比较好的设计网站？  北京网站制作公司哪家好一点,北京租房网站有哪些？  ,交易猫的商品怎么发布到网站上去？  html5怎么画眼睛_HT5用Canvas或SVG画眼球瞳孔加JS控制动态【绘制】  深圳网站制作公司好吗,在深圳找工作哪个网站最好啊？  Laravel如何使用.env文件管理环境变量？（最佳实践）  Java遍历集合的三种方式  Laravel如何实现邮箱地址验证功能_Laravel邮件验证流程与配置  手机钓鱼网站怎么制作视频,怎样拦截钓鱼网站。怎么办？  bing浏览器学术搜索入口_bing学术文献检索地址  移动端手机网站制作软件,掌上时代，移动端网站的谷歌SEO该如何做？  jquery插件bootstrapValidator表单验证详解  高防服务器如何保障网站安全无虞？  zabbix利用python脚本发送报警邮件的方法  Python数据仓库与ETL构建实战_Airflow调度流程详解  音响网站制作视频教程,隆霸音响官方网站？  高配服务器限时抢购：企业级配置与回收服务一站式优惠方案  Laravel怎么进行数据库事务处理_Laravel DB Facade事务操作确保数据一致性  Laravel怎么做缓存_Laravel Cache系统提升应用速度的策略与技巧  Laravel如何为API生成Swagger或OpenAPI文档  Laravel如何实现数据导出到PDF_Laravel使用snappy生成网页快照PDF【方案】  js实现点击每个li节点，都弹出其文本值及修改  Linux系统命令中screen命令详解