专门做招商的网站是什么,免费开发软件制作平台,网站自动更新文章,广告公司名称怎么取好目录
1、控制器#xff0c;项目属性里需要勾选输出Xml文档选项#xff1a;
2、下载文档的网页数据
3、运行访问网址
4、接口测试#xff1a;
5、批量测试#xff1a;
6、微服务文档
总结#xff1a; 本篇介绍框架的WebAPI文档与自动化测试
1、控制器#xff0c;项…目录
1、控制器项目属性里需要勾选输出Xml文档选项
2、下载文档的网页数据
3、运行访问网址
4、接口测试
5、批量测试
6、微服务文档
总结 本篇介绍框架的WebAPI文档与自动化测试
1、控制器项目属性里需要勾选输出Xml文档选项 然后针对方法写好注释即可示例
/// summary/// 微服务测试/// /summarypublic class MSController : Controller{/// summary/// Get or Post 测试/// /summary/// param namecustom typeheaderpost 消息/param/// param namemsg requiredtruepost 消息/param/// param namefile typefile文件/param /// returns返回Json数据/returns[HttpGet][HttpPost][MicroService]public void Hello(string msg, System.Web.HttpPostedFile file){if (file ! null){file.SaveAs(file.FileName);}if (Request.UrlReferrer ! null){Write(From : Request.UrlReferrer.ToString() \r\n);}Write(MicroService : MicroService.Config.AppRunUrl Request.Url.LocalPath : Request.HttpMethod : msg ?? Hello MicroService.Config.ServerName);} 类特别说明
1、类必须为Public2、类必须有注释说明否则API文档上会忽略不显示。
方法特别说明
1、type的类型有三种text默认、header请求头、file文件2、必填说明requiredtrue3、请求需要参数可以通过注释新增不一定需要定义为方法参数。
2、下载文档的网页数据
如果是用源码开发的则默认自带如果是自己项目新建引用Nuget的则需要下载点击下载。
说明
对于版本(V3.0.3)会直接打包进Nuget中引用即生成不需要重新下载。
下载后解压到目录下最终目录为
.Net Framework 目录/Views/Doc/.....Net Core 目录/wwwroot/Views/Doc/....
3、运行访问网址
路径为运行路径 /doc 特别说明
如果样式没出来可能是缺少对静态文件的处理补上一条即可
app.UseStaticFiles(); 这里点去找到刚才注释的那个方法 点进详情页 这里就可以看到详细的接口文档。
参数的默认值可以通过注释上初始定义、也可以通过Url的参数如msgxxx来初始也可以通过代码来初始 /// summary/// 全局【方法执行前拦截】/// 启用时先全局再执行局部若存在。/// /summarypublic static bool BeforeInvoke(IController controller, string methodName){if (controller.ControllerName doc){controller.SetQuery(msg, 初始msg参数值。);}return true;} 4、接口测试
可以在上图的示例值中输入参数值在运行请求边上选择请求类型和返回数据类型然后点运行请求 这样就完成轻松的 框架会在浏览器端缓存最后一次输入的请求参数以后后续的测试或批量测试。
5、批量测试
单个接口测试完后返回控制器列表 这里点击RunAll框架会拿最后一次测试的缓存在浏览器中的数据进行批量测试。 这里可以看到批量的请求结果第1个本来也是false。
因为上一次执行的类型写的是json把它改成text执行了一次回来再批量才成true。
6、微服务文档
如果框架做为微服务的注册中心左侧目录则会出现各微服务中心的模块和地址点击即可跳转过去文档中心。
如果其它应用也是Taurus.MVC 开发则很方便如果是其它应用的最好映射到host/doc目录。 说明
当前是最省事的做法后续会考虑直接在当前应用上生成测试文档直接即可访问而不用跳转。
总结
本篇介绍了文档的生成、测试、批量测试与自动化测试。
后续将开启Taurus.MVC 微服务系列教程部署教程。 以下是我收集到的比较好的学习教程资源虽然不是什么很值钱的东西如果你刚好需要可以评论区留言【777】直接拿走就好了 各位想获取资料的朋友请点赞 评论 收藏三连
三连之后我会在评论区挨个私信发给你们~