iis服务器助手广告广告
返回顶部
首页 > 资讯 > 精选 >SpringBoot项目集成Swagger和swagger-bootstrap-ui及常用注解有哪些
  • 120
分享到

SpringBoot项目集成Swagger和swagger-bootstrap-ui及常用注解有哪些

2023-07-05 20:07:30 120人浏览 安东尼
摘要

本篇内容介绍了“SpringBoot项目集成swagger和swagger-bootstrap-ui及常用注解有哪些”的有关知识,在实际案例的操作过程中,不少人都会遇到这样的困境,接下来就让小编带领大家学习一下如何处理这些情况吧!希望大家仔

本篇内容介绍了“SpringBoot项目集成swagger和swagger-bootstrap-ui及常用注解有哪些”的有关知识,在实际案例的操作过程中,不少人都会遇到这样的困境,接下来就让小编带领大家学习一下如何处理这些情况吧!希望大家仔细阅读,能够学有所成!

    一、前言

    随着互联网项目前后端分离方式的流行,前端与后端交给不同的人员开发,项目沟通成本也随之提高。

    主要表现在webapi接口的沟通,Swagger2 应运而生,它可以动态生成api接口文档,降低沟通成本,促进项目高效开发。

    下面讨论Swagger2及swagger-bootstrap-ui在springBoot上的集成

    二、SpringBoot项目集成swagger

    1. 引入依赖

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

    2. 编写配置文件

    可对照进行相应的修改

    @Configuration@EnableSwagger2@EnableSwaggerBootstrapUI@Profile({"dev","test"})public class Swagger2Config {    @Bean    public Docket createRestApi() {        return new Docket(DocumentationType.SWAGGER_2)                .groupName("") //指定分组,对应(/v2/api-docs?group=)                .pathMapping("") //base地址,最终会拼接Controller中的地址                .apiInfo(apiInfo())                .select()                //为当前包路径// .apis(RequestHandlerSelectors.any())                .apis(RequestHandlerSelectors.basePackage("com.riskeys.sd.custom"))                .paths(PathSelectors.any())                .build();    }    //构建 api文档的详细信息函数    private ApiInfo apiInfo() {        return new ApiInfoBuilder()                //页面标题                .title("XXX API对接文档")                .description("XX API对接文档") //描述                //创建人                .contact(new Contact("yuhei001", "https://blog.csdn.net/Yuhei0", "18616591658@163.com"))                //版本号                .version("1.0")                //描述                .description("API 描述")                .build();    }}

    3. 启动访问页面

    Http://127.0.0.1:10086/swagger-ui.html

    SpringBoot项目集成Swagger和swagger-bootstrap-ui及常用注解有哪些

    三、SpringBoot项目集成swagger-bootstrap-ui

    在步骤二的基础上进行如下操作

    1.引入依赖

            <dependency>            <groupId>com.GitHub.xiaoymin</groupId>            <artifactId>swagger-bootstrap-ui</artifactId>            <version>1.9.6</version>        </dependency>

    2.配置资源处理规则

    未配置的情况下,有可能访问报error.9996。

    实现WEBmvcConfigurer接口,或者WebMvcConfigurationSupport(老版的SpringBoot),实现addResourceHandlers方法,加上如下所示代码即可。

    @Configurationpublic class AppWebConfig extends WebMvcConfigurationSupport{    @Override    public void addResourceHandlers(ResourceHandlerReGIStry registry) {        registry.addResourceHandler("/swagger-ui.html").addResourceLocations("classpath:/META-INF/resources/");        // 解决 doc.html 404 报错        registry.addResourceHandler("/doc.html").addResourceLocations("classpath:/META-INF/resources/");        registry.addResourceHandler("/webjars/**").addResourceLocations("classpath:/META-INF/resources/webjars/");    }}

    或者

    @Configurationpublic class AppWebConfig extends WebMvcConfigurationSupport{    @Override    public void addResourceHandlers(ResourceHandlerRegistry registry) {        registry.addResourceHandler("/swagger-ui.html").addResourceLocations("classpath:/META-INF/resources/");        // 解决 doc.html 404 报错        registry.addResourceHandler("doc.html").addResourceLocations("classpath*:/META-INF/resources/");        registry.addResourceHandler("/webjars/**").addResourceLocations("classpath*:/META-INF/resources/webjars/");    }}

    另外,也可以在启动类上进行实现重写

    @SpringBootApplicationpublic class XXXApplication  implements WebMvcConfigurer{    @Override    public void addResourceHandlers(ResourceHandlerRegistry registry) {        registry.addResourceHandler("doc.html").addResourceLocations("classpath*:/META-INF/resources/");        registry.addResourceHandler("/webjars/**").addResourceLocations("classpath*:/META-INF/resources/webjars/");    }}

    3.启动访问页面

    访问http://127.0.0.1:10086/doc.html,相较swagger-ui.html来说,此文档更为清爽。

    SpringBoot项目集成Swagger和swagger-bootstrap-ui及常用注解有哪些

    四、Swagger常用注解介绍

    swagger通过注解生成接口文档,包括接口名、请求方法、参数、返回信息等等。

    1.Swagger2Config中相关swagger注解

    1 @EnableSwagger2 开启Swagger

    作用于配置类或启动类

    2 @EnableSwaggerBootstrapUI 开启SwaggerBootstrapUi增强功能

    作用于配置类或启动类,如果不使用增强功能,可不开启。

    2.controller中相关swagger注解

    1 @Api:修饰整个类,描述Controller的作用

    value和tags均为说明,可用tags代替value

    @Api(value = "保险公司列表查询", tags = {"保险公司列表查询"})

    2 @ApiOperation() 用于方法;表示一个http请求的操作

    @ApiOperation(value = "信息员保存(注册)/更新", tags = {"信息員保存"}, notes = "messenger desc")

    3 @ApiParam 用于方法,参数,字段说明;表示对参数的添加元数据(说明或是否必填等)

    适用于单个参数

    @ApiParam(name="sdMessengerInfo",value="参数描述",required=true)

    4 请求参数注解,可进行组合

    • @ApiImplicitParams 用于方法,包含多个 @ApiImplicitParam

    • @ApiImplicitParam 用于方法,表示单独的请求参数

    适用于对多个参数进行描述

    示例:

    // 组合使用@ApiImplicitParams ({    @ApiImplicitParam(name = "id", value = "参数中文描述", required = true)})// 单独使用@ApiImplicitParam(paramType="query", name="id", dataType="String", required=true, value="参数描述")

    注意,当同时存在@ApiParam和@ApiImplicitParam时,以@ApiImplicitParam的描述为准。

    5 @ApiIgnore() 用于类或者方法上,可以不被swagger显示在页面上 ,使用较少。

    6 响应配置

    • @ApiResponses

    • @ApiResponse

    // 单独配置@ApiResponse(code = 400, message = "Invalid user supplied")// 组合使用@ApiResponses({ @ApiResponse(code = 400, message = "Invalid Order") })

    7 @ResponseHeader 响应头设置

    @ResponseHeader(name="head1",description="response head conf")

    3.Model中相关swagger注解

    1 @ApiModel 用于类 ;表示对类进行说明,用于参数用实体类接收。

    @ApiModel(value = "demo", description = "对象描述")

    一般value和desc可以省略不写

    2 @ApiModelProperty 用于方法,字段; 表示对model属性的说明或者数据操作更改

    @ApiModelProperty(value = "用户id",name = "openid2",dataType = "String", required = true, hidden = true)
    • value&ndash;字段说明

    • name&ndash;重写属性名字

    • dataType&ndash;重写属性类型

    • required&ndash;是否必填

    • example&ndash;举例说明

    • hidden&ndash;隐藏

    一般只对value,required进行标示。

    “SpringBoot项目集成Swagger和swagger-bootstrap-ui及常用注解有哪些”的内容就介绍到这里了,感谢大家的阅读。如果想了解更多行业相关的知识可以关注编程网网站,小编将为大家输出更多高质量的实用文章!

    --结束END--

    本文标题: SpringBoot项目集成Swagger和swagger-bootstrap-ui及常用注解有哪些

    本文链接: https://www.lsjlt.com/news/354916.html(转载时请注明来源链接)

    有问题或投稿请发送至: 邮箱/279061341@qq.com    QQ/279061341

    本篇文章演示代码以及资料文档资料下载

    下载Word文档到电脑,方便收藏和打印~

    下载Word文档
    猜你喜欢
    • C++ 生态系统中流行库和框架的贡献指南
      作为 c++++ 开发人员,通过遵循以下步骤即可为流行库和框架做出贡献:选择一个项目并熟悉其代码库。在 issue 跟踪器中寻找适合初学者的问题。创建一个新分支,实现修复并添加测试。提交...
      99+
      2024-05-15
      框架 c++ 流行库 git
    • C++ 生态系统中流行库和框架的社区支持情况
      c++++生态系统中流行库和框架的社区支持情况:boost:活跃的社区提供广泛的文档、教程和讨论区,确保持续的维护和更新。qt:庞大的社区提供丰富的文档、示例和论坛,积极参与开发和维护。...
      99+
      2024-05-15
      生态系统 社区支持 c++ overflow 标准库
    • c++中if elseif使用规则
      c++ 中 if-else if 语句的使用规则为:语法:if (条件1) { // 执行代码块 1} else if (条件 2) { // 执行代码块 2}// ...else ...
      99+
      2024-05-15
      c++
    • c++中的继承怎么写
      继承是一种允许类从现有类派生并访问其成员的强大机制。在 c++ 中,继承类型包括:单继承:一个子类从一个基类继承。多继承:一个子类从多个基类继承。层次继承:多个子类从同一个基类继承。多层...
      99+
      2024-05-15
      c++
    • c++中如何使用类和对象掌握目标
      在 c++ 中创建类和对象:使用 class 关键字定义类,包含数据成员和方法。使用对象名称和类名称创建对象。访问权限包括:公有、受保护和私有。数据成员是类的变量,每个对象拥有自己的副本...
      99+
      2024-05-15
      c++
    • c++中优先级是什么意思
      c++ 中的优先级规则:优先级高的操作符先执行,相同优先级的从左到右执行,括号可改变执行顺序。操作符优先级表包含从最高到最低的优先级列表,其中赋值运算符具有最低优先级。通过了解优先级,可...
      99+
      2024-05-15
      c++
    • c++中a+是什么意思
      c++ 中的 a+ 运算符表示自增运算符,用于将变量递增 1 并将结果存储在同一变量中。语法为 a++,用法包括循环和计数器。它可与后置递增运算符 ++a 交换使用,后者在表达式求值后递...
      99+
      2024-05-15
      c++
    • c++中a.b什么意思
      c++kquote>“a.b”表示对象“a”的成员“b”,用于访问对象成员,可用“对象名.成员名”的语法。它还可以用于访问嵌套成员,如“对象名.嵌套成员名.成员名”的语法。 c++...
      99+
      2024-05-15
      c++
    • C++ 并发编程库的优缺点
      c++++ 提供了多种并发编程库,满足不同场景下的需求。线程库 (std::thread) 易于使用但开销大;异步库 (std::async) 可异步执行任务,但 api 复杂;协程库 ...
      99+
      2024-05-15
      c++ 并发编程
    • 如何在 Golang 中备份数据库?
      在 golang 中备份数据库对于保护数据至关重要。可以使用标准库中的 database/sql 包,或第三方包如 github.com/go-sql-driver/mysql。具体步骤...
      99+
      2024-05-15
      golang 数据库备份 mysql git 标准库
    软考高级职称资格查询
    编程网,编程工程师的家园,是目前国内优秀的开源技术社区之一,形成了由开源软件库、代码分享、资讯、协作翻译、讨论区和博客等几大频道内容,为IT开发者提供了一个发现、使用、并交流开源技术的平台。
    • 官方手机版

    • 微信公众号

    • 商务合作