day06/上午/111-尚硅谷-尚融宝-Swagger文档描述信息的配置

好，接下来呢，在这个地方呢，SPA的配置当中呢，你会发现上面就是有一些文档类的说明性的东西啊，这个呢，相当于文档的标题，这叫API documentation，然后这个叫API documentation哈，都一样哈。这个是VR到什么外部API？都一样的是不是啊，好，那都一样，那到底哪个是哪个呢？我们希望呢，就是你一般写文档的时候，你文档怎么也得有个标题啊，对吧，文档标题，然后这个文档的作者是谁是吧？啊，然后这文档是是干嘛的是不是实际上呢，都可以在这个地方进行编辑，只不过这些地方呢，它给了我们一些默认的一些值啊，那我们怎么样去自定义这些值呢？来看在我们的这个代码当中呢，我们可以在这个地方呢，再进一步的去添加我们的这个文档内容，那文档内容我们可能要添加几项哈，所以呢，在下面这个地方呢，来写一个方法啊，来封装一下呃文档描述的一些内容，比如说private API in for，然后呢是in API in for啊。

接下来呢，我们在这个地方。啊，他叫API，然后呢，在这个地方呢，我们可以去调用刚才我们的这个好调用一下啊，调用一下有什么好处呢？就是我们因为想要配置的文档描述的内容挺多的，所以呢，我们就不在这块去写了，把这个部分的内容呢，直接封装到一个方法里面，然后呢，在这个方法里面呢，咱们去创建我们的这个API in for，那怎么去创建呢？这样写啊，New API info builder，这个是一个API文档信息的这么一个构造器啊，然后另利用这个builder下面呢，它会有一系列的方法，比如说我给文档添加一个标题啊，这个呢是上永宝后台管理系统。

API文档啊，然后除了标题之外呢，我们还可以啊定义一些其他的内容，比如说this correction啊，本文的描述了上文榜。后台管理系统的各个模块的。借口，呃，要用好是当然了，我这是象征性的写一下啊，你呢还可以写的更为详细一些，然后接下来呢，我们在这地方可以写的这个文档的版本version，就说这version呢，就是1.6了已经啊，你就写这版本1.6，然后接下来呢，我们还可以写这个这个文档的联系人。

嗯，Contact contact这块的联系人呢，我们可以写联系人的名字啊，网址和邮箱三个信息，所以呢，我们可以在这块这样写，就是new contact，因为信息比较多嘛，所以呢，用一个构造函数啊，把它封装到一个对象，比如说呢叫hele，然后接下来呢，网址3W，然后冒号。3W冒号HTTP啊冒号艾特硅谷点com，然后呢，这邮箱，比如说me艾特艾特硅谷点com，明白吧？啊所以这块呢，就是我们的联系人了，然后接下来呢，我们还可以。写一些其他的内容，那最后写完了之后呢，你再build，这样的话呢，我们整个的这个把对面in for我们就创建出来，创建出来之后呢，我们需要把它呢，直接return回去就行了，因为这个被偶的最终就会返回一个API in这样的一个结果啊好，然后接下来呢，我们嗯，有了这样的一个方法之后呢，我们就可以在这个地方进行调用了，那这个地方调用它怎么调用呢？你不能直接调用，你得用一个方法叫做API info，这个方法里面正好你看它的参数是不是就是这个参数啊，就API ino类型的，所以呢，我们就在这个地方把它填充进去啊，填充到它的参数当中就可以了，所以这块呢，就是我们针对in API的一个具体的配置，那同样的道理，针对下面的这个外边API，我们还可以配置一个差不多的啊，然后接下来呢，这块呢，我们就可以写一个外部API的。

然后这款呢，我们改成。嗯，加上一个是吧。加上一个跟这个差不多的。然后这块呢，改成外的A片是吧，啊这样的话他俩就一套，然后这块呢，上荣宝网站。

API文档。好，那这块呢，是我们的一个关于wer文档啊，描述信息的一个配置啊，我们来重新启一下它。好，已经启动成功了，然后呢，我们来刷新一下。大家看这面呢，就有了这一系列的描述信息，对不对，好，然后呢，我们再切换一下好啊，不同的文档呢，就有他自己不同的描述信息了，所以这块呢，就是我们整个wer这块的内容了。