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

上一步我们创建好CoreApi

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

（1）首先点击依赖项》管理Nuget包

（2）输入 Swashbuckle.aspnetCore  比如：

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

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

 

（4） 添加 Swagger 的·服务方法 在  Startup中的  ConfigureServices方法里

 

（5）添加 Swagger 启动项 在  Startup中的  Configure方法里

 

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

 

注解的含义如下

summary 用来描述 方法的作用

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

response 定义两个返回状态

User 类

 

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

（8）设置 项目的生成 输出路径

（9）  发布   以文件夹发布就行

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

（11）打开IIS服务  中的模块

 

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

（13）  如果在运行部署的API  发生了错误

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

 

OK  今天就完成了，

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

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

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

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

在启动的时候

 注意这里 XML名称是否错误

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