[聚合文章] 使用Asp.net core webAPI + Swagger搭建web服务的步骤以及问题点

c# 2017-07-21 21 阅读

在下从毕业到现在一直都是用微软的技术栈去开发东西。

asp.net core发布也有一段时间了,一直没有去系统的关注一下,最近得闲准备用core的webapi做点东西,也遇上了一些小问题,就把这些东西都记录下来。

1.创建工程:
这就没什么可说了,创建工程这个用VS再简单不过了,我选的是Api的选项。
core创建web工程会把entityframework直接放到依赖项当中,这个也不必细说。

2.配置swaggerui
启动工程之后,还是bootstrap的界面,api方法描述也只是描述不能交互,这点还是挺不方便的。
好在swagger也是可以应用在.net上的。

如何配置swagger
https://docs.microsoft.com/en...
微软的这篇文章记述的也是很明白了,大家按图索骥即可。

有个细节需要注意一下
就是当大家配置好之后


有可能会出现这种500的错误,就是加载api描述json失败,遇到这种情况,第一反应是要到

console里面去找信息,反正我遇到的情况就是controller当中方法共用了一个api地址
导致识别api错误。

在这提个醒,下面是正常的图像。

3.关于EntityFramework
到这一步基本上事儿办的就差不多了,但是还有一个问题,就是这种情况下,数据库还是没有准备的状态
所以如果在这种情况下,对数据库进行读写操作那就是500等着你。

那么现在应该干什么呢。

照我说的做就OK

1.在工程文件中加入我画框的这句话

<DotNetCliToolReference Include="Microsoft.EntityFrameworkCore.Tools.DotNet" Version="1.0.0" />

2.在此工程文件夹下启动cmd,执行 dotnet ef migrations add InitialCreate指令

3.用nuget给工程加入Microsoft.EntityFrameworkCore.Tools类库,这样咱们就能在PMC当中,输入操作db的指令了

4.执行Update-datebase
成功之后,环境基本就OK了,就可以继续开发了。

如果这篇文章对您有帮助,我深表荣幸。

注:本文内容来自互联网,旨在为开发者提供分享、交流的平台。如有涉及文章版权等事宜,请你联系站长进行处理。