ASP.NET MVC中如何实现TempData


本篇主要讨论ASP.NET MVC中TempData是如何实现的,通过研读MVC的源代码你将清楚的了解MVC是如何实现TempData功能的。

  TempData特性

  TempDataDictionary与ITempDataProvider

  TempDataDictionary的设计

  SessionStateTempDataProvider与ITempDataProvider

  TempData特性Top

  TempData的特性就是可以在两个Action之间传递数据,它会保存一份数据到下一个Action,并随着再下一个Action的到来而失效。所以它被用在两个Action之间来保存数据,比如,这样一个场景,你的一个Action接受一些post的数据,然后交给另一个Action来处理,并显示到页面,这时就可以使用TempData来传递这份数据。

  那到底TempData是怎样完成这个功能的呢?下面我们从MVC的源代码入手来解析TempData的机制。

  TempDataDictionary与ITempDataProviderTop

  首先来看看ITempDataProvider接口,从字面意思上看我们先把它翻译为:暂时数据的提供者所遵从的规则,它约定了两个方法:

  public interface ITempDataProvider

  {

  IDictionary LoadTempData(ControllerContext controllerContext);

  void SaveTempData(ControllerContext controllerContext, IDictionary values);

  }

  这两个方法是LoadTempData和SaveTempData,我们猜想这两个方法是用来取得TempData容器和保存TempData数据的,因为LoadTempData返回一个IDictionary类型,而SaveTempData没有返回类型,而参数ControllerContext就是针对不同的用户上下文来设计的,标明是对那一个上下文的TempData进行操作。的确是这样的,后面会验证我们的猜想。

  再来看看TempDataDictionary,我们对这个类的第一印象在哪里呢?是在ControllerBase类中的TempData属性,在普通的Controller中我们打上tempdata,vs帮助我们完成的那个属性其实就是ControllerBase类中的TempData。因此我们明白了,不管是在controller中,还是在view中,所有对TempData的操作都是对TempDataDictionary类型的操作。那ITempDataProvider有是怎么与TempDataDictionary联系的呢?看一下TempDataDictionary的设计便一目了然。

  TempDataDictionary的设计Top

  public class TempDataDictionary : IDictionary<string, object>, ISerializable

  这是TempDataDictionary的签名,我们看到它继承了一个IDictionary<string,object>的字典类型和一个ISerializable的接口。因此我们知道它是可以被序列化和反序列化的,该类有一个常字符串类型的字段和一个Dictionary<string,object>类型的字段:

  internal const string _tempDataSerializationKey = "__tempData";  internal Dictionary<string, object> _data;

  在它带参的构造函数中发现了对_tempDataSerializationKey的使用:

  protected TempDataDictionary(SerializationInfo info, StreamingContext context)

  {

  _initialKeys = new HashSet<string>(StringComparer.OrdinalIgnoreCase);

  _modifiedKeys = new HashSet<string>(StringComparer.OrdinalIgnoreCase);

  _data = info.GetValue(_tempDataSerializationKey, typeof(Dictionary<string, object>))

  as Dictionary<string, object>;

  }

  我们可以看到这是用来从一个流中,反序列化得到一个Dictionary类型的过程。

  另一点,在controller中,我们可以这样使用TempData的:

  TempData["msg"] = new Object();  Object obj = TempData["msg"] as object; 在了解它的索引器之前我们先看看它的几个字段和方法,TempDataDictionary类重要的字段有三个:

  internal Dictionary<string, object> _data;  private HashSet<string> _initialKeys;  private HashSet<string> _modifiedKeys; _data用来存放真正的数据,_initialKeys用来存放原先数据的key,_modifiedKeys用来存放修改过或新添加的数据key。为什么要这样呢?回想一下TempData的特性,TempData只存放一次数据,到第三个Action时,第一个Action存放的数据就失效了,所以,_initialKeys被设计来存放那些数据是原来的,_modifiedKeys被设计来存放那些数据是修改过的或是新添加上的,这样就区分了“旧”数据和“新”数据,那下一步就是把“旧”的删除,把“新”的记录了。

  我们再到索引器看看,因为我们对TempData的操作是从索引器开始的,下面是索引器的代码:

  public object this[string key]

  {

  get

  {

  object value;

  if (TryGetValue(key, out value))

  {

  return value;

  }

  return null;

  }

  set {

  _data[key] = value;

  _modifiedKeys.Add(key);

  }

  }

  当我们TempData["msg"]=new Object();时不仅向_data中添加了数据,同时_modifiedKeys也保存了“新”数据的key。那什么时候“新”数据被保存“旧”数据被删除,真正的执行呢?这个过程是在Load和Save方法中发生的。下面看它们的具体实现:

  public void Load(ControllerContext controllerContext, ITempDataProvider tempDataProvider)

  {

  IDictionary<string, object> providerDictionary = tempDataProvider.LoadTempData(              controllerContext);      _data = (providerDictionary != null) ? new Dictionary<string, object>(providerDictionary,

  StringComparer.OrdinalIgnoreCase) : new Dictionary<string, object>

  (StringComparer.OrdinalIgnoreCase);

  _initialKeys = new HashSet<string>(_data.Keys);

  _modifiedKeys.Clear();

  }

  public void Save(ControllerContext controllerContext, ITempDataProvider tempDataProvider)

  {

  if (_modifiedKeys.Count > 0)

  {

  // Apply change tracking.

  foreach (string x in _initialKeys)

  {

  if (!_modifiedKeys.Contains(x))

  {

  _data.Remove(x);

  }

  }

  // Store the dictionary

  tempDataProvider.SaveTempData(controllerContext, _data);

  }

  }

  我们看到TempDataDictionary的Load方法首先是调用了ITempDataProvider的LoadTempData方法来获取tempdata容器,然后让_initialKeys等于_data.Keys,相当于保存了“旧”数据的key,然后清空_modifiedKeys,相当于目前没有“新”数据。而Save方法则是检查_modifiedKeys.Count是否大于0,就相当于检查是否有“新”数据,有则调用ITempDataProveder的SaveTempData方法保存掉“新”数据。这里也验证了我们先前的猜想是正确的。

  说到这里,我们似乎还没有发现没有一个地方调用TempDataDictionary的Load和Save方法,也就是说“新”“旧”数据一直在都在_data中,似乎“旧”的数据没有真正删除,“新”数据也一直没有一个安定的家。

  我们说对TempData中数据的“刷新”操作(刷新操作即把“旧”数据删除,把“新”数据保存)应该发生在执行Action的时候,那在什么地方我们执行了Action呢,是在IController的Execute方法中,IController<=ControllerBase<=Controller,顺着这样的继承顺序,我们找到Controller类的ExecuteCore方法,这里是执行Action的地方,下面我们看看ExecuteCore方法的实现:

  protected override void ExecuteCore()

  {

  TempData.Load(ControllerContext, TempDataProvider);

  try {

  string actionName = RouteData.GetRequiredString("action");

  if (!ActionInvoker.InvokeAction(ControllerContext, actionName))

  {              HandleUnknownAction(actionName);

  }

  }

  finally

  {

  TempData.Save(ControllerContext, TempDataProvider);

  }

  }

  我们看到在这里,Action执行之前TempData.Load,Action执行之后TempData.Save。这就实现了TempData的“刷新”操作。

  SessionStateTempDataProvider与ITempDataProviderTop

  到这里,我们发现似乎还不知道到底数据是怎么被保存的,我们只知道ITempDataProvider提供了一个保存数据和获取容器的这么一个约定,那么具体的实现肯定是继承了ITempDataProvider接口的类来做,SessionStateTempDataProvider就是这么一个类。

  我们知道是在Controller类中的ExecuteCore方法中执行了“刷新”操作,我们还知道TempDataDictionary的Load和Save方法需要一个ITempDataProvider的方法,那么我们可以推断肯定要去Controller类中寻找ITempDataProvider的实现。如我们所料:

  public ITempDataProvider TempDataProvider {

  get {

  if (_tempDataProvider == null)

  {

  _tempDataProvider = new SessionStateTempDataProvider();

  }

  return _tempDataProvider;

  }

  set {

  _tempDataProvider = value;

  }

  }

  这里使用了属性注入,强硬的注入了一个SessionStateTempDataProvider对象。那么具体是怎样实现存储的就要去看一下SessionStateTempDataProvider类了。

  SessionStateTempDataProvider有一个常字符串字段:

  internal const string TempDataSessionStateKey = "__ControllerTempData"; 下面是LoadTempData方法:

  public virtual IDictionary LoadTempData(ControllerContext controllerContext)

  {

  HttpContextBase httpContext = controllerContext.HttpContext;

  if (httpContext.Session == null)

  {

  throw new InvalidOperationException(

  MVCResources.SessionStateTempDataProvider_SessionStateDisabled);

  }

  Dictionary<string, object> tempDataDictionary = httpContext.Session[TempDataSessionStateKey]                                                          as Dictionary<string, object>;

  if (tempDataDictionary != null)

  {

  // If we got it from Session, remove it so that no other request gets it

  httpContext.Session.Remove(TempDataSessionStateKey);

  return tempDataDictionary;

  }

  else

  {

  return new Dictionary<string, object>(StringComparer.OrdinalIgnoreCase);

  }

  }

  上面的代码很简单,原来它把Dictionary类型的数据存进了Session["__ControllerTempData"]里,读的时候也只是简单的类型转换一下就返回了。

  下面是SaveTempData方法:

  public virtual void SaveTempData(ControllerContext controllerContext, IDictionary values)

  {

  HttpContextBase httpContext = controllerContext.HttpContext;

  if (httpContext.Session == null)

  {

  throw new InvalidOperationException(

  MVCResources.SessionStateTempDataProvider_SessionStateDisabled);

  }

  httpContext.Session[TempDataSessionStateKey] = values;

  } SaveTempData方法也很简单。

  总结Top

  ITempDataProvider只是一个提供临时数据存取的一个约定的接口,它并不提供如何管理“新旧”数据,TempDataDictionary类才是真正管理“新旧”数据的管理者,但是这个“管理者”需要一个存取“新旧”数据的途径,也就是说它告诉ITempDataProvider该存什么该取什么,然后由ITempDataProvider真正的去执行存取操作。在Controller执行Action之前,这个“管理者”要取得上一次的“旧”数据,Action结束之后它还要把“新”数据给存起来。而Controller恰似这么一个“指挥者”,它把一个能做ITempDataProvider事情的类——SessionStateTempDataProvider交给TempDataProvider使用。下面用一个类图概括一下几个类的关系


« 
» 
快速导航

Copyright © 2016 phpStudy | 豫ICP备2021030365号-3