前言:
前些天有网友提到了那个界面丑陋的SwaggerUI,让我想起了多年前实现的WebAPI文档未完成的功能点,于是,动手了,便有了本文的内容。
开源地址:https://github.com/cyq1162/Taurus.MVC
1、WebAPI 文档集成测试功能(增强说明)
开启WebAPI文档:web.config 或 appsettings.json
设置:"IsStartDoc": true
即可通过/doc访问自动生成的WebAPI文档
1、过滤掉无描述的接口。
文档自动生成的来源来自项目中的Xml文档注释
为了能更好的控制显示的结果,不带注释的类或方法(只收录public),不会被收录显示。
2、参数的显示与执行测试说明
自动和成的参数,来自以下方法的注释:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 | /// <summary> /// 获取Token /// </summary> /// /// <param name="un" required="true" value="13488889999">用户名</param> /// <param name="pwd" type="header">密码</param> /// <param name="upload" type="file">图片上传</param> /// <returns>{success:true:msg:"tokenString..."}</returns> [HttpGet, Require( "un" , true , RegexConst.Mobile), Require( "pwd" )] [HttpPost] public void GetToken( string un, string pwd) { //is required. is invalid. 判断 是否:中文 //CheckFormat("{0}不能为空&{0}格式错误", @"un&用户名&^1[3|4|5|8][0-9]\d{8}$", @"pwd&密码&^[\u0391-\uFFE5]+$"); //string userName = Query<string>("un"); //string pwd = Query<string>("pwd"); if (! string .IsNullOrEmpty(un) && ! string .IsNullOrEmpty(pwd)) { byte [] data = System.Text.Encoding.UTF8.GetBytes( "Taurus:" + un); string base64 = Convert.ToBase64String(data); Write(base64, true ); } else { Write( "UserName or Password Error" , false ); } } |
其中:
1 | required 决定是否必填 true 或 false (时可不写) |
1 | type 决定显示的文本框类型 header(请求头) file(文件上传) 其它(时可不写) |
1 | returns 显示返回的结果。<br><br><br> |
3、运行测试结果
可修改请求路径、请求参数、请求类型。
点击执行运行结果:
系统会自动收集参数并执行,返回结果及请求头的内容。
2、附加<%# JS执行功能语法 %>
为了实现这个自动测试功能,顺路增加了该语法功能。
在/Views/Doc/detail.html 中,有这样一段html代码:
<tbody id="ParaView" clearflag="1"> <tr> <td width="80px">{0}</td> <td>{1}</td> <td> <%# ${required}?'是':'否'%> </td> <td><%# '${type}'=='file'?'文件':('${type}'=='header'?'请求头':'${type}')%></td> <td> <![CDATA[ <input name="{0}" type="<%# '${type}'=='file'?'file':'text'%>" value="{4}" style="width:90%" rtype="${type}" <%# ${required}?'required="required"':'false'%> /> ]]> </td> </tr> </tbody>
其中 ${索引或属性名} 是之前就有的绑定语法。
为了方便html中对于简单的判断的文字变更,思考之后,把<%# 这里的内容都会被JS引擎执行 %>语法块功能给加上了。
细节说明:
由于模板是xhtml语法要求,对于不符合xml语法的地方,可以用
<![CDATA[ ...]]> 包含起来。
结束说明:
1、本次版本更新主要就是以上两点功能。
2、由于net core 下支持 <%# %>语法,引用了Microsoft.ClearScript.dll(这个最低支持是3.1),所以netcore的默认版本调高到3.1(因找到了可替换库Z.Expressions,netcore的版本依赖降回2.0 2020-06-12)
版权声明:本文原创发表于 博客园,作者为 路过秋天 本文欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接,否则视为侵权。 |
个人微信公众号![]() |
Donation(扫码支持作者):支付宝:![]() |
Donation(扫码支持作者):微信:![]() |
![]() |
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】凌霞软件回馈社区,博客园 & 1Panel & Halo 联合会员上线
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】博客园社区专享云产品让利特惠,阿里云新客6.5折上折
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· 一个奇形怪状的面试题:Bean中的CHM要不要加volatile?
· [.NET]调用本地 Deepseek 模型
· 一个费力不讨好的项目,让我损失了近一半的绩效!
· .NET Core 托管堆内存泄露/CPU异常的常见思路
· PostgreSQL 和 SQL Server 在统计信息维护中的关键差异
· CSnakes vs Python.NET:高效嵌入与灵活互通的跨语言方案对比
· DeepSeek “源神”启动!「GitHub 热点速览」
· 我与微信审核的“相爱相杀”看个人小程序副业
· Plotly.NET 一个为 .NET 打造的强大开源交互式图表库
· 上周热点回顾(2.17-2.23)
2018-05-07 IT连创业系列:微信公众号策略调整
2010-05-07 Solaris 10 x86 Mono 三次折腾准备休战了