成都网站建设设计

将想法与焦点和您一起共享

[水煮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。我们可以在应用程序启动的地方使用自己的类似 SessionHttpControllerRouteHandler的类实例,然后继续注册路由到 HttpConfiguration,同时,这样可以确保每一个 Web API路由都使用了SessionHttpControllerRouteHandler,也就是说所有的路由都可以访问Session。这个简单的代码如清单 1-28所示。

清单 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状态
路径分享:http://chengdu.cdxwcx.cn/article/gojdoi.html