ASPNET_WEBAPI快速学习02

这部分内容的学习，已经放了大半年时间了，果断补充上，尽早将过去遗留的老技术坑都补上。首先将介绍服务幂等性的概念和相关解决方案，这部分也将是本文的理解难点，由于WebAPI是一种Restful风格服务的实现方式，其遵循HTTP标准方法，因此理解好这部分概念，对于提供良好的业务服务显得非常重要。之后则将介绍SignalR这一长连接通讯的集成解决方案的概念和实践，这部分在交互式的Web场景中非常有效。最后将补充Owin、IOC、EnterpriseLibrary等相关知识，这些也都是.NET程序员比较容易忽视的知识点，这些知识在快速搭建Solution上有很大的帮助。

最早接触这个概念还是在一次面试的过程中，当时记得自己只能是通过卖萌将这一概念一笔带过，由于当时的项目实践相对较少，且被微软便捷的服务搭建所欺骗，以为搭建一个webService只用在IDE中添加有一个.asmx就万事大吉了，其他项目通过一个服务引用就算是SOA实现了（WCF额外需要配置一下终结点），其实对于整个服务的概念完全是个门外汉。

那么在实际中，搭建一个服务需要注意那些问题呢？接下来通过一个简单的表格来描述。

接下来将详细介绍服务幂等性的概念，相关解决方案和基于HTTP协议的服务幂等性等知识。

基础概念：从抽象代数的角度，幂等Idempotence就是f(f(x)) = f(x)。也就是说对同一个服务的1次或多次调用，返回的结果相同，且对服务系统的影响相同，接下来通过一个非常简单的图来描述该概念在服务请求场景下的意义。

在上图中，第一次扣款请求成功，但返回丢失，这是Client重发扣款请求，之后成功。在这样的场景下，如果不控制服务的幂等性，就会出现重复扣款的情况出现。

解决方案：上例标准的解决方案是，客户端的这个操作需要两个请求，首先需要向服务端申请一个ticket进行扣款操作，之后将该ticket作为参数的一部分发送给Server请求扣款。服务端首先检验该ticket是否已经被使用，若被使用，直接返回成功；若未被使用，则进行相应扣款操作。逻辑上很简单，不过在实践时有几点需要注意：

基于HTTP协议的服务幂等性：在之前的表格中，已介绍过CRUD操作所对应的幂等级别，那么对应到HTTP的操作呢？很简单，GET表示查询操作，PUT和DELETE表示更新和删除操作，POST表示插入操作，因此POST操作需要添加幂等控制的。当然了，在WebAPI的实际设计中，接口的URL格式和http报文中Body的参数值会需要进一步的思考。

此外，大家也可以查阅博主Todd Wei的博文http的幂等性http://www.cnblogs.com/weidagang2046/archive/2011/06/04/idempotence.html

SignalR这个名字，咋一看还挺高大上的，实际上和WCF、AJAX类似，并不是什么新技术，而是对已有技术的一种整合，集成了客户端和服务端的库。不知道大家还记不记的，大学时学习的Windows网络编程，当时通过WinSocket搭建了一个聊天室，其实这里的SignalR也一样，最常见的应用仍然是聊天室场景，不过变成浏览器和服务器之间，而不是过去的Client与服务器之间。那么它与H5的WebSocket有什么区别么？准确来说，SignalR整合了WebSocket，在浏览器支持H5的情况下就使用WebSocket，若不支持，就通过长轮训的方式，算是一种兼容性的整体解决方案。

简单来说，记住一点就好，SignalR支持双向通信的长连接，其是对http请求-响应模式的有力补充。其提供一个简单的API用于创建服务端到客户端的远程过程调用(RPC),以便从服务器端.NET代码中调用客户端浏览器中的js代码。

SignalR的API包含两种客户端和服务器之间进行通信的模型：永久连接和Hubs。。接下来通过来通过一段代码，走进SignalR的世界。

 1 前端页面
 2 @{
 3 ViewBag.Title = "Chat";
 4 }
 5 
 6 <h2>Chat</h2>
 7 <div class="container">
 8 <input type="text" id="message" />
 9 <input type="button" id="sendmessage" value="Send" />
10 <input type="hidden" id="displayname" />
11 <ul id="discussion"></ul>
12 </div>
13 @section scripts{
14 <script src="~/Scripts/jquery.signalR-2.2.0.min.js"></script>
15 <script src="~/signalr/hubs"></script>
16 <script>
17 $(function () {
18 //reference the auto-generated proxy for the hub
19 var chat = $.connection.chatHub;
20 chat.client.addNewMessageToPage = function (name, message) {
21 //add the message to the page
22 $('#discussion').append('<li><strong>' + htmlEncode(name) + '</strong>: ' + htmlEncode(message) + '</li>');
23 };
24 //get the user name and store it to prepend to messages.
25 $('#displayname').val(prompt('Enter your name:', ''));
26 //set initial focus to message input box
27 $('#message').focus();
28 //start the connection
29 $.connection.hub.start().done(function () {
30 $('#sendmessage').click(function () {
31 chat.server.send($('#displayname').val(), $('#message').val());
32 $('#message').val('').focus();
33 });
34 });
35 });
36 
37 //this optional function html-encodes messages for display in the page
38 function htmlEncode(value) {
39 var encodedValue = $('<div/>').text(value).html();
40 return encodedValue;
41 }
42 </script>
43 }
44 
45 Startup文件
46 [assembly: OwinStartup(typeof(Sory.Framework.SignalRDemo.Startup))]
47 namespace Sory.Framework.SignalRDemo
48 {
49 public class Startup
50 {
51 public void Configuration(IAppBuilder app)
52 {
53 //Any connection or hub wire up and configuration should go here
54 app.MapSignalR();
55 }
56 }
57 }
58 
59 Hub文件
60 public class ChatHub : Hub
61 {
62 public void Send(string name, string message)
63 {
64 Clients.All.addNewMessageToPage(name, message);
65 }
66 }

相关学习可以参见张善友大神的4年前的博文SingalR QuickStart, http://www.cnblogs.com/shanyou/archive/2012/07/28/2613693.html

另外还有博主will_晓柠的博文http://www.cnblogs.com/vance/p/SignalR.html，相对版本更新一些，此外其翻译的Signal入门非常的赞，必须顶http://files.cnblogs.com/files/wanliwang01/SignalR2.0.pdf

简单来说，类似J2EE中javaWeb的相关标准（servlet），之后各种不同的容器厂商均可以针对该接口提供自己的实现，比如Tomcat、Weblogic等。随着微软慢慢走向开发，也提出了相应的接口标准，这个标准就是Owin，我们常见的IIS其实就是该标准的一个官方实现。记得身边的一位大牛说过，JAVA就是先自己开发，其他的厂商也模仿着开发，之后为了统一就建立标准，之后的版本大家都按照这个标准来，类似于实践推导出理论，理论再来指导实践的过程。

在Owin中，将不再使用ASP.NET管道处理请求，而是使用Owin管道来处理请求，其通过一个Dictionary来传递上下文信息，其信息如下表所示。

Owin接口微软的官方实现叫做Katana（武士刀）的组件包括：Application, Middleware, Server和Host。在vs2013中的MVC5模板中，添加如下DLL，和在nuget中package添加如下配置。

1 <package id="Owin" version="1.0" targetFramework="net451"/>
2 <package id="Microsoft.Owin" version="2.0.0" targetFramework="net451"/>
3 <package id="Microsoft.Owin.Host.SystemWeb" version="1.0" targetFramework="net451"/>
4 <package id="Microsoft.Owin.Security" version="1.0" targetFramework="net451"/>
5 <package id="Microsoft.Owin.Security.Cookies" version="1.0" targetFramework="net451"/>

需要提及的是，其通过一个称为claims-based认证方式进行用户的认证，与原有Form认证方式有一定区别，简单来讲，类似于windows的token认证（单登SSO）。

详细信息，可以参考Jesse博主的博文http://www.cnblogs.com/jesse2013/p/aspnet-identity-claims-based-authentication-and-owin.html#what-is-owin

IOC框架用于解耦系统不同层次间的依赖关系，便于系统的扩展。当然其也会在一定程度上增加系统的复杂性，影响系统的效率，那么选择一个高效可靠IOC显得非常重要。IOC控制反转的相关组件非常的多，包括微软的Unity，第三方的Autofac,CastleWindsor, Spring.NET, StructureMap, Ninject等，其中Unity表现的中规中矩，在大量迭代情况下（>1000000），Autofac和StructureMap效率最高。就我个人而言，由于公司的组件库支持Unity,那么就不用选了，哈哈。

详情请见Leepy大神的博文：http://www.cnblogs.com/liping13599168/archive/2011/07/17/2108734.html

微软的企业库包含的模块非常多，比如缓存、数据存取、日志、IOC、AOP、异常处理等，由于现代企业往往都提供统一的日志管理系统和DAL系统，因此微软企业库仍然有价值的部分为AOP和IOC等部分，其实都是面向切面的应用（我们常用的WCF、MVC、WebAPI项目由于拦截器的存在，已经实现了AOP），当然在一部分做的最好的应该是Spring。

接下来通过一个示例，来对AOP的应用，有一个基本的了解（通过Unity的Interception扩展）。

 1 配置：
 2 <configuration>
 3 <configSections>
 4 <section name="unityInterception" type="Microsoft.Practices.Unity.Configuration.UnityConfigurationSection, Microsoft.Practices.Unity.Configuration"/>
 5 </configSections>
 6 <unityInterception>
 7 <sectionExtension type="Microsoft.Practices.Unity.InterceptionExtension.Configuration.InterceptionConfigurationExtension
 8 , Microsoft.Practices.Unity.InterceptionExtension.Configuration">
 9 <sectionExtension type="Microsoft.Practices.Unity.InterceptionExtension.Configuration.InterceptionConfigurationExtension
10 , Microsoft.Practices.Unity.Interception.Configuration" />
11 <container>
12 <extension type="Interception"/>
13 <register type="LipinInvoice.BL.AOPDemo, LipinInvoice.BL">
14 <interceptor type="TransparentProxyInterceptor" />
15 <policyInjection />
16 </register>
17 </container>
18 </sectionExtension>
19 </unityInterception>
20 </configuration>
21 
22 拦截类
23 public class ExceptionHandler : ICallHandler
24 {
25 public IMethodReturn Invoke(IMethodInvocation input, GetNextHandlerDelegate getNext)
26 {
27 IMethodReturn methodReturn = getNext()(input, getNext);
28 return null;
29 }
30 public int Order { get; set; }
31 }
32 
33 [AttributeUsage(AttributeTargets.Method | AttributeTargets.Interface | AttributeTargets.Class)]
34 public class ExceptionHandlerAttribute : HandlerAttribute
35 {
36 public override ICallHandler CreateHandler(IUnityContainer container)
37 {
38 return new ExceptionHandler() { Order = this.Order };
39 }
40 }

EL6.0官方文档：http://files.cnblogs.com/files/wanliwang01/EL5.0.pdf

EL5.0的详细配置，可以参考博主黄聪的系列教程：http://www.cnblogs.com/huangcong/archive/2010/06/08/1753988.html

还可以参考仓储大叔的博文：http://www.cnblogs.com/lori/p/4088889.html

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

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

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

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

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

参考资料：

1. 蒋金楠. ASP.NET Web API 2框架揭秘[M]. 北京:电子工业出版社, 2014.
2. （美）加洛韦. ASP.NET MVC 5高级编程(第5版)[M]. 北京:清华大学出版社, 2015.