快速入门系列--WebAPI--04在老版本MVC4下的调整

标签：group   添加   img   基础上   升级   .net 4.0   问题   host   json   

WebAPI是建立在MVC和WCF的基础上的，原来微软老是喜欢封装的很多，这次终于愿意将http编程模型的相关细节暴露给我们了。在之前的介绍中，基本上都基于.NET 4.5之后版本，其System.Net.Http程序集非常的丰富，而老版本的则相对较弱。在WebAPI v1.0(和ASP.NET MVC4在一起的版本)很多的类和接口并不存在，同时对Task异步编程（ApiController默认提供异步执行方法）的支持还有一些欠缺（缺少不少方便的扩展方法），在使用时会有一些需要注意的地方，由于一些老的项目用的.NET 4.0的程序集，无法升级和使用一些新的dll，因而部分功能需要自己来考虑，本文旨在将自己遇到的一些困难分享给大家。

在Global.asax文件中需要注意WebApi的路由要先于MVC的路由进行注册，不然会出现路由无效的情况。

前端路由地址的提供，使用@Url.HttpRouteUrl("AddedApi", new { controller = "SMSCenterApi", action = "MassTexting" })来生成路由，与MVC的方式有一些差异，需要注意。

包括ModelBinder和MediaTypeFormatter两种方式，与MVC不同（MVC均使用ModelBinder进行绑定）。前者包括针对数组、集合、字典、简单和复杂类型的绑定器，后者其实就是一个序列化器，默认包括3中：Json.NET的json序列化器（用的最多）；DataContractSerializer和XMLSerializer用于序列化XML；最后一种解码表单URL，编码主体数据。这些格式化器均在System.Net.Http.Formatting命名空间中。

相关的特性包括：ModelBindingAttribute，默认绑定逻辑；FormUriAttribute，只从Uri获取值；FromBodyAtrribute，使用MediaTypeFormatter媒体格式化器，也是我们在WebAPi最常用的，再次提醒一下，一定要提供contentType哦，比如"application/json"。

Tip:模型绑定常见问题，WebAPI的格式化器Formatter需要提供相应的contentType才会起作用，返回值通过dataType设置（默认为XML），一定不能忘记内容协商,需要注意内容协商，附上一个ajax调用的例子，我在这也吃了很大的亏，默认formatter其实做了很多事情哦。

这儿强烈提醒的是dataType表示返回值类型，contentType为请求体的类型，熊二你个二货，内容协商是必须的，不然别人哪知道怎么做!此外，这个的dataType=‘json‘最终反应到http请求体中为Accept: application/json,

这个对于你使用过滤器拦截并新建httpMessageResponse的HttpContent时非常有用，最后的例子会涉及这部分内容。

• 过滤请求

过去我们常常将一些验证逻辑和异常处理逻辑放在Controller中，极大的增加了Controller的复杂性，完全可以通过面向切面（AOP）来处理，在.NET 4.0提供的相关基类和接口如下所示：

Tip: 在MVC4中，推荐使用同步基类，在以后的版本中推荐使用异步接口对应用程序进行扩展。

此外，需要注意过滤器的使用范围，包括：全局，在FilterConfig中添加；类级别过滤器，通过添加特性的方式；方法级别过滤器。

默认提供AuthorizeAttribute完成基础验证，AllowAnonymousAttribute提供匿名验证的情况。此外还提供一个关于OData的第三方解决方案，包括可以自动支持OData查询语法的QueryableAttribute（如$top和$filter等）。

• 其他小知识点

WebAPI的托管，包括通过System.Web.Http.WebHost.dll的IIS托管，配置对象为GlobalConfiguration；自托管的配置，通过Mocrosoft.AspNet.WebApi.Selfhost。

可以通过HttpConfiguration.Service获取IApiExplorer服务，即全领域搜索可用服务。

通过ITraceWriter来跟踪应用程序，可以很方便的和ETW、Log4net、ELMAH等跟踪服务集成。

• 简单示例程序，包括过滤器的使用，JQuery的调用，请求的简易验签

Controller:

 View Code

Jquery调用:

 View Code

CheckPremissionFilter:

 View Code

SMSTokenHelper:

 View Code

Tip: DES加密部分借鉴博主IT合伙人文章http://www.cnblogs.com/IT-haidong/p/4856848.html

最后，补充一个在MVC4.0下的自定义ModerBinder,非常的简单，但可以帮助实现json数据的绑定，简化使用。当然使用JQuery的form.serialize()，将数据转化为form提交，然后应用默认的绑定器也是ok的。以前一直form提交也没有认真去想想form的区别，其实form是用"&"符号来连接数据的。

 View Code

此外，WebAPI学习系列目录如下，欢迎您的阅读！

快速入门系列--WebAPI--01基础

快速入门系列--WebAPI--02进阶

快速入门系列--WebAPI--03框架你值得拥有

快速入门系列--WebAPI--04在老版本MVC4下的调整

参考资料：

1. （美）加洛韦. ASP.NET MVC 4高级编程(第4版)[M]. 北京:清华大学出版社, 2012.

快速入门系列--WebAPI--04在老版本MVC4下的调整

标签：group   添加   img   基础上   升级   .net 4.0   问题   host   json   

原文地址：http://www.cnblogs.com/zhangyubao/p/7008829.html