17-尚硅谷-尚医通-后台系统-医院设置接口-整合Swagger测试

各位同学大家好，欢迎继续收看上硅谷视频课程。刚才内容中呢，我们完成了医院设置接口两个接口的开发，一个是查询所有的医院设置信息，还有一个是逻辑上的操作。但是逻辑删除操作呢，因为它是比例的提交，所以咱们没法用浏览器直接进行访问测试，所以咱们下面来整合一个测试工具，这个工具叫做swaer swagger呢是一个API接口文档，通过它可以方便我们各种提交方式接口测试，通过swa我们能看到接口的名称、请求方法、传递参数以及返回信息，所以咱们下面就在项目中整合进去S8，然后完成接口的测试。那咱们看这swa该怎么整合，首先第一个各位明确。因为这个swaer呢，咱们不仅在这个hospital里面用到，后面的接口中咱是不是也要用到，所以我把swaer就整合到咱们的common中来，在里边让所有的微服模块中都能使用到，那怎么整合给各位说一下，首先第一步呢，咱需要在common中先引入两个swaer的依赖，那我们看一下这个之前我们已经引入过了。

第一个依赖就是。Wa to第二个叫swagger UI就是它的一面部分，所以第一步把依赖引入了，然后有依赖之后，咱下面我就在这个service YouTube里边，咱们来创建一个包，然后在包里边的写上一个配置类里边配置swa的新闻内容，那我在里边把包先创建这个包，我们起个名字，我就叫com.at硅谷。点上这个预约挂号，点上这个。然后我们就考这把，这个我们先做个创业。

然后创建之后呢，咱们把配置类给它就直接拿过来，我在工具类中给各位已经提供的配置类就这个swag to con，然后咱把它复制到我当前的包里面来做个复制，复制之后我们来看一下里面内容，这段代码不需要各位挑别，因为里边是一个固定的结构，各位按照结构能改成你对应的笑点就可以了。那咱们来看一下这个swa to这个里边有什么内容，首先各位看第一个。他这个什么。是不是一个配置类啊，然后里边加一个注解叫an ablewa to表示开启wa操作，然后下面有一个艾B，就创建对象，这个就是一个docker do，然后里边new上一个对象，在下面有它的基本信息，包含它的描述等等，所以这是一个基本结构，在结构中有这么一些，咱们来仔细看一下，先大家看new一个。

第一个就是这个叫wa two，然后第二个呢，是他一个分组的名字，这个名字可以随便起，比如我叫这个web A片。然后在下面呢，有它的这个就是相关的信息，叫web API info，就是里边的这个信息，然后除了它之外，下面有它可以显示路径，比如说我写这个路径，大家看这个什么意思啊，它就表示呢，你的路径中包含我的命就显示，如果不包含就不就显示，然后下面这里边就有他的加的一些相关内容。就是一些基本信息，所以咱把它直接复制到我们的这个包里边，然后把它给它改成你的效果就可以了，而我这里边呢，建了两个B，一个叫web API com，一个叫我的mean去com，你看它里边都是显示不同的接口，这是显示API接口，这是显示或者mid接口。

所以这是关于个配置类的创面，咱们把它就做到了，然后做到之后呢，下面我们还需要改的地方，咱们来到hospital这个模块的启动类上面，在启动类上面设置一下它那个扫描的规则，我先写完，然后解释comment，看贝package里边加上这个叫com.at硅谷我们加它。然后这是什么意思呢？各位注意啊，因为我现在啊，在hospital里面是不要用到这个配置类，而配置类。和hospital不在一个项目中吧，所以咱需要把瑞U给它引入到我当前块中来，这个咱之前已经引入过了，但是引入之后大家发现我这个包跟这个包不一样嘛，所以我们要设一下它的这个扫描规则，你看我的设置都叫com.at硅谷，因为他们前面是不都是内容，所以它就能扫描，一启动能启动当前项目内容不好也能扫描到这个配置内种内容，所以咱们需要做个设置。

而通过这些设置之后，咱们这个SW就整合到了我们的项目中来，那咱们整合之后，下面我把这服务启动一下，咱们给他做个测试，看一下效果能不能出来。那咱们把服务器先求起来。各位看目前呢，已经集起来了，然后启动之后我们怎么测试呢？给各位说一下这个swa to呢，有一个固定的访问地址，它的固定地址又叫做swa-Uy.HTML咱通过它就可以做这么一个访问，那咱们现在就访问一下，就这个地址比就是这里写到的这个地址。

那我来访问，我在里边写一下，就是local house，加上你当前项目的端口号，后面加上一个叫swa。上Uy.HTML然后咱们一回车就可以进行访问，注意后面的地址固定的前面加上你项目的IP地址加动画号，因为我的项目的IP是本地逗号，动号号是8201，所以咱用它做一个访问。然后访之后呢，我们就能看到一个效果啊，但是这里面没有出来，应该是没有加载，那我把项目给它刷新一下，咱们再做个测试。比如现在我来这里边，因为刚才我们加了新的内容嘛，那我现在把我这个项目给他先刷新一下，刷新之后我们再启动再进行访问。啊，这个刷新了啊，然后刷新之后呢，我把这个项目给它就重新再启动一下。

咱重新启动一下啊，然后启动之后我们再进行这么一个访问。好，现在项目已经启动了啊，然后启动之后呢，我们把这个路径我们打开一个新的标签页，再重新访问一下。然后咱们看目前是不是就可以访问了，因为刚才是没有加载，咱们把项目刷新就可以了，然后访问之后大家看在我这里边就显示了一些信息，上面这些信息呢，其实都是我们刚才在配置内容写的，是不是就是这些值。各位应该能看到，然后在里边来看这个地方，在我们最上面这个位置呢，有它一个分组，一个叫我dmin API，一个叫web API，这两个就是我刚才创建的两个bin，大家看这是web API，这是我inin API，咱们选择不同的分组会显示不同的内容，因为我这是我的命，然后下面有你对应的这个接口，包括咱们把这个点开，大家看你看啊，这个是不是就是我们的CTRL了，然后下面有两个接口，一个是get提交的，一个是比delete的提交，有它对应的这个地址，所以咱们现在把swa就整合到了我们的项目中来，这是一个整合过程。

这个过程我再重复一遍，第一步咱们在common里边呢，先引入SW的两个依赖，然后复制它的配置类。配置内容不需要改特别的，你改的话你就改你的相关的提示，包括你的接口的路径，然后这个写完之后，咱们在hospital的行类上面加上我们的扫描规则，最终我把项目刷新，刷新之后一启动，一访问就能看到接口的这个文档。然后通过这个就可以完成一个接口的测试，所以这是关于swa的整合，然后整合过程中大家看我的课件中，在我课件中标注出来了，在这里边呢，Swa使用中有一些相关的注解，就这个铸解我们不用swaer也能使用，只是用铸解之后咱能看到更详细的信息，那铸解给它引用下。

不解什么意思呢，大家看啊人，你看我这个位置。我现在这里边并没有什么中文提示吧，只是显示你这个方法名字，包括你的类的名字，所以咱们可以让它的显示变成中文，比如说我这接口叫什么，我的方法是做什么的，而这些用注解我们可以做个实现，那咱们给他快速来改一下，首先第一个呢，咱看我的课件中，我可以在这个就是。CTRL上边加上一个叫API的这个注解，那咱们给它就加上，我加到CTRL上边。加一个注解。然后把它的依赖引入在注解上面，咱们可以加个中文提示，我们叫医院设置管理，然后这个加上之后，咱们第二部分可以在我们的具体方法上边加上一个注解，叫API operation，然后把这个给各位加上。

我就直接复制，咱给它快速改一下，比如说我们的这个A片O，然后这个方法就是获取就是所有的。医院。设置的信息，然后这个我们也加上一个A片operation，这一个就是逻辑删除。医院设置信息，所以咱们现在把这注解加上了，而加上注解之后，我们一会儿再进行测试，它就能看到一些相关的中文提示，当然你这里边如果你有相应的这个方法中参数也可以加一个叫APIP进行设置，我就不一个加了，因为现在我把核心的一个位都加上了。然后现在我们做了一个注解，然后咱们把服务器重新启动，我们最终来查看一下，包括进行这个逻辑删除的一个测试。

那我们启动，我们来试一下。等他先顶起来。现在已经启动了，然后来到里边，我直接给它刷新一下。刷新之后大家看里边。你看这个位置是不是有中文提示医院设置管理，这是获取所有医院设置，这是逻辑删除医院设置中文是不是都有了，然后中文有之后咱们在swa里边做个测试，首先我先测查所有，那怎么测呢？大家看啊，里边有一些相关的提示信息，然后咱们点这个，点开之后有一个叫try it out，咱们把它点一下。大家看最终是不是有结果，这结果是不是就反数据啊，这叫response保底，然后这是你想的状态，满200，包括这是投信息，所以咱们直接点那个try in out就可以进行测试，这是第一个参所信息，咱们再看这个逻辑，删除原测试，大家看啊，A位置让咱数传个参数，而这参数有个提示叫require。

什么意思？是必须要有，所以里边呢，我们传入一个值，比如说我就传我表里边的目前这个六的这个值，把这个传进来，然后传完之后怎么测试，各位应该知道，我刚才说过是不是点这个TRY比较out呀，咱们一点其实咱们是不是就触。成功表示逻辑删除就做到了，做到之后咱到里边刷新一下，大家看它的效果，这指数就变成一了，变成一之后就表示它已经被删除了，所以咱们现在就整合了swa，包括用swa完成了我们这个比delete的就是逻辑删除接口的测试，所以各位按照我刚才演示过程，把这个SWG给它快速整合到你的项目中来，然后进行这个接口的一个测试。这个咱们就演示完成了。