[水煮ASP.NETWebAPI2方法论](1-8)添加Session状态
问题
专注于为中小企业提供成都网站制作、做网站服务,电脑端+手机端+微信端的三站合一,更高效的管理,为中小企业隆化免费做网站提供优质的服务。我们立足成都,凝聚了一批互联网行业人才,有力地推动了上千多家企业的稳健成长,帮助中小企业通过网站建设实现规模扩充和转变。
ASP.NET Web API构建 Web应用程序时,要求使用 Session在服务器存储一些用户特定的信息
解决方案
ASP.NET Web API不支持 Session,因为 API根本不依赖于System.Web。他想试图摆脱伪造 Session,非 HTTP这样的概念。
然而,如果我们在 ASP.NET运行时中运行 ASP.NET Web API,还想启用Session。我们可以通过两种方式来做:
全局:应用于整个API
局部:应用于指定路由
启用全局方式,我们需要在 Global.asax中通过SesssionStateBehavior.Required显示的设置启用Session行为。
protected void Application_PostAuthorizeRequest() { HttpContext.Current.SetSessionStateBehavior(SessionStateBehavior.Required); }
启用指定路由(局部方式),我们可以通过过使用路由处理器,让路由处理器继承自IRequiresSessionState。然后,我们可以在指定的路由上附加处理器,这个就在请求指定路由的时候启用了 Session。
工作原理
默认的 ASP.NET Web API模板,会帮我们在WebApiConfig静态类中使用 HttpConfiguration定义默认路由,因为,框架附带的扩展方法是支持我们使用 System.Web.RouteCollection,在定义 MVC路由的地方定义 Web API路由。
虽然 MapHttpRoute的多个重载方法经常被使用,但是这些重载方法都是void(无返回值)方法,实际上,方法还是返回了一个最新声明路由的实例,只是方法的调用结果一般都是被抛弃掉的。在使用 Syste.Web.RouteCollection直接定义路由的情况下,返回值是 System.Web.Route的对象,我们可以将其赋值给 IrouteHandler。
当运行在 ASP.NET的时候,ASP.NET Web API框架使用同样的机制来确保 Api请求可以准确到达,他会赋值 HttpControllerRouteHandler给每一个 Web API路由,HttpControllerRouteHandler是 GetHttpHandler方法返回的一个HttpControllerHandler实例,这是 ASP.NET Web API管道的入口点。HttpControllerHandler(WEB API的核心)虽然很复杂,但是究其原理也就是一个传统的 IHttpAsyncHandler(旧的 IHttpHandler的一个异步的版本)。
我们可以通过实现IRequiresSessionState的接口,来强制在 IHttpHandler中使用 Session。ASP.NET将会显示的为每一个实现了这个接口路由启用 Session。
另外要在全局范围内调用 HttpContext.Current.SetSessionStateBehavior方法和传递 SessionStateBehavior,需要为当前的HttpContext显示的启用 Session。SetSessionStateBehavior方法必须在 AcquireRequestState事件之前调用。
代码演示
继承两个类:
HttpControllerHandler
HttpControllerRouteHandler
我们将创建两个自定义类
SessionHttpControllerHandler:实现 IRequiresSessionState
SessionHttpControllerRouteHandler:只是代替默认类型,来充当返回 SessionHttpControllerHandler的工厂
如清单 1-26所示。
清单 1-26.定制HttpControllerHandler和 HttpControllerRouteHandler
public class SessionControllerHandler : HttpControllerHandler, IRequiresSessionState { public SessionControllerHandler(RouteData routeData) : base(routeData) { } } public class SessionHttpControllerRouteHandler : HttpControllerRouteHandler { protected override IHttpHandler GetHttpHandler(RequestContext requestContext) { return new SessionControllerHandler(requestContext.RouteData); } }
现在我们需要将我们的注意力从WebApiConfig类转移到 RouteConfig类,因为我们需要执行 RouteCollection。接下来,我们应该在创建路由的时候,将 SessionHttpControllerRouteHandler赋值给 RouteHandler。如清单 1-27所示。
清单 1-27. 在System.Web.RouteCollection中注册Web API路由
public static void RegisterRoutes(RouteCollection routes) { routes.IgnoreRoute("{resource}.axd/{*pathInfo}"); //Web API routes.MapHttpRoute( name: "DefaultApi", routeTemplate: "api/{controller}/{id}", defaults: new { id = RouteParameter.Optional } ).RouteHandler = new SessionHttpControllerRouteHandler(); //MVC routes.MapRoute( name: "Default", url: "{controller}/{action}/{id}", defaults: new { controller = "Home", action = "Index", id = UrlParameter.Optional } ); }
如果想激进一点,还是有其他的方式来执行这个功能的。不再需要跑到RouteConfig中注册 Api的路由,而是需要使用 WebApiConfig中的 HttpConfiguration做一些必要的处理,可以同样达对所有 Web API路由启用 Session。
当我们通过Web API的配置注册路由的时候,路由是被注册在 RouteTable中,同时,使用一个单利 HttpControllerRouteHandler.Instance处理器来处理路由。这样,我们可以让 ASP.NET所有调用转到Web API路由,进入到 Web API的管道。这里说到的单例其实就是一个 Lazy
清单 1-28. 配置 Session
public static class WebApiConfig { public static void Register(HttpConfiguration config) { var httpControllerRouteHandler = typeof(HttpControllerRouteHandler).GetField("_instance", BindingFlags.Static | BindingFlags.NonPublic); if (httpControllerRouteHandler != null) { httpControllerRouteHandler.SetValue(null, new Lazy(() => new SessionHttpControllerRouteHandler(), true)); } config.Routes.MapHttpRoute( name: "DefaultApi", routeTemplate: "api/{controller}/{id}", defaults: new { id = RouteParameter.Optional } ); config.MapHttpAttributeRoutes(); } }
现在,我们需要证明这个起作用了,需要做一个简单模拟掷骰子的ApiController例子。首先,生成一个 1到 6之间的随机数,将 Session中上一次的值使用当前投掷的值赋值。
清单 1-29.使用Session的 ApiController简单例子
public class DiceResult { public int NewValue { get; set; } public int LastValue { get; set; } } public class DiceController : ApiController { public DiceResult Get() { var newValue = new Random().Next(1, 7); object context; if (Request.Properties.TryGetValue("MS_HttpContext", out context)) { var httpContext = context as HttpContextBase; if (httpContext != null && httpContext.Session != null) { var lastValue = httpContext.Session["LastValue"] as int?; httpContext.Session["LastValue"] = newValue; return new DiceResult { NewValue = newValue, LastValue = lastValue ?? 0 }; } } return new DiceResult { NewValue = newValue }; } }
值得注意的是,我们刚刚获取的HttpContext是从 HttpRequestMessage属性字典中通过“MS_HttpContextkey”获取的。这个比直接从System.HttpContext.Current中获取更具可测性。
博客园:http://www.cnblogs.com/shuizhucode/
51 CTO:http://shuizhucode.blog.51cto.com/
本文题目:[水煮ASP.NETWebAPI2方法论](1-8)添加Session状态
链接URL:http://pwwzsj.com/article/gojdoi.html