AspNet Core Api Restful +Swagger 发布IIS 实现微服务之旅 (二)

上一步我们创建好CoreApi

接下来在框架中加入 Swagger  并发布  到 IIS

(1)首先点击依赖项》管理Nuget包

AspNet Core Api Restful +Swagger 发布IIS 实现微服务之旅 (二)

(2)输入 Swashbuckle.aspnetCore  比如:

AspNet Core Api Restful +Swagger 发布IIS 实现微服务之旅 (二)

图中两个Swagger 插件需要我们安装   注意:我这里已经安装过显示的是 卸载

 (3) 在框架中 添加Swagger 注解的帮助类   HttpHeaderOperation  下面是我完整的.CS文件

AspNet Core Api Restful +Swagger 发布IIS 实现微服务之旅 (二) View Code

(4) 添加 Swagger 的·服务方法 在  Startup中的  ConfigureServices方法里

AspNet Core Api Restful +Swagger 发布IIS 实现微服务之旅 (二) View Code

(5)添加 Swagger 启动项 在  Startup中的  Configure方法里

AspNet Core Api Restful +Swagger 发布IIS 实现微服务之旅 (二) View Code

(6) 在框架自动生成的 Api 控制器里Post的方法上加入 注解(其他方法也可以,我只是举例)

AspNet Core Api Restful +Swagger 发布IIS 实现微服务之旅 (二) View Code

注解的含义如下

summary 用来描述 方法的作用

remarks 用来描述传入的参数格式/也可以把调用的值放入里面

response 定义两个返回状态

User 类

AspNet Core Api Restful +Swagger 发布IIS 实现微服务之旅 (二) View Code

(7)在框架中   添加 AspNetCoreApiSwagger.xml 文件  一定要注意的是  xml 文件必须定义一个根节点 不然会报错  ,XML的属性   改为 始终复制   (XML文件在 第四步骤中有用到)

AspNet Core Api Restful +Swagger 发布IIS 实现微服务之旅 (二)

AspNet Core Api Restful +Swagger 发布IIS 实现微服务之旅 (二)

(8)设置 项目的生成 输出路径

AspNet Core Api Restful +Swagger 发布IIS 实现微服务之旅 (二)

(9)  发布   以文件夹发布就行

AspNet Core Api Restful +Swagger 发布IIS 实现微服务之旅 (二)

(10)部署IIS 说一下注意点     改成无托管代码

AspNet Core Api Restful +Swagger 发布IIS 实现微服务之旅 (二)

(11)打开IIS服务  中的模块

 

 AspNet Core Api Restful +Swagger 发布IIS 实现微服务之旅 (二)

(12)查看是否有  AspNetCoreModule  没有进行安装 我是在国外的网站下载的

AspNet Core Api Restful +Swagger 发布IIS 实现微服务之旅 (二)

 

(13)  如果在运行部署的API  发生了错误

我们在  Program  中加入  如代码所示  可以帮助我们准确定义的问题所在

AspNet Core Api Restful +Swagger 发布IIS 实现微服务之旅 (二) View Code

 

OK  今天就完成了,

 

以后会描述一下 框架的基础知识  比如  应用程序的启动、日子、路由、静态文件、WebSockteS  等,

等到基础描述过后,在框架中加入一些我闷在实战中用到的,希望大家多多指出错误不足之处,这是我的学习。

 

补充一下显示结果,开始的时候忘记截图了

AspNet Core Api Restful +Swagger 发布IIS 实现微服务之旅 (二)

 

 

有人在实践中遇到了没有注释的问题

在启动的时候

 注意这里 XML名称是否错误

AspNet Core Api Restful +Swagger 发布IIS 实现微服务之旅 (二)

代码中读取的注释信息在 AspNetCoreApiSwagger.xml中,项目启动后会把注释信息生成到AspNetCoreApiSwagger.xml中

AspNet Core Api Restful +Swagger 发布IIS 实现微服务之旅 (二)

上一篇:VMware虚拟机下WIN7无法联网的解决方式


下一篇:AcWing98 分形之城 (递归)