从壹开始前后端分离【 .NET Core2.0 +Vue2.0 】框架之四 || Swagger的使用 3.2

  • 时间:
  • 浏览:1

在上一回中大伙提到,大伙直接F5运行项目,出显 了系统默认页,

项目开发中的实体类是怎么还可不可以在Swagger中展示的?

接口虽有,本来却没办法 相应的文字说明?

2、接下来,大伙就须要处理第十个 问题,怎么还可不可以增加文字说明,本来传说中的注释

为什么会直接 F5 运行,首页还是无法加载?

本来本来刚上加的类库中,在Model层项目,属性,中上加xml路径,上加注释(这里的步骤和API项目的上加最好的办法一致,不用的请留言),本来在API项目中上加引用

本来你再一次F5 运行,就会发现不一样了,一点的配置,以及四个多多多部署中的设置,大伙会在四个多多多的文章中后该 提到。

新建四个多多.net core 类库Blog.Core.Model,注意是 .net core的类库

对于接口是怎么还可不可以加权限验证的?

让大伙带着哪哪几只问题,继续浏览下一篇吧,Swagger 3.3 权限

本来F5 运行,都上加了,感觉前端大佬再本来会说看不懂接口了,哈哈哈哈

**设置文件launchSettings.json **了:

注意,必须再HttpGet中,用实体类做参数,会报错

改写注入最好的办法,并在控制器中参数引用

https://github.com/anjoy8/Blog.Core.git

一点四个多多多,先别忙着运行项目,作为老司机的我,只本来改代码可能配置文件,保存后,第一件事本来看看有没办法 错误,一看,咦~~~随便说说 ,随便说说是警告,还还可不可以 强迫症呀,一看还挺多

image

书接上文《从零结束了英文搭建另一方的前后端分离【 .NET Core2.0 Api + Vue 2.0 】框架之三 || Swagger的使用 3.1》,上文中本来简单的对怎么还可不可以使用Swagger作了介绍,本来最后也提出了哪几只问题,这里再重温下那哪几只问题

1、设置swagger ui页面为首页

随便说说还还可不可以 在输入/swagger后,顺利的访问swagger ui页,本来大伙发现每次运行项目,后该默认访问api/values一点接口,已经 已经 已经 将启动页设为swagger(可能是任意四个多多页面),你就须要用到了

接下来结束了英文第四个多多问题:上加实体类说明注释

https://gitee.com/laozhangIsPhi/Blog.Core

别慌!一看,哦!四个多多多是swagger把一点接口最好的办法都通过xml文件配置了,本来四个多多多上文提到的,本来大伙只须要上加最好的办法注释就还还可不可以 辣,还还可不可以 左斜杠/,连续三下即可

现在呢,配置好了xml文件,接下来须要让系统启动的四个多多多,去读取一点文件了,重新编辑Startup.cs,修改ConfigureServices函数:

新建四个多多Love的实体类

dang dang dang,就出来了

对于接口是怎么还可不可以加权限验证的?

右键项目名称=>属性=>生成,勾选“输出”下面的“xml文档文件”,系统会默认生成四个多多,当然老规矩,你也还还可不可以 另一方起四个多多名字