swagger教程open api

大家好，这个小视频呢，我们聊一聊啊，在我们做家外边开发的过程中呢，需要生成这些接口猛打，那么有没有很好的解决方案呢？哎，其实是有的，早期的时候呢，我们使用的是死蛙个兔， 那么现在呢，有一个比死亡个兔呢功能更更强大的一个工具啊，它的名字叫南 fo j 啊，来 fo j 呢，是集死亡个兔和欧鹏 api 三为一体的增强解决方案， 那么他到底增强的是哪一部分内容呢？我们看一下点文档在左侧，里面有一个增强特性 啊，大家看到这一部分增强特性啊里面的啊菜单啦，其实就是这个南 fo 这啦他增强的部分，比如你可以给接口啦，添加作者啊，这个很方便啊，如果说 你和前端小伙伴啦，在对接接口的过程中啦，哎，那么前段小伙伴打开接口碰到就知道哦，原来这个是张三写的接口，那么如果说接口有问题，他直接可以联系张三就可以了， 还有给结果了哎，可以添加一个培训功能啊，这个也非常不错啊，当然了，还有就是导出离线文档 啊，你如果说有些小伙伴喜欢看这一些接口文档呢，也是可以的啊，当然了，他还支持一切文档的生成啊，他提供了五种理解啊，文档的生成方式包括马克档的方式， html， 五二的 openapi， 还有 pdf 啊这五种方式。 那么接下来呢，我们做一个快速出门，首先第一步呢，就是需要引入男人风筝的核心依赖包啊，这里面呢， 我使用的是三点零三的版本。其次呢就是啊，要配一些 nifeld 的一些基本配置啊，我来分了两部分，第一部分是 nifelj 啊，核心配置，第二部分呢是我自定义的一些配置啊，核心配置呢里面呢有有这么几个部分， 第一个呢就是认证配置啊，还有就是在生产环境中呢，是否打开这些接口问答。其实呢我们在生产环境中呢，需要屏蔽掉这个这些接口问答啊，不需要打开的啊，为了我们数据的安全性以及接口的安全性 啊，下面这个呢就是你是否要开启增强啊，这里呢一定要把它写成处啊，否则他那些增强的功能呢，不一定能够有效的去使用。 下面这个呢就是我说的啊，就是自定义的一些配置。接下来呢啊就是我们看一下，我还需要两个 配置类，一个是 life for the properties， 还有一个就是 life for the cupid racial， life for the properties 里面呢就是夺取了我自己的这些配置。那么 lead for the coverage race 啊，这个类呢就是 like for the 的核心配置类 啊，配置完成之后呢，你就可以去启动了啊，启动之后呢，打开的是这样一个界面，这时候呢需要你输入用户名和密码，我写的是矮的密，用户名密码是一二三登录啊，这个时候呢，你就可以看到啊这些借口问道。

好，我们来完善一下这个添加啊，在这里呢先把这一块关掉，然后呢找到我们这个控制器，然后呢写一个添加的，在这个地方我们看一下我们这个首页， 他呢添加是 add 的方法，看到没有 add 方法，那么我们在这呢写个 add 的方法， a d d 不需要穿参素啊， retry 一下 w 好，那么这个克林特呢也是一样，直接复制复制过来，可能有同学说，哎，这个地方我这不需要数据啊，怎么不需要数据，我们下了框，是不是好，在这里呢我们就是弯 六 bug。 第二 case 等于 rwat， 然后呢克里特点，然后呢 cos 信，这里呢有个 o snike， snike 好，然后呢我们这个地方给他添加试图 rap， 试图啊，添加好，添加 好天 添加石头。这里呢添加好之后呢我们在这个包地里面这个先给个 s 三，这里呢是显示就是学员添加学员信息， 下面呢是飞儿的赛的啊，飞儿的赛的好，这个里面呢我们给他优信， 嗯，比那个 i t 妙点比定 flam。 这里呢我们需要操作的是 iddstu 的方法，这个这个我们的控制器呢一样的是哈姆控制器 里面呢他提交的方式啊是 pos 提交 ok， 剩下的呢我们就要显示是吧显示 atm 点， vivo 就是用户， 然后呢是 a t 妙， 第二他是 boss， 他 boss 啊，这里呢就是他对应的是我们的内蒙啊， sl 大写对于那个子弹 好，我们呢就是一嗯复制粘贴 密码，密码呢，我们要用帕斯曼的，帕斯曼的呢这是 pwd 年龄，年龄这块呢 a 级， 还有呢就是我们的性别。 新棉的这里就是瑞丢八筒了啊，接着 好，后面呢给个蓝再来一个竖默认选中， 这里记着啊，爱的符号要加冒号，要不然的话显示就是文本，他会报错，这里呢是女 ok 这里呢只有一个 单选按钮能够选中。好，接下来呢就是我们的啊问题， 问题呢就是需要一个 steat 的啊，然后呢这里给个内蒙 pv i d 这里呢是否一起便利 在这呢是 opple 型啊， opple 型 里面呢一个歪六歪六呢就是这里呢是绑定 ipam 第二 k i d 显示的内容呢是艾特吗？点 qmok 还有呢一个答案， 答案接下来呢也是要呢是一个文本 啊，对应的答案的自带一个我们的提交按钮 上面一台然后呢 w 就是提交这里呢也可以叫做添加啊。 好，这就好了，接下来呢我们要写这个呃 a d d s t u 这个方法在控制器这一块把这一块呢给他靠背下来 这里呢我们要传就是一个实体对象 stos 那么同样的道理，首先呢给他，因为他要添加，添加完成之后呢要跳转到隐带实页面， 所以说呢这里需要 rengx tux x 啊，这里呢引带子 一样的这里呢也需要一个克里特对象从那边接收啊， app 里面传递接收数据完了之后呢耳位铲 克林特点 stu 这里呢 stu 呃 snk 就是添加了方法把 s 传递过来，在这呢添加他会爆错，为什么呢？来咱们看一下啊， 好添加四五六， 然后呢二十 舒淇点添加这里呢提示 q i d niro 更新是吧，这里是闹，但是呢你看到我们的显示页面最后一个 他是不是又添加出来了呀？好，所以说呢，这块怎么改呢？我们把这个呢刚才这个块先关掉，找到我们这个 oppo ip i s 啊，思维格这个 gs， 找到最下面我们的 sto 这个实体类，这块他解析啊，解析的实体类，这块我们找到这， ok， 在这是吧？好，这个地方呢我们添加一个属性，叫做欧奥福，这里呢奥福的欧要大写啊， 好，然后呢把这个给他放进去，接下来呢这个地方加个逗号，给他加上一个 no 处， 好，保存一下，保存一下之后呢，我们需要把我们这个地方添加的这个这个辅引用啊给他删掉， 删掉之后呢，在这里我们通过这个选中文件啊，之前是 uir 选中文件浏览，找到我们这个 oppo ipssvigigs。 啊，一样的，这个秘密空间 是跟之前一样完成， ok， 然后保存一下，那么我们这一块接 下来呢，找到我们这个 sus nike， 这个方法对应的呢，来看下面这是 pose 的呀，他就是添加的方法。好，我们找到这个 stex， 就是状态啊，好， 两百，给他复制一下，加个或者这里呢改成两百零一，两百零一呢，这个状态就是创建成功，因为这呢没有这个两百零一，给他手动添加一下， ok， 这就好了啊，好，我们呢重新给他运行一下， 好点，添加六六六六，然后呢以年龄十九女是吧？好，这里呢黎明， 好，添加，我们找到最后， ok， 在这，这是不是黎明是不是就出来了呀？黎明就出来了，好，这一块呢我们就添加完成了啊，添加完。

啊，大家好，我是派开元框架的作者，我叫多斯大，那么今天呢主要是来给大家分享一下，就是怎么样去搭建企业级的一个接口开放平台。 那么今天的话这次的内容呢，主要是分为六个部分，他主要是设置关于整个开放平台的一些技术产品和一些架构的设置和一些实现的一些思路。 那么他分为有六点。首先第一块我们大概会来讲一下什么是开发平台跟 oppo ai。 然后第二块我们作为一个开发者的用户来去怎么去用我们的这个开发平台。 然后第三块本身的这个平台呢，他要具备哪些产品的矩阵的能力？第四块从技术比较关心的这个角度来去看怎么去应对，应对那些比较高 引发的一个这个流量，也需要怎么去实现这个架构啊？后面的话两块呢就是在补充的内容，比如说整套的这样的一个看平台他需要什么样的一个文档数据库设置，以及他他所用到的哪些技术站， 打人测试啊，跟原代码有有哪些？好，那我们现在开始啊，呃，传递课堂，我们所说这个开放平台啊，就是指那个其实是指企业提供一些接口，开放给到外部一些客户开放者或者是下游呃，用户 去使用的一个接口的一个平台，那么它它的这个核心呢，就是这个 open a p i， 它主要核心呢就是接口，那么前面加一加一个 open， 就表 它是一个开放的一个接口。所以刚刚的话的这一块啊，我们就可以得出一个开放平台的一个主要的 一个盖帽啊，他的整个的流程呢，就是类似这样的，大家看啊，整个的这个看平台的一个流程，那么 围绕这个云平台呀，看平台的这块的话，那么在左边呢，就是企业 内幕，企业的内部，那么呢他需要有一个管理后台去管理他这些接口，然后通过这个开放平台给到外部这些开发者去登录去使用，然后再给到这些开发者一些接口的接入的能力， 让他们有能力去开发他们的一些 app 应用系统，去做一些业务的这个实现，主要他底层上都是围绕这个 api 抗接口去做一个就是分配啊，调用编程跟一个对接的， 这是一个看平台啊，那我们可以去举一些例子，让大家可以更加具象的去了解什么叫开放平台呀？那比如说我们要去接支付，对不对？那么我们就会去接入，比如说微信支付的开放平台，或者是呃支付宝的一个支付 com 平台，那比如说我们去做一个百度的搜索啊，我们搜支付宝开放平台啊，那我们就可以看到就类似这样一个 com 平台， 就比如说那些呃抖音的开放平台。所以啊看看他都是他的这个技术的底层呢，都是开放这个 h i 接口，那么他的业务呢？根据每个平台呀 不一样，他可能是提供聚合支付的，可能是提供一些电商能力的，可能是提供一些快递查询的，可能是提供一些别的一些接口，可能都有。 好，那么我们再来看呢，就是那么第一块我们就讲完了啊，第一块的这样的意思，概念的意思跟 list 我们就 就讲完了，那么我们再来讲第二块啊，就是那么作为开发者，他是怎么样去用这个开放平台，其实也比较好理解，一般都是一般我们也可以，我们也用过啊，一般 的话，比如说他整个的这个过程就是也比较好理解 啊，其实就是先去啊，开会的话，他会先去注册一个他的平台的账号， 然后呢去登录这个开平台，去建一个新的应用，等待审核，然后就可以去调用一个接口去获得一个令牌授权，随后就可以去跟这个令牌呢，去调用他所需要的一些 open api， 然后去开发应用，他的整个过程就是这样过程，那么我们可以来简单的去操作演示一下。你这个， 这个看平台为例子啊，这个是我们开发好的一个模板，那比如说我们可以去进入到首页找到我是一个开发者，那么我要先还没账号，我要先去做一个注册啊，比如我 这个个人开分子啊，账号叫 dostar 零二二幺啊，不知道这个账号是账号密码？一二三四五六啊，一二三四五六。 好，注册好之后呢，那我就可以去登录了，注册是可以让他去注册的，方便他去使用啊，这个不用审核 好登录之后呢，那么我作为开发者，我就可以看到一些数据啊，但我现在还没有调用，所以它都是清空为零的比较多一点。好，那么我可以去建一个应用啊，建个应用创建我的第一个应用， 比如说我这个是一个演示应用， 个人都是大的，这是一个，那他会说要去做个审核，那么就就等待成他的这个审核，因为还没通过的话，我这个用是不能用的，因为的话并接口的话，他不是随便都可以给他去用的，所以他需要一个审核的过程，那么这个时候呢， 他开不了，先放一遍啊，我们先换另外一个账号吧，比如说我是一个企业的管理员，那么我就会来去做一个审核， 那我看到带审核的应用有一百一十四个啊，原来看到有一个，那么看到这个人给他去做一个审核，通过啊，个人的一个应用要通过， 通过之后呢，我又回到开发者一个角色，那么我就可以看到我的应用他是属于啊通过的了，已经通过审核，并且可以通过这个接口呢，看到我的 这个应用呢，有哪些接口是有权限去调用的？那么下一步的话，我就可以看到这个接口文档啊，然后去想根据这个 呃并排获取的接口，一般都会有这个接口的，每个平台都都是类似的，然后再根据我刚刚所创建申请的这个啊 appk 把它给复制过来，赶紧填过来把，如果说咱们有空格多余的，要把它给稍微去掉一下 啊，甜若蜜要，那么呢我就可以需要一个令牌，两百成功的，那么这个令牌呢？他会告诉你 是在今天是二月二十一号啊，他告诉你在三月二十三号呢，他将会过期，那么在这个月的，在这未来的一个多月呢，我是可以根据这个 token 呢去调用 我所需要的这个接口的啊，这第一步那好奇，比如说我，我看到有一些，有一些别的接口，比如取配置的或者是拼音类的接口，或者是别的这个接口，那么我就可以根据我的这个接口，那前面的这个 token 呢？去调用我的这个新的这个接口。 no， 那么这个就是呢作为一个开发者的一个这样的的一个过程呢？ 开放平台，那是这样子，大家可以把一个呃中文的名字拼音去掉你要的这条接口。好，他的这个体验大概是 这样子，就是注册账号开通应用开始授权标准接口。那么在背后的那企业需要给这些开发者跟整套的系统去提供什么样的一个产品准证呢？那我们可以看到啊，就是你需要这这几块的，比如说 他就需要有一个展示的一个首页，那么可能需要有一个啊内部用的管理后台，为了方便区分呢，这个用黄色的题的色块主题来表示，那么可能还需要有一个蓝色的跟着开放的给到开发者去用一个开放平台， 可能还需要一些呃，给到开发者游客去看的一个接口，这样文档去做一些调试啊，做一些查看的，那可能也要提供给到他们一些手册去查看，大概的话需要这些 呃呃产品的这个这个举证吧。我们来大概再稍微显示的展开来讲一下， 比如我们刚刚看到的这一个啊，这是一个首页啊，就是一般的比如说我们去看到支付宝啊，这支付宝的一个首页他都会有有个首页的，他会告诉你他的这个平台是用来做什么的。一般的话我们也发现了 开门的这个域名都是二级域名，都都是叫 open 的，然后就加上这个一级的，一级的域名啊， 比如说这些平台这些历史会有一个展示一个公文的首页，并且呢在游客的情况下，他也是可以看到这个接口文档的，这个接口文档接口文档是指他每一个接口的一个呃功能说明，比如他的协议啊，入餐，出餐呢，然后 返回室内啊，还有这些出马方面给他的去做一下参考的这一块。好了。那我们还会有一些手册，比如说一些使用手册，告诉他你要怎么去使用这个接口啊，也会有一些给到人去阅读的一些人，比如怎么样去做签名呢？ 怎么去做调试啊这些也会有这一块，这些呃使用手册产品的一些使用手手册。 随后呢我们来看一下进入到这个开放平台呀。啊？开放平台， 开放平台的话他是给外部这些开发者去用的，那么我们来看看他有什么功能呢？比如说他需要一个首页给到开发者去看到他的这个电脑的的的情况，他这个接口的消的消耗的情况，重点是让他看到他有多个应用， 然后去申请去创建，去审核，他也可以去做一个注销，他说他不用了，他可以去做注销， 同时的话他有问题他可以去靠着，可以去做一个功能的提交，去做一个呃沟通跟反馈，然后也可以看到他有哪些接口是有权限的还是没有的，可以去做一个查看，然后上面去做一些开通跟购买。那么个人呢，也可以去改改，看下资料啊，改密码。 最后呢他有一块就是说他可以去购买一些付费的一些增值的一些接口、服务套餐，然后去做些更好的这个开发和使用，这个是开发的的这一侧，他有注册啊，登录跟这些统计 的能力。那么我们再来看一下这个管理后台呀，就是黄色的这一块，他的功能呢就会稍微多一点，因为他这 作为总控的呢，总控段他要管理比较多那种，包括有这些啊，开发的，开发者的账号啊，还有这些应用的这些管理。一个开发者他是可以有多个应用的，一般都是这样去去设置的， 就比如说还有这个接口，这些管理啊，这个要全面的分配啊，包括这些照样去开发接口啊，自然接口啊，都是可以 这样去做成配置开发跟管理的这个测试，这个是接口的管理，还有公单的这个管理，都有这个服务的这个能力。那么另外还有些呃辅助的，比如像技术有关的，像配置啊，计划任务啊，数据库的一个统计， 那么还是属于这些业务用的比较多点的，包括这些啊接口的流量的统计啊， 全服务的，包括这些某个应用的一些统计，以及他每天的这个注册的注册跟登录的这些元素的数量啊，访问音质， 还有给到不同这些开放者的一些，就是他也可以分配这些开放平台的这个权限的，可以给他去做一个分配， 后台也可以分配，这是业务能力的。最后的话，后台呢也会有一块是这些，呃， 就是服务的一个能力，比如说你有些接口是需要收费的，那么可以给他去设一个套餐，比如说掉多少次，多少钱，也可以去自己去配一些套餐，比如说免费试用多少次，然后但是 使用的是现在是可以去组合一些进口的套餐，去给到一个更加优惠的价格，给到开发者去做一些呃，购买和下单，然后可以支持 时一般都需要支持，因为开放平台一般都是以这个批次网为主，所以我们也会用到用到时这样支付，比如像支付宝啊，退票啊这些这样支付。那么我们可以看看到，看一下 就是开发者在前台下单的一个效果，就是这样，他可以去点一个啊，这个是单个接口的购买啊，底下是这些组合探讨的这个购买啊，他可以说我去点一个购买，下单确定啊，比如说 啊，一百四多少钱啊？然后选择确定啊，选择下单的一个付款的方式啊，支付宝，那他可以去做一个 啊，在线下单，然后他就可以去扫码去支付，然后就可以直接就是就会生效的了，就会下载他这个流量，这个是 四台的这个服务能力 好，那我们就可以看到啊，这是刚刚说的，还有首页关掉后台啊，开放平台接口文档，还有这些，呃，手册，那么我们再看看它的 第四块啊，他这个技术架构要怎么样去应对这些这么高变法的一个接口请求跟流量呢？那么可以看到这边来 啊，它的整个，呃，我目前这个模板的话，它主要是基于这些 pad 开关框架去做一个底层的一个开发的。 那么呢他把这个呢分为几块，有 api 开放接口，有平台接口，有后台接口，还有这个任务每块都是分开的，就说他本整个技术账号都是可以支持一个分布式的部署的，那么他可以直接说不同模块的接口 分开去部署，他可以也可以说甚至于每个服务区去做分开部署，也可以针对每每一个应用，每个开发者的账号，或是用去做一个单点的一个部署，然后再去做一个成，做成一个直群。 那这个可以去参考一下从底层框架到这个接口的模块的拆分，再到每个中的一个接入。 好第五块它我们再来看一下它的这一块呀，刚刚也有提到啊，就是说包括它这个接口文档呢，使用手册呀，啊 啊，包括它的这些，呃，教程这些都有，那我们再看看它这个数据库的一个设计啊，数据库的一个设计 啊，一般的话都会有这些表啊，这些表， 嗯，那么他表呢还是比较简单比较清楚的，可能主要是涉及一些借口管理啊，账号管理，然后流量统计，跟着在一些数据库的一个表的一个设置，或者是 master 的数据库。 那么最后第六块我们来看他这个计数站的这个一些单车是根源代码 就算呢，它是一个前后端分离的，那么后端用的是 p p 啊，底层是 pad 开关架，全能的话是 v o e， 也是一个开的的全能框架，那么我们也提供了一个单 测试的一个能力啊，那这块比较重要，我们要保证他的整个这个系统的稳定性。选好单元测试呢，就会很重要啊，这块也是可以去运行的，去刨通的啊，单元测试他也是可以刨通去做一个测试的， 我们可以稍微稍等一下，他可以正在做全面的测试，大家可以看到大概花了零点零一秒啊，跑了一百四十八个测试，三百六十个断言全部都通过啊，这个单车的短能力。最后来看看这个元代码，元代码的话我们来看一下， 嗯，一般他就需要有这这几块的，就是后端的 p p 的这种 g 派的，那然后有有一个开放平台的前端有元宝，还有一个开放后台的，一个前端的一个，呃， 关于后台的全能的原版，还有一个单测试，单测刚刚一看的嘛，就是这样一个这样一个运行的效果，那么他他的原单版呢？就比如说类似这样子的 单元测试的前端单色的后端这个圆嘛，在这里刚刚我们跑的是这个目录啊，那么他就会给给每一个 啊，每一块的这个接口啊，都会写这个单人测试的啊，看后台的接口的，然后三层的包括这些都会看平台的都会写一个单人测试，并且他会对整个数据库啊做一个重新的一个构建，做一个 纯银的构件，每次都会做一个纯银的构件，并且他会给他自动去导入一批这些的测试的数据啊，就是他是比较可靠的，同时的话，呃， 同时呢他也是对媒的接口啊，大腕做一下真的好一个测试。最后的话他 要区分是在做单人测试的时候呢，要注意把那个睡裤啊，给他去做一个隔离，不要跟那个开发裤混在一起，因为他是真话，他就会去跑的，他会这样去去清这个这个裤的要稍微注意一下。 好，那么再看一下，呃， p p 的， p p 的这个原码就是刚刚就是在这里也是其派的去开发的，那么它在原码上，比如说 s r c 面积分为分为每个每个 每个模块啊，就一个包啊，每个包呢也会有这个 a p i 空门德魅跟这个 model 都要集成啊，我们也可以看到这 i d e 的这个情况呢，这个是 p p 的。那么还有前端的话，因为前端用的是 v o e 啊， v o e 啊， v o e v u e v u e j s， 现在它是用这一块将它分离的， 所以啊，前端的话的圆的嘛，就类似这样一个结构，我们来看一下啊， 啊，类似这样一个代码的一个结构啊，也有 s r 四的这一个这样的一个目录啊，分开每个目录去分开，然后 去做一个开放，嗯，两个两份，那么呢 the fun 的话，就对应我们刚才看到这一个蓝色的这个开放平台，就是在 这一块这一块的这个效果，然后对应到这一份的前端的前端的这个元代码，然后再到我们的 id 一，就是可以打开看得到它的前端的元代码，就是用 v 一去开发去写的， 那它会分为每个页面呢，每个模块呀，去做一些开发的，比如这个是工单的这个页面 啊，去做的开发 后台也是类似的。好，我们再回到我们的再次的这个分享的这个内容，主要是关于这个企业级的这个接口开放平台应该要怎么样去搭建的一个话题啊。然后我们这次也演示的， 演示了整个一个使用啊，包括他的这个架构产品矩阵的原代码打印测试跟他这个效果， 那么呢？呃，大家可以根据这个思路啊，也可以直接用完这套模板去快速去搭建，去开发。好，本次这个分享就到这里，感谢各位的一个观看和一个啊支持，谢谢。

在前后端分离项目当中的接口文档经常用十八个进程继承，但是有点很容易被忽略，那就是 那就是他的安全性，这个配置如果不开启等着领导批判，小伙伴可以点赞收藏以备后用。我们都知道在开发环境测试环境，我们可以用 spa 进行这种接口文档的生成，并且测试非常的方便。但是到了线上 是不是我们的需要把这个测试的路径包括这个 api 列表给屏蔽掉，这里呢给大家介绍三种方式推荐使用。第三种我们可以看一下，对于所有的一个集成的也比较方便，第一个是不是在泡沫文件中引入相应的榨干就可以了。第二步呢，增加一个配置类， 做完这两步整个的四八个就能集成。在上线的时候我们需要增加一个这样的配置来确保接口的安全性。第一个用 f 八六这个属性， 可以看一下配置。第一个用 iphone 六，在配置类当中呢增加一个这个属性，然后呢在配置文件当中把这个属性改为放肆，就可以让 aps 接口呢无法访问，确保他的安全性。第二呢也比较简单，在配置类上增加这个属性，然后同样在配置文件当中啊，把这个属性改为放肆， 可以达到同样的效果。第三步也是推荐大家使用的，也是在配置类上增加这个普罗菲尔这个属性，他呢 配置最少也比较灵活，我们只需要指定能用的环境，比如说开发环境，比如说 des t 测试环境，他呢就只在这两个环境上进行运行，所以线上一定要确保斯拉哥的安全性。

兄弟们，你们还在手动编写数据库表文档吗？今天和大家介绍一个数据库表结构文档生成器 secure， secure 被誉为数据库的丝袜梗，支持 myserker、 oracle 等主流数据库，可以生成网页、 word 和马克档文件。 下面这些是生成文档的截图，看文档还是非常清晰简洁的。下面我们使用 spring boot 整合 sql， 看一下效果。用到的核心包是 sqlco， 把它引入的项目中来查看一下 sqlco 的版本， sql 的最新版本是一点零点五，修改一下， 然后看一下代码配置，先复制一下，我们来创建一个测试类， 把包引入进来，现在我们看一下代码，这里需要修改一下数据库连接，我在本地有一个撒地库， 配置一下就改密码，然后修改一下，生成文件目录，就输出到项目下的 sql 文件夹下，这里使用网页生成，你也可以配置 word、 马克档文件，生成 文件名称就不改了。下面是配置生成文档的数据表，这里可以指定数据表，也可以使用排除的方法来配置，我们就直接使用指定数据表的方式配置配置撒地库下面的 student 表， 我们看一下 sql 的啊，使用很简单，配置数据库，连接配置文件生成模板，然 然后再配置一下生效的数据表，下面启动看一下效果。我们看到 sq 下面生成了一个网页文件，文档简洁明了，完全是够用了。除此之外， sq 也支持妈文插件生成文档，大家可以去尝试一下。每天学习到凌晨一点多，单车变摩托，兄弟们拜拜。

这是一个号称全网最强的 a p i 工具，结合了 postman， swagger， mark 以及 j m letter 于一体，通过一套系统，一份数据，解决多个系统之间的数据同步问题。不管你是前端、后端还是测试，都可以使用它。 你可以在这里创建你的团队，创建好团队后，可直接添加你的团队成员。在真实的开发中，创建团队是很有必要的。 接着在该团队下创建你的项目。进入到项目，选择快捷请求测试我们的接口。当你复制一个带有参数的请求链接，他会自动识别链接的所有参数，并且识别后的参数支持修改。 测试完成后的接口，点击右上角保存按钮，可快速的保存当前测试接口，并且生成一份简 清晰的文档，这对后端同学来说简直是福音，可大大减少写文档的时间。 接着来看如何创建请求接口。回到项目首页，选择新建接口，输入请求路径，再输入动态参数后，会自动同步到请求参数的内容中。下面的返回响应就是平时后端返回的数据，你只需要在这里填写返回的参数， 设置每个参数的返回类型，之后的一切请交给 a p i fox。 点击预览，选择动态生成，他会利用本身强大的智能 mark 返回一些接近实 实际的模拟数据。使用一些通用的参数名称，即使不设定 mark 规则，也能产生接近真实的数据，比如 username， email， sex 等。 当然，这里的每一个参数都是可以设置对应 mark 规则的，毕竟 a p i fox 本身的 mark 是很智能的。可以看到这里的 mark 规则还是挺多的，同时也是允许我们自定义 mark 规则。 如果你之前习惯使用的是其他 a p i 管理工具，比如 postman， swagger 等，而此时又想切换到 p i fox， 利用导入数据可快速实现无缝衔接。以 sweater 为例，通过已有的在线文档链接进行导入， 等待几秒，文档里的所有接口都将会被解析到 a p f ox 目前已支持导入几十种类型的接口文档。关于不同文档的导入方式，请移步到官网，本期就先到这，下期继续探索。

大家好，我是宋英的导师孙科，今天给大家带来欧喷一批爱情观的结缘结。 松云是一个 apard 平台，他的目标就是打通传统的萨斯与萨斯之间的系统数据上的孤岛，我们通过 opponpi 的方式呢，能够让数据进行互通。呃，总体而言呢，我们松云的 opps 分为这几大体系，第一个是账户体系， 他可以允许其他的用户啊，在呃注直接通过 oppa 的方式注册到我们整个呃松云系统里面。然后呢？嗯，第二个就是我们的流程代办借口， 我们的流程引擎呢，支持提供啊，我们的 oppa 片把发起流程相关的所有的呃接口呢，包括流程设计的一些信息呢，都给他包装起来啊，比如说我们支持发起我们的流程处理我们流程查看我们流程等等，包括自己的代办和代办链表代办相关的处理等等。然后第三个方面就是我们的表单 智能 api， 表单智能 api 就是通过我们呃斋森 pass 的一个方式把数据提取出来，然后为我们表单生成，自动生成我们的 crud， 当然这个就是我们可以进行快速去修改的第三个方面。第四个方面就是我们的智能连接控件啊，控件的话他和其他控件没什么不一样，他直接可以在我们的控件里面与第三方数据进行打通， 从表单的这个数据里面，从直接从第三方的数据转过来，然后显示出来。然后第四个方面就是呃，第五方面就是我们的流程歪炮的节点，流程歪炮节点呢，就是我们可以把当前表单的数据在流程流转中推向或者从第三方数据拉过来啊，都可以形成我们一个歪炮的节点。 ok， 这就是解，这是我们平台的五大开放特性。首先呢我先给大家介绍一下我们智能连接的一个控件啊，首先呢智能连接控件和我们传统的控件是没有任何区别的，在这块有个智能连接控件啊，比如说我们以简单的一个 呃，就是一个势力作为演示啊，比如说我们现在有一个呃球汇率的，比如说我们呃人民币一百块钱， 我们想看一个汇率是多少，对吧？汇率我们这算出来是零点四三八对，然后每元，最后得出每元是十四点三八对，这个数据就是我们通过第三方 app 来讲的。 ok， 呃，我们在呃同时这个其实也支持我们的这个资料单 看，这是我们的一个字表单，对，然后呢我们也支持，呃，这个，这是这，这是获取直接获取方式啊。然后呢我们现在来看一下我们这个呃表单相关的一些数据啊。 ok， 我们先来看一下 啊，这个汇率呢，就是我们的一个非常典型的一个智能 api 的智能连接的一个控件，他是怎么获取呢？他的流程整体是这样子的，首先呢啊，我们这是我们的一个表单，然后呢这是第三方系统， 当我们去填写表单的时候，他向第三方系统去获取一个链接请求，把这个请求可以带我们任何的数据，然后呢数据请求回来之后呢，他会把请求啊放在这里。 呃，那我们怎么这里面需要解决几个问题？第一个是我们怎么样去解决解析的问题，呃，第二个是我们需要解决，呃，我们如何在设计师的有一些关系？第三个解决相关就是函数之间的依赖处理的问题。 ok， 我们现在从重新开始看啊，首先呢我们这个呃智能连接呢，我们这时候支持啊盖头 pose 的两种方式啊，我们现在只支持 hdp 这种方式请求啊。 然后呢，在我们的这个 url 里面，我们可以去呃写入我们的一个呃字段，这个字段呢也可以包含我们当前的现在的一些，嗯，比如说像他那些空呃也相当于是我们其他一些空降的词，那我们通过差字段啊，其他相关就可以插入进来啊，比如说我们 等于啊，比如说我们把呃这个空间可以弄过来，当然我们是最简单的方式啊， 就可以了。然后呢我们这块支持设置嗨的头，嗨的头的话他支持呃支持我们各种嗨的头，比如说我们这是 ctrl， 他等于真的，对吧？这个扣的的话就是支持我们所有的相关的一些配置啊。然后呢他还可以添加啊，比如说这是默认添加一个，快速添加一下这枕头，然后也可以添加其他的一些嗨的头。 ok， 我们这时候点击确定，然后这就是我们发请求的部分啊，我们把发请求弄好之后呢，他自动当去触发到他的时候，我们去进行结果，呃，就是他去请求，请求完之后他会有结果提取。 ok， 结果提取他是一个斋森 pass 啊，斋森 pass 啊，斋森 pass 是什么样一个概念呢？我给大家大概讲一下啊斋森 pass 的概念啊，斋森 pass 是一种快速提取斋森字幕串的一些行为语法啊，比如说 这时候，呃，我们有一个呃这样的一个阶层啊，阶层的话他可以用阶层 pass 的方式进行提取结果，比如说这个优在内里，我们可以用刀了点优在内里提取，然后这时候我们会有一个教练，教练完成这个结果就是成三， ok， 呃，然后呢，呃，我们会有一个呃 相关的一个啊配置啊，比如说啊，我们在我们的这个呃自己的模板里面啊，比如他返回的数据是，呃瑞兹奥特雷瑞特利斯特优斯迪，按这个锐城，对吧？ 然后我们把它直接提取过来，放到呃 us 瑞特里面， ok， 提取过来之后呢，我们会有一个更新表单的一个操作，也就是说这个 us 瑞特呢和我们这个是一 对应的，也就是说我们把中间提取的数据呃同时给更新到我们的汇率里面，他逻辑是这样子的，我给大家重新演示一下，比如说这是我们的一个斋森啊，第一步是从斋森里面去请求一个啊，我们的斋森 pass 啊， 然后第二步是把形成一些中间的变量啊，中间变量，然后重新中间变量之后呢，我们会再给他进行请求啊。第三步是把这些中间变量付给我们具体的控件， ok， 这这就是非常简单的一个操作，也就是说结果提取的话，他分为这几个范式啊，第一范式是 确定我们的提取的一些中间变量是通过接分帕所来的。第二个我们确定我们中间变量有哪些。第三个是把中间变量复制给具体的数据， ok 啊，这样弄完之后呢，我们配置好。 ok， 然后呢？嗯，他配置好之后呢，他会自动的去呃重新更新我们这个汇率字段，当更新完汇率字段之后呢，我们就看一下这个啊，呃，那个公式地段啊，因为我们最终 测试的值他是一个公式字段，也就是说歪柳，呃，就是我们汇率求他的一个数值乘以人民币， ok， 这样的话我们最最终就能形成我们最终的一个请求了， ok， 这就是最简 单的我们使用智能连接自断啊，所求，呃就是一个简单的一个美元却汇率的一个过程，当然这块我们也支持自保单， ok， 子保单的话也一样，他是 url 加我们的类型，加提取加更新。 ok， 然后呢？呃，我们的智能连接自断他有两种模式啊，第一种模式就是刚才我们选的这种啊，文本输入框， 然后呢？呃，另外一种是一个下拉框啊，这样的，这样模式是怎么用的呢啊？比如说我们想实现一个省市区街道及其详细五级联动的一个模式，这时候我们怎么办呢？我们先看一下我们的这个，呃效果，首先呢看一下，哎，比如说这是云南吧，昆明， 然后呢什么龙马，对吧？接到还可以再请求，对，你看这样的话就能形成，呃形成完整的一套这个，呃，这个这个设置了， ok， 这样的话我们是怎么来的呢？首先呢我， 我们呃使用了一个控件啊，还是使用我们这个智能连接控件？他使用下拉框的一个选项，什么意思呢？他的一个意思就是因为我们这个，呃就是五级联动啊，地区的五级联动，他其实是非常有规律的啊，比如说第一集的话，我们只请请求一下，我们比如说是省的相关的一些数据。 第二集是市，这个市呢是必须在省底下的，然后呢在底下是县，县是包括我们的省市的， ok， 然后这样的话一集集下来之后呢，我们就能求到最后最后的一个详细的地址， 然后呢对于我们的这个 oppa 的，呃，智能连接字段是怎么来的呢？首先呢我们先获取， ok， 我们先获取一下，很简单，我们先 get 一下这个地址，然后呢什么都不配置，然后获取一下结果直接呢获取一下人字 out， 这是我们自己提供的一个接口，然后在市里面，这时候呢，我们通过我们的这个呃， ul 我们去给他变一下，这时候有个普洱粉丝，对吧？就是省，这个省，如果我们选择陕西省就陕西省，云南就是云南，北京就北京，对吧？他将来会把这个数据给他换掉， 然后呢他有一个结构，提取是是提提取的人造的。最后呢这个，呃就省事在获取曲线的时候，是吧？我们就可以用省市来进行获取，然后呢如果是街道的话，你看这块一样的也是省市区，对吧？然后这详细的话就是更多了，然后呢结果提取是一样的，这也就是说我们的一个智能啊，智能 连接空间他是这样使用的， ok， 我们再来看一下，比如说我们这时候选择北京，对吧？北京完了之后呢，他是视察区，然后呢他有区东东城区街道的话他可以选，呃， 很多的，就比如说景山街道，对吧？然后详细地址你可以选各种的村委会，这样的话就能达到五级联动啊。在请求试的时候必须带上手，在请求吃的时候必须带上首饰，这样的话就形成我们自 自动的一套。这个普及电动的啊，如果我们有这样的 epi 就可以做，然后呢，他在运行的时候他会把省事接待上去， ok 啊，今天，呃，第一节我们 oppo epi 的课程就已经到这了啊。呃，希望大家继续关注我们的一个课程，谢谢。

大家好，这节课呢，我们开始学习将购自动生产 app 文档的开发方式，这节课主要讲解呢，嗯，基于第三方的软件包 drf gunyisg 这个软件包来生成 jungo 的 apr 的自动化的一个文档， 那么我们也顺带把江狗自带的内置的 api 文档生成的方式做一个讲解， 因为江狗自带的内置的实际上是江狗 rest from work 这个框架自带的 apr 的文档生成的方式啊，江狗 rest friend work 这个框架呢，实际上也有很多第三方的软件包啊，我们这里面呢主要讲一个用用的比较主流的一个第三方的软件包 drfysg 这个软件包。 那么我们先看一下这节课要讲的一个内容啊，首先呢就是我们用这个软件包，那么呢 就要首先就要安装他，是吧？安装他这个主要，嗯，拍摄的安装方式相对比较简单了，前面我们也安装过很多第三方的软件包， 然后呢其次呢，呃，就需要配置 drfy sg 这个模块以及 uil 路径的配置啊，这里面呢，我们可以看到这个是一个完整的配置啊， 实际上呢就是我们这时刻呢，按照这种方式来讲，首先呢，我们先讲加入 rest framework 内置的 api 文档生成如何来做，其次呢，我们再详细演示一下第三方的软件包 dif yisg 他的安装以及配置啊，其实配置相对比较简单，主要在两个地方，第一个呢就是我们的塞停文件中， 我们安装了这个第三方的软件包，那么我们在 citing 的这个文件里面把第三方的应用配置进去，那如果不配置进去的话， 我们就会把它当做一个酷文件来使用的，那么就会出现一些错误，当然呢也可以做一些呃其他方面的配置来解决这个问题，这里面呢我们也简单讲一下。 那么第三个方面呢，我们就需要在 url 这个文件里面进行一个路径的配置。路径的配置 how？ 好，首先呢我们讲第一个用 jungle rest friend work 自带的 ipa 文档生成器，那么呢我这一个大家看一下我这个 uil 它是一个完整的，呃，配完整的这个文件啊，那么内置的呢？首先我们从 jungle rest friend work 的 docu document 这个模块里面导入这个方法。其次呢， 只要在路径上我们做一个配置就可以了啊，原来的路径把这个方法配置进去，是吧他的这个访问的路径以及这个方法，那我们来尝试一下啊，我们在这边尝试一下， 首先呢要导入 rest friend work document 这个模块里面的 include docus uil 这个方法， rom rest framework 点 document 啊， import， 怎么呢？ include 啊，这个我们就导入了导入了呢，我们在这个 uil 的这个路径做一下配置， 走一下配置，那我们看一下这边是怎么写的。嗯，首先呢配置一下路径， 那么我们就是 darks 斜杠，把刚才倒入的 include 做一些参数的配置， 买埃比亚塔特哈 好了，那么我们就配置好了，我们保存一下来访问刀克斯这个 路径，看一下我们 apr 的一个外部的这种方式。好，大家还记得我们刚才配置的路径是 dogs。 好，那么我们内置的文档的 app 文档的这种方式呢， 就非常简单，实际上也是非常容易易读的，那么我们来看一下我们的这个呃接口啊，这个是呢请求啊请求，那我们看到这个，呃，刚才是我们设备模板的一个请求的列表，我们这里面实际上是有一个这样的一个 呃设备模板是吧？嗯，呃相对来说还是比较好用的，那我们把它的阿迪拷贝一下再来呃尝 试一下这个呃详情啊详情，那他需要我们输入阿迪号啊，那我们再又开始的一下，在这里面看到啊，实际上是非常好用的，非常好用，要配置起来也是非常简单啊。 当我们重点还是讲详细的讲一下我们第三方的这个模块的使用哈。 首先呢安装这个 difysg 的这个软件包，这里面就不详细制作介绍了啊，详细做介绍，那我们呢也可以查看一下我们有没有这个软件包，有没有安装好啊。那主要安装的话就是 prp 三啊，我们使用派出三版本的啊，因为我们这个 拍摄的环境实际上是有两个版本的环境，一个是拍摄二的，一个拍摄三的，所以呢 prp 这里面呢也做了一些区 分好，那么我安装完之后啊，我就直接配置了 uil 路径， uil 路径，那么 uil 路径呢？这个我们来配置一下哈，我们看一下会产生什么问题 啊？首先我们先看一下有没有安装好啊，我们先退出来， 退出来 pip 三，呃， list grab 查询啊，查询哪个呢？ drf 来看一下。那首先看一下实际上是我们这个第三方的软件包使用的一点一七这个版本啊，一点一七这个版本，这个是，呃，其实呢，这里面呢，我们从 从官方文档上面来看呢，这个第三方的软件包呢，他支持的是这个江古，瑞士弗兰沃克，他从三点一零到三点一二，江古呢，他是支持什么版本以拍摄支持什么版本？大家还记得我们使用的，呃， 实际上我们的将狗使用的是三点二，是吧？他这里面呢，嗯，我们使用的最新的三点二十一啊，就是我们测试过，也是没有问题的啊， 那么坚固的这个呢，我们使用的是三点九版本，实际上低于的低于的这个三点幺幺零的这个版本一拍摄呢，使用的是没问题的三点八啊，我们使用的，嗯，实际上经过我的测试是这样是没有问题的，没有问题的， 那么在这里呢，我们就按照这个文档来，刚才测试了内置的这种方式，那么我们使用这第三方的这个自动生成文档的这个方式。 首先看到我们要从第三方的这个，呃， difysg 的要导入他的一个视图，以及他的 open 的这个 ipi 啊， oppo 的 ipi。 那么其次呢，我们需要做一些初始化，就是这个仕途啊，做一些 openapi 的一个信息的一个初始化， 住土啊，这是住土啊的信息啊。然后呢，另外呢，就是我们需要配置他的远要路径，远要路径主要是，呃，这两个是吧，实际上就是这种呢，实际上大家也可以看到实际上调用的是同样的一个方法，只不过呢他渲染的页面的 展展现的方式可能有点不同啊，一个是 bug 的这种方式，一个是追 doc 的这种方式，但是具体有什么区别呢？待会我们来看啊，来看。 好，那么我们先做一下这一部分，看会出现什么情况啊，出现什么情况。那么这里面呢，我们就把这个两个， 呃需要用到的这个模块导入进来啊，导入进来，首先这样 我们就 from d r f 从这个第三方的 import 啊，相对它是有代码补全的，相对来说还是比较快的啊，比较快啊，刚才 from 还有 d r f 点 f 点 vivo， 它这个仕途里面导入 get schemer vivo 的这个实图啊，我们导入了，导入了，刚才说到第二部分，我们要做一些这个，说实话，这一段文字呢，我们就直接把它拷贝过来就行了啊，不做过多的一个讲解了。嗯， 好，那么还大家还记得还有一块地方就是 uil 的这个配置啊， uil 的配置呢？这一块呢，我们也直接拷贝过来，为了节省时间啊，大家可以自己 呃来一句一句的来体验一下，瞧一下，因为我这个是想提前写好了啊， 主要为了讲课，我就不。嗯，重复了，好保存，保存完之后呢，我们这个环境运行起来，运行起来，运行起来呢，我们用 stop 和对 dog 这种方式来访问，看一下 可以出现什么问题啊？出现什么问题？当时我遇到这个问题的时候，实际上呢是解决的方式相对麻烦了一些，但是实际上是不用那么麻烦的。那我们看一下哈，先试一下， 大家看一下，大家看一下。只有登录啊，时间整个页面没有出来的啊，然后我们再看一个 red dog， red dog 啊， red dog 也没有出来，那么看一下有没有爆什么错误 好，大家有没有看到啊？就是他的这个错误啊，指出的还是比较清楚的，意思说呢，就是我们访问 difysg 的他的一个静态的渲染的文件是四零四的， 报错是找不到这个文件，那就说明这个文件是找不到的啊，找不到的，那找不到了呢？实际上呢？ 嗯，当时我遇到这个问题的时候，我就直接想办法找到这个文件，是吧？放到 static 这个文件夹下，让我的这个整个应用这个找到啊，找到，然后， 呃，我们看一下这个解决的方式啊，简单讲一下哈，讲一下，这不这里面呢报了一些错误，意思就是说没有找到这些文件啊，没有找到这个文件，那我们解决的方式用的开始呢？是比较麻烦的这种方式是吧？这个报错呢，指的是我们 这个 difysg 下的静态资源的文件是访问不到的，那么我们就把这个 ysg 下的静态文件呢，把它拷贝到了我们可以访 我们的地方啊，我们把它烤味到了我们的 jungle rest friend work 这个文件下下，他也有个 style， 这个这个静静态文件他是可以访问到的，我们就放在这个目录下了，目录下最后测试呢是没有问题的，怎样呢？这种解决方式呢，相对来说是稍微复杂了一些啊， 因为我们在安装这个第三方软件包的时候啊，我们只做了这个 uil 的这个配置啊，我们刚才忘了，又在 cit 中配置这个应用啊，配置这个应用，实际上我们需要在 cit 里面把这个第三方的这个应用 把它配置进来啊，配置进来，我们在这边啊，在这边还记得塞天文件啊，我们在这个里面， 这个里面我们把 difysg 啊，把它配置进来。好，那我们就配置好了，保存一下，保存完之后呢，我们再来看一下 这个访问的页面的一个渲染的一个情况啊，我们来看一下。好，那么这个是蕊刀口的这种方式，我们回测一下 是不是这个瑞刀壳的这种方式的页面已经加载上来了，加载上来了，这个是刚才我们写的，我们看到是吧？他有设备模板的这个列表啊， 他的这个瑞刀可是这种方式呢，主要比较详细的定义了这个接口，是吧？这个接口的这个，嗯，要求啊，是吧？要求我们看 就是这里面有没有。这里面实际上是没办法做这个测试的啊？他的这个是响应的，他这个这个自断是什么？实际上没办法做测试。刚才我们那个 rest friend work 内内置的，我们就可以做一些数据的测试，那这里面实际上是没办法做数据测试的，那么再看一下那个 spot 的这种方式，嗯， spot 的这种方式啊，我们看到也可以了啊，也可以了，那么 spot 这个是这种方式呢？实际上他就可以做一些测试。例如我们获取设备模板的这个列表，我们 try it out 执行一下。 那有没有看到我们获取到了有一个设备模板，叫智能灯的一个设备模板。好，那我们再 回到我们的这个教程哈，教程，教程，教程呢？刚才我们已经演示了，演示了，就是做一些测试啊，做一些测试， 测试，测试，刚才讲到就是时间，还是比较简单的哈，在塞停里面把这个应用配置上去就可以访问了，那么访问呢，首先是这种第一种方式呢，我们刚才介绍的是内置的这种方式，就是原始说 fran von 内置的 api 文档 深层器啊，内置这种方式啊，他可以做接口的一个测试，另一种方式呢，就是十二个是吧？十二个使用的就是第三方的 dnfysg 这个模块啊， 这个模块，那这里面呢，实际上就是有一个方法，我们简单介绍一下，就是这两个实际上采用的是同样的一个方法，实际上有什么区别呢？无非就是他这页面旋的这个模板 不一样啊，一种采用 spot 的这种地面风格，一个使用是 redog 的这个界面风格啊，界面风格好，我们来看一下这个刚才看到的 像 spot 的这种方式，只用 stog 是一个比较好的一个文档生存器啊，他既支持我们输的拍摄的这种将构框架，这样再加哇 应用开发的框架里面呢，也是知识的啊，知识的。然后另外一个就是瑞刀壳的这种渲染这种方式，就是这种软件呃，页面的一个方式哈， 那么以上呢，我们看到相对来说代码量也不多啊，我们来回顾一下哈，回顾一下使用。第三回顾一下这堂客讲的内容哈，首先呢，我们需要配置的呢，就是在一种 rest friend work 内置的 ipad 文档生存的方式，那么内置的方式呢，相对比较简单，我们只需要在 rest friend work 的刀可有这个模块里面导入英克路的 docs uil 这个方法啊，然后呢在 ui 要拍同时里面把原来的这个路径配置上去，然后他就能自动获取这种 ipa 的这种 页面啊。那么第二种，我们详细讲到就是第三方的 dnfyisg 的这种使用方式啊，那第一步呢，首先是安装他啊，安装他，其次呢在我们的 ciatus 文件里面 啊，把这个应用吗把它配置进去。第三个呢，我们在 uil 的这个文件里面，是吧？首先把我们使用到的这个模块和方法 啊导入进来，做一些初始化的一些定义啊，最后呢，在我们的 uilpot 里面把我们的路径配置进去啊，基本上就，呃，就这几步啊，实际上是相对比较简单的啊， 然后呈现出来的这个方式呢，也就是我们看到的啊，这种接口的这种方式，嗯，好，那么今天的课呢，我们就讲到这， 那好，那么这堂课呢，实际上我们就讲到了我们开发出来的，嗯， resf for 这种标准的 ipa 接口，我们可以通过应 面的方式把它暴露出来啊，让我们很容易看到我们写了哪些接口，是吧？他的接口是 request 请求有哪些要求，以及响应有哪些这个自断。嗯， 那么我们这节课就讲到这里啊，讲到这里，那么下节课呢，我们想讲一下，就是我们这些接口啊，大家有没有看到我们没有做这个任何身份的这个认证，也就是是什么意思呢？就是说我们在访问这个 呃接口的时候，咱们这个接口的时候，直接请求的时候，我们看到他这个请求请求段时间没做任何的一个健全和认证，那么下一下一个呢？下一节课呢？我们去重点讲如何做他的一个健 认证，这样我们把呃一些 token 的值加在这个嗨的这个头部文件里面啊，做一些健全和认证，好好的，那么这节课就讲到这里，谢谢大家。

dj dj 我想要飞 dj dj 我想妹妹客梦 dj dj， 我想要 来看 上课蹦左右边，蹦蹦蹦跳蹦起来， 我看 关注阿彩更多精彩！

哈喽，上一节给大家分享了一下一个企业级的测试管理工具。呃， a p fox， 那 a p fox 更大的一个作用呢？是作为一个团队协助管理，而且我们可以创建一个自己的团队。 你说我在公司里面这个组里面有多少人？前端后端一起是吧？我们创建一个团队，然后管理我们整个项目，后端写完接口在上面去定义一毫，然后前端直接做做做测试，然后可以直接做调试，然后做开发，这样的话管理起来也，我们每个迭代这些接口也都管理起来了，都很方便。那如果说我们自己在开发项目的时候 需要提供一些外部接口，或者说我们整个在公司内部需要提供一些外部接口给外语，嗯，给外面的人使用的时候，比如测试文件里面，那这个时候我们嗯是写一些接口文档，还是提供一个在线的一个文档呢？那这个时候其实就是另一个工具了啊， swag two 的一个 工具的一个用处。那这里呢？我跑了一个项目，然后我们看一下这个 swag to 的一个应用在我这个项目里面， 那我们可以看到他这个里面在前台、后台，其实他所有的接口都给管理起来了，这个一定要预约挂号系统 啊，都管理起来了，然后很方便。你要做调试的话，直接点一个，然后调试发送请求，但是我这里需要一个请求头啊，这个托品，这个肯定是你。呃，如果没有怎么办呢？其实就是登录一下前端，然后把这个图给拿掉，然后自己发送一下就 ok 了，或者说自定义一个，就是固定的一个托品去发送，然后通过他的教验就 ok。 那这里呃给大家分享一下，就是快速的去搭建我们的 swagger 怎么去使用啊？然后在这里 我的这个分享的这个 model 里面，呃，因为是要本来是要讲这个数据教验的 g l 三三零三教验，但是在讲它的过程中呢，其实我们会用到这些接口测试的这些工具啊，以 swag 为主，他这个时候我先把 swag 给大家分享一下，然后后面的话统一的给大家去分享 g s 三三零三教验，这个整个在数据教验的过程中，他的一些基础以及高级的一些用法。那其实 swag 呢， 有技术的配置，他也有高级的配置，比如说 level 接，然后以及自己封装一个 start， 然后去应用在各种项目中，比如说我们整个公司有自己的一个，嗯，自己的一个美容仓库的话，这个时候我们自己封装一些 start 放到自己的美容仓库里面，嗯，不管是入职的小伙伴还是其他小伙伴来的时候，然后拉下我们项目，然后 引用我们自己卖货仓库里面的这些 star 去使用，而去部署我们自己的项目。这个时候其实就是嗯这种封装 star 的一个好处了，比如斯瓦格封了一个 star 出来，我们在项目里面直接去去做一些基础的配置，比如这个 star 就 ok 了。 那我们自己在开发的时候呢，其实我们只需要在泡沫文件里面引入两个基础的这个 star 的这个依赖啊， swagger q 以及 swagger y， 然后再写一个这个配置文件， 这两个注解很关键，一个是声明他是一个系统的一个配置文件，一个是启用这个 swag to， 那下面这个配置呢？我们只需要照搬过去，然后改一下我喜欢的一些基础信息， 最重要的是这个 controller 的这个路径，那你其实可以写到 controller， 其实也可以按照自己的习惯写在上面一些的一些路径下面其实都可以，那这个时候其实就已经配置完了，就是引入一个，一来写一个配置文件，这些其实都复制过去，然后呢一个 ctrl 上面呢我们去定一个 api， 声明一下我们这个 ctrl 是什么名字，然后再定义一个接口，然后在这个接口上面我们去声明一下这个接口叫什么名字。我们可以看到上面是 api， 下面是 api operating， 那这样的话我们整个 啊 smart 就已经配置好了。由于这里是基础配置，其实我我故意演示了一下子，最基础的就是给为了给大家看一下整个他的一个界面的一个改观，就在这个地方只引入了两个依赖他的一个界面，其实就是这样的。 那在这个里面我们可以看到这个 user 啊，整个这个界面，我们看这是嗯比较老比较丑的一个界面，而且在调试上面，其实我是特别不喜欢这个的调试，怎么说呢？我们需要把它点开，点开之后，然后这里有个穿一条 alt， 那你觉得好了吗？其实没好，还要点一下这个 执行，点了之后你看下面他在这里给了一个这个结果，就有时候我们看着就很大一片，然后看着很不舒服，那这个时候为了让他界面更美观，我们需要去引入一个啊，他的 what is drop 写的一个 ui， 那其实就是下面这个，啧，这个依赖，这个依赖，呃，我打开了之后，我让他加载一下依赖，然后再进行一下热部署 啊，我们可以看到很快就部署完了，部署完了之后，这个时候我再通过他吧，通过他点开，然后我这个时候再来一个 dos 点 htm。 二，这个时候我们就来到了这样一个界面，就这个界面和我们刚刚看到呃塔城那个医疗预约挂号系统又不一样，那这个呢？是呃一个比较好的一个这个 test drop 鞋的这个 swag 的这个，嗯， 见面了。那刚刚一条跃挂号系统那个里面呢？其实它是那个呃 life for j 写的，后续呢，可以给大家分享一下。就是基于 life for j， 然后我们再去呃封装 swag， 然后封装一个 start， 我们怎么去做？然后让更好的用到这个项目中，其实大家要去尝试封装嗯，这个 start， 为什么呢？因为封装 start 其实锻炼自己的一些思维能力，你可以去想一下别人的 start 封装好了就能用。我们自己封装一个 start 怎么去用到我们项目中？比如说通用的一些东西 啊，像 spark 啊，嗯，以及像我们的其他的 dar 呀， log 这种日志这些都可以去封装一个 star 用，那这里其实做一个简单测试，一个调试，然后一个发送，那这里我们就能够很清晰的看到详细内容，比起我们之前这个界面的话，看着就很舒服，所以要达到一个这样的一个界面，我们怎么做呢？ 引入三个依赖啊，这三个依赖引入到我们自己的项目中，但是我们要一定要切记这个 sword 这个版本不要太高，不要超过二点五点零以上啊。然后我们再引入一下这个 config 配置文件，然后直接去定义我们的这个 controller 就 ok 了。那其实 我之前在学习的过程中，我是把这个给记下来了的，就是我的一个习惯，我会把自己的这个呃觉得好的工具，如果我记不住这些依赖怎么办？写在一个文档里面，比如说 swag 的整合添加依赖，然后写配置文件，是吧？然后在这里 添加这个呃， ui 的这个界面依赖，然后怎么去使用好？然后在聚合工程里面我们怎么去用？ 然后 life forget， 我们引入一下依赖，然后去配置一些自定义 started 的一些工具啊，然后就能直接使用了。 那今天分享这个 swag 呢，其实非常简单，主要是想希望大家呢在平时的开发过程中都把这些工具给用起来，让自己的项目呢更丰富，也可以在简历上 swagger 也写上去，作为一个小小的技术点，甚至你可以说你自己风光的一个 star， star 就是基于 swagger 风光的一个 star， 然后所以项目按这里那个规则去配置，都能够很快的用起来，那我觉得也是一个亮点，那今天这个视频呢，就分享到这里。