00:00
那swagger是什么呢?Swa呢,它是一个啊,基于Java的一个,可以根据我们编写的接口自动生成文档和。测试用力的这样的一个工具,所以呢,我们现在呢,把它来整合到我们的项目当中,那首先第一个步骤呢,我们先要把SW的依赖引进来哈,这依赖我们已经引过了。我们来看一下在service里面。我们找到POM啊,这个里面呢,就有两个依赖,一个是swer,这是swer的核心依赖,还有一个呢是swer UI,这个是wer的UI依赖,通过它呢,我们能够嗯。生成一个基于SW的这样的一个测试界面啊,也就是说他顺便呢,会把测试文档也给我们生成,所以这个呢,是需要我们引入的两个依赖,那为什么这两个依赖提前已经引好了呢?因为在这个生成的代码里面,我们的代码生成器。
01:01
我们随便打开一个,你会发现呢,你像这个里面的API model啊,还有API model property啊,实际上都是啊,基于swaer的一些注解啊,所以我们如果想要让代码生成器生成完这个代码之后,直接就能够编译通过,那么必须事先把swaer的依赖引进来,你代码生成器你才能使用这个啊,使用它对不对,然后代码生成器里面具体关于生成SW的那个那句话在哪呢?在这个地方。在这儿啊,好,这个实际上咱们在讲代码生成器的时候呢,我已经给大家讲过了,那现在呢,我再来强调一下,好,然后接下来呢,这些啊,前提是需要大家了解的,然后接下来呢,咱们就可以去配置拉ER了,那么配置拉ER呢,一共嗯,其实就一个步骤,这个步骤呢,就是配置一个SPA的配置文件,那么这个配置文件我们在哪写呢?在写的这个service base里面啊,那因为未来这个SPA的配置呀,要用于我们的所有的其他的微服务,所以呢,像这种所有的微服务都会用到的通用配置呢,我们就写在service base里面,那么在src下面我们呢,去创建一个包。
02:20
Package啊,这包呢,我们就com点艾特硅谷,然后点SRB,然后点base,点很费哈,大家要注意,你这个包一定不能是随便写的名字,一定要和谁保持一致呢,一定要和这保持一致。你这不是扫描了一个嗯包吗?就至少要是这个包或者是这个包的紫包才可以,所以呢,我前面这一部分的内容就是com点艾特,对5.srb是它要说明什么,说明我这个项目启动的时候能够扫描到这个里面的组件,明白吧?啊好好,那这样的话,我这个项目一启动就能够扫描到这个里面的组件呢,就意味着我在这里面是可以写一些组件的,那所以在这个地方我们就new一个spring的配文件,然后呢,这个配软件呢,我们就给它起名叫SPA。
03:16
True conig,好,然后接下来呢,上面这块,因为它是一个spring的配置文件,所以呢就是configuration,好,它是一个swa的配置文件,所以呢就是enable swa to,然后接下来呢,我们在这个里面呢,去配置一个swa的一个配置,那么最简单的配置呢,就是我们写一个do对象啊,这个呢就是wer的文档对象,然后呢,我们写一个比如说API。这个好,然后接下来呢,在这个地方我们呢,就给它创建一个文档对象,那么这个文档对象怎么创建呢?叫做new document,好,这里面需要一个参数啊,写的是文档类型,它是document type类型的,所以我们写document type里面有个常量叫sweater to,我们就选这个就可以了。好,那这块呢,就是我们最简单的一个配置,那同样你不要忘了在上面呢写一个并注解啊,然后呢,我们应用程序启动的时候呢,就会自动的把这个B呢加载到我们应用程序的上下文当中,那接下来呢,我们先来运行一下它。
04:44
好,这是我们就运行起来了,运行起来之后呢,我们就可以访问一下我们的这个生成的文档了,那么在哪访问呢?我们打开我们的浏览器。然后local host啊,这个叫8110啊,然后呢是swagger-UI,这个是固定的一个地址啊,不能写成别的HTML,然后呢,接下来我们回车就可以了。
05:12
好,大家在这个地方呢,就可以看到一个swer所生成的文档了,那在这文档当中呢,这块有一个叫a me integral great controller,我们把它打点开,这两个呢,就是刚才咱们写的两个接口,第一个呢,就list out,我们把它点开,然后这面呢,有个try it out,就是试一下,试一下其实就是做测试了,然后我们把它点一下,点一下之后呢,这块如果有参数的话,它会有一个参数列表给你列出来,我们这边是没有参数的,然后直接执行就行了,execute.execute,好,然后接下来呢,在下面这个地方,实际上它的底层呢,其实就是发了一个啊,HTTP的一个远程命令啊,然后接下来呢,我们这个得到的结果呢,就是下面这个responsibility。
06:00
这是响应题responsibility,我们得到了这样的两个结果,因为有一条记录已经被我们删掉了,好,然后这个呢是responsibility啊,我们得到的这个响应类型的内容呢,是Jason数据类型,对吧?嗯,所以这块呢,就是我们整个的。一个测试结果了啊好,然后那呃,接下来呢,我们再来看一看另外一个例子,就是delete这个例子点开,点开之后呢,一样try it out,然后上面这块呢,有一个就是参数列表,参数列表这块呢,这参数的名字呢叫ID,而且这参数是必填的好你要不填的话他就不行是吧,摇摇头,那你就得填上,填上的话呢,这个地方呢,他就让你填一个ID,比如说填二好,然后呢,我们就写execute,好,那这样的话呢,这面呢就返回处,返回处呢就说明我们的删除是成功了的,好那这个时候呢,你再回头去看一看这个。啊,列表这块呢,就剩一条记录了,就说明另外一条记录呢,已经被删掉了,那同样数据库里面你们刷新一下,那你会发现呢,有两条记录呢,已经都给删掉了,是不是啊好,因为记录太少了,我把这两条记录再还原回来啊好,那这块呢,就是我们啊使用swagger啊进行啊单元测试啊,以及怎么样去配这个swer的一个过程。
我来说两句