WebApi系列(从.Net 到 .Net Core)【更新】

一. 简介

1. 什么是WebApi？

　　WebApi是一个很广泛的概念，在这里我们特指.Net平台下的Asp.Net WebApi框架，它是针对各种客户端(浏览器、APP等)来构建Http服务的一个框架，它是一种RestFul风格的开发接口的技术，它比WebService更省流量，比WCF更简单。下图表示WebApi在.Net平台下的地位。

　　简单分析：WebForms、MVC均为ASP.NET下的Web开发框架，WebAPI负责构建HTTP常规服务，SignalR负责构建实时服务。（个人观点：Web Page就是能在浏览器上显示的文档（一般是指html文档，当然一些如word，pdf等也可算Web Page）的总称；Web Form是一种特殊的，能用控件进行快速开发的Web Page）

　　WebAPI和MVC简单对比一下：WebAPI是专注于接口开发，更专业，用户不会直接和WebApi打交道，因此WebApi也不会生成界面，当然我们完全可以使用MVC来开发接口，甚至一般处理程序(HttpHandler)

2. WebApi的功能特点

(1). 支持RestFul风格的的请求，即可以通过 Get、Post、Put、Delete请求CRUD操作，不需要暴露更多的API。

(2). 方法的返回值可以直接返回对象，专注于数据。

(3). 独立于IIS部署(selfhost、winform、控制台)。

(4). 方法可以直接声明为async。

(5). 支持MVC大部分功能，但和MVC在路由、Filter、ModelBinder等方面都有一些区别.(这里指.Net FrameWork)。

3. WebApi和MVC的区别

(1). MVC主要用来构建网站，所以既关心数据又关心页面，而WebApi主要用来构建接口，所以只关心数据。

(2). WebApi支持Self Host，即独立于IIS部署，MVC不支持。（.Net Core 下的MVC是支持的）

(3). WebApi通过请求方式来区分请求哪个接口，MVC则需要通过Action的名字来确定。

(4). WebApi位于System.Web.Http命名空间下，而MVC位于System.Web.Mvc命名空间下，所以二者在路由、Filter、ModelBinder等方面都有一些区别。

(5). WebApi更轻量更适合构建App的接口服务。

(6). Web API支持格式协商，客户端可以通过Accept header通知服务器期望的格式。

4. WebApi和WCF的取舍

(1). 如果服务需要支持One Way Messaging/Message Queue/Duplex Communication，选择WCF

(2). 如果服务需要在TCP/Named Pipes/UDP (wcf 4.5)，选择WCF

(3). 如果服务需要在http协议上，并且希望利用http协议的各种功能，选择Web API

(4). 如果服务需要被各种客户端(特别是移动客户端)调用，选择Web API

二. Restful

1. 什么是RestFul风格的接口？

(1).调用者不再根据方法名称区分请求方法，而是通过请求方式进行区分,将所有的操作都抽象成对资源的增删改查。

　即：新增用Post请求，查询用get请求，修改用put请求，删除用delete请求。

(2).请求的路径中将不在出现方法名称

(3).用Http的返回状态码表示服务器端的处理结果，eg：找不到用404、没有权限返回201，不在需要自己约定状态码。

(4).有利于系统优化，浏览器可以自动缓存Get请求。

2. RestFul风格的弊端

　　理论性太强，很容易把初学者搞晕，比如如何通过状态码区分是"账号错误"还是"密码错误"？比如"登录"属于什么操作？再比如一个控制器里有两个方法 GetM1() 和 GetM2(), 两个方法中都没有参数值，这种情况如何通过请求方式来区分呢？再比如下面的GetStudets(string str) 和 GetTeachers(string str) 方法，参数名都是str，所以无法区分（可以把其中一个参数名改为str2，就不冲突了，或者通过别的路由规则声明一下，或者给标注个非Get请求的标记，比如[HttpPost]总之很麻烦）

三. 系列章节

第一节：WebApi的纯原生态的RestFul风格接口和路由规则介绍

第二节：如何正确使用WebApi和使用过程中的一些坑

第三节：总结.Net下后端的几种请求方式(WebRequest、WebClient、HttpClient)

第四节：跨域请求的解决方案和WebApi特有的处理方式

第五节：WebApi的三大过滤器

第六节：WebApi的部署方式(自托管)

第七节：WebApi与Unity整合进行依赖注入和AOP的实现

第八节：常见安全隐患和传统的基于Session和Token的安全校验

第九节：JWT简介和以JS+WebApi为例基于JWT的安全校验

第十节：进一步扩展两种安全校验方式

第十一节：WebApi的版本管理的几种方式