博客
关于我
强烈建议你试试无所不能的chatGPT,快点击我
ApiBoot - ApiBoot Swagger 使用文档
阅读量:5864 次
发布时间:2019-06-19

本文共 1776 字,大约阅读时间需要 5 分钟。

ApiBoot是一款基于SpringBoot1.x,2.x的接口服务集成基础框架, 内部提供了框架的封装集成、使用扩展、自动化完成配置,让接口开发者可以选着性完成开箱即用, 不再为搭建接口框架而犯愁,从而极大的提高开发效率。

ApiBoot通过整合Swagger2完成自动化接口文档生成,只需要一个简单的注解我们就可以实现文档的开启,而且文档上面的所有元素都可以自定义配置,通过下面的介绍来详细了解ApiBoot Swagger的简易之处。

引入ApiBoot Swagger

pom.xml配置文件内通过添加如下依赖进行集成:

org.minbox.framework
api-boot-starter-swagger

注意:ApiBoot所提供的依赖都不需要添加版本号,但是需要添加版本依赖,具体查看

@EnableApiBootSwagger

在添加依赖后需要通过@EnableApiBootSwagger注解进行开启ApiBoot Swagger相关的配置信息自动化构建,可以配置在XxxApplication入口类上,也可以是配置类,让SpringBoot加载到即可。

相关配置

配置参数 参数介绍 默认值
api.boot.swagger.enable 是否启用 true
api.boot.swagger.title 文档标题 ApiBoot快速集成Swagger文档
api.boot.swagger.description 文档描述 ApiBoot通过自动化配置快速集成Swagger2文档,仅需一个注解、一个依赖即可。
api.boot.swagger.base-package 文档扫描的package XxxApplication同级以及子级package
api.boot.swagger.version 文档版本号 api.boot.version
api.boot.swagger.license 文档版权 ApiBoot
api.boot.swagger.license-url 文档版权地址
api.boot.swagger.contact.name 文档编写人名称 恒宇少年
api.boot.swagger.contact.website 文档编写人主页
api.boot.swagger.contact.email 文档编写人邮箱地址 jnyuqy@gmail.com
api.boot.swagger.authorization.name 整合Oauth2后授权名称 ApiBoot Security Oauth 认证头信息
api.boot.swagger.authorization.key-name 整合Oauth2后授权Header内的key-name Authorization
api.boot.swagger.authorization.auth-regex 整合Oauth2后授权表达式 ^.*$

以上是目前版本的所有配置参数,大多数都存在默认值,可自行修改。

整合ApiBoot Security Oauth

如果你的项目添加了Oauth2资源保护,在Swagger界面上访问接口时需要设置AccessTokenHeader才可以完成接口的访问,ApiBoot Security Oauth默认开放Swagger所有相关路径,如果项目内并非通过ApiBoot Security Oauth2来做安全认证以及资源保护,需要自行开放Swagger相关路径。

整合ApiBoot Security Oauth很简单,访问 查看。

携带Token访问Api

启动添加ApiBoot-Swagger依赖的项目后,访问页面查看Swagger所生成的全部文档,页面右侧可以看到Authorize,点击后打开配置AccessToken的界面,配置的AccessToken必须携带类型,如:Bearer 0798e1c7-64f4-4a2f-aad1-8c616c5aa85b

注意:通过ApiBoot Security Oauth所获取的AccessToken类型都为Bearer

本章源码地址:

ApiBoot 开源交流群

转载地址:http://agynx.baihongyu.com/

你可能感兴趣的文章
如何手动删除Windows资源管理器地址栏的历史记录
查看>>
洞察先机 创新体验 -联想企业级及移动互联解决方案全国巡展火热进行中
查看>>
启迪国信:移动警务解决方案推动警务无人机安全管控
查看>>
中国人工智能学会通讯——意识科学研究进展 1.3 意识的量子不确定性分析
查看>>
管理员权限的凭证安全漏洞
查看>>
WiFi黑科技? 麻省理工用WiFi穿墙认人
查看>>
虚拟主机管理公司cPanel被黑 用户数据泄露
查看>>
灾难|有多少创业公司正依据虚荣数据分析
查看>>
苹果公司K.O.美国司法部,不提供后门
查看>>
集群调度框架的架构演进之路
查看>>
网络安全 | 教你三招,远离WannaCry
查看>>
集装箱式数据中心:购买或租赁?
查看>>
WannaCry勒索蠕虫下的工控安全预警
查看>>
“大帐篷”模式是如何改变OpenStack的?
查看>>
云服务器 ECS 镜像迁移:应用迁云之镜像迁移-(4)迁移流程和实践方法
查看>>
【商汤科技23篇论文横扫CVPR】林达华教授重磅揭秘冠军论文
查看>>
黑客公布无数种攻击 Windows 的方法,对我们有什么影响
查看>>
加拿大警方是怎样获得黑莓加密秘钥的?
查看>>
《Android和PHP开发最佳实践》一2.9 Android动画效果
查看>>
IBM与宝马构建云端合作 接入沃森物联网
查看>>