asp.net swagger的使用
最近要从其他系统获取一些数据,准备写个接口让别人把数据塞进来,顺便学习一下如何使用Swagger。
参考大神的教程:asp.net https://mp.weixin.qq.com/s/SHNNQoYF-t8i2j85E1oSYA
asp.net core https://www.cnblogs.com/lhbshg/p/8711604.html
1.创建项目
2.添加NuGet,搜出来好多个,因为不是core项目,先选第一个试试
3.配置,对比了两篇参考的博客,asp.net 和 asp.net core 的流程好像不太一样。
对比一下项目结构,这个是之前练习的时候做的core的。
这个是今天新建的项目,framework的。
Core主要是在Startup.cs编辑 ConfigureServices类和Configure类,分别配置服务和启动Http中间件,具体过程我不贴了,直接进引用链接看吧。
今天主要学怎么用framework。
①Nuget添加完后自动添加的配置文件 SwaggerConfig.cs,里面可以修改版本号。
②创建项目Xml注释文档
右键项目→属性→生成→选中下方的 "XML文档文件" 然后保存
然后下面出了一堆警告,原因是Swagger吧一些接口的方法通过xml文件配置了,这些接口没有注释,可以手动去这些接口敲三个左斜杠/ 添加注释,或者通过配置过滤1591直接无视掉
③配置系统启动的时候,去读取这个xml文件
回到SwaggerConfig.cs 里面,加上这行配置,路径就是前面配置xml文件路径。
c.IncludeXmlComments(string.Format("{0}/bin/AMHS.API.xml", System.AppDomain.CurrentDomain.BaseDirectory));
去Controller里面添加注释后的效果
最新文章
- js 正则表达式 ( 1 )
- 关于 Poco::TCPServer框架 (windows 下使用的是 select模型) 学习笔记.
- MyEclipse/Eclipse新建项目并且部署到服务器(tomcat)下
- Cocos2d-x 3.X手游开发实例详解
- npm换源
- javascript实现图片滚动
- nginx php 安装
- Java面试题:n=2\n1*2*5*6\n--3*4\n\nn=3\n1*2*3*10*11*12\n--4*5*8*9\n----6*7\n如何实现如上结构的数据
- 摄像机(CCCamera)
- 2 weekend110的mapreduce介绍及wordcount + wordcount的编写和提交集群运行 + mr程序的本地运行模式
- Mac使用rz、sz远程上传下载文件
- hibernate spring sturts2配置
- java开发之基础篇2
- validate 表单验证
- PHP页面提示与跳转
- 【Vue】Vue的依赖追踪系统 ——搞懂methods watch和compute
- vxworks下文件读写示例
- PeopleSoft JobSet Schedule Table
- go框架gin的使用
- 关于树莓派HDMI转VGA线接显示器黑屏