Web Control 开发系列(二) 深刻解析Page的PostBack过程和IPostBackDataHandler

IPostBackDataHandler和IPostBackEventHandler对于实现一个WebControl是很是重要的，若是你的 Contro仅仅是readonly的，也就是说不会让客户端进行输入和修改，那么这两个接口就没有用，一旦你要和客户端交互，那么这两个接口是必须掌握的。IPostBackDataHandler可让你的Control和客户端的输入数据进行交互，好比TextBox，CheckBox，而 IPostBackEventHandler可让你的Control和客户端的动做行为进行交互，好比Button（click行为）。若是你既但愿接收客户端的数据，也但愿接收客户端的行为，那么就要同时实现这两个接口了。
       在个人上一篇文章《页面的生命周期》里面，我详细介绍了页面生存周期的各个阶段，可是对于PostBack阶段介绍的并非不少，在本文里面我将详细补充介绍页面生存周期的PostBack 阶段，由于IPostBackDataHandler，IPostBackEventHandler仅仅发生在页面生存周期的PostBack阶段。其实咱们能够在PostBack作不少的事情，.net Framework认为大多数用户都但愿处理Post回来的数据和事件，因此基于这个目的，他们为咱们设计了IPostBackDataHandler和 IPostBackEventHandler这两个接口，这仅仅是微软的一个设计，因此没有什么特别神秘的。咱们只要很好的理解他们的设计，就能让咱们的 Control无缝的和全部基于.net Framework实现的其它Control协同工做。下面我将一步一步分析这两个接口的实现。

1、Page是什么？
      当在Visual Stdio里面new一个Page的时候，生成的代码以下：
  

<% @ Page Language="C#" AutoEventWireup="true" CodeBehind="Default.aspx.cs" Inherits="WebApplication1._Default"  %>

<! DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd" >

< html  xmlns ="http://www.w3.org/1999/xhtml"   >
< head  runat ="server" >
     < title > Untitled Page </ title >
</ head >
< body >
     < form  id ="form1"  runat ="server" >
     < div >
    
     </ div >
     </ form >
</ body >
</ html >

    从代码能够看出来，Page输出到客户端，它的内容区域就是在一个ＨＴＭＬ的<form>元素。因此咱们在页面上放的 TextBox，CheckBox，Button，还有不少的第三方的WebControl，它们都是在form元素里面的，最后输出到客户端，就会变为嵌入在<form>里面的Html节点，若是节点为input，这些都会变为表单的字段，例如<Input type="button" ...>,<Input type="text" ...>,<Input type="hidden" ...>.这里有一点值得注意的是，.net Framework经常会把ViewState，EvntTarget等一些须要在客户端保存的数据都做为一个type为hidden的input元素放在form里面。为何这样作呢？由于<form>元素是一个很特殊的HTML元素。下面说说form：
    form做为Html的一个元素，它就是为了客户端提交数据而产生的，它有两个很重要的属性action和method，action属性指明了处理提交的数据的应用程序的URL，而method有两个值：POST，GET，由于浏览器提交数据老是使用HTTP（也有使用HTTPS）协议，而 POST，GET则是HTTP协议传输数据的方式，因此method指明了传输数据的方式，对于一个新的Page所生成的html代码，form老是method=" POST"的方式提交数据（缘由也有不少，好比数据安全性比Get高）：以下

<! DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd" >

< html  xmlns ="http://www.w3.org/1999/xhtml"   >
< head >< title >
    Untitled Page
</ title ></ head >
< body >
     < form  name ="form1"  method ="post"  action ="Default.aspx"  id ="form1" >
         < div >
            < input  type ="hidden"  name ="__VIEWSTATE"  id ="__VIEWSTATE"              value ="/wEPDwUJNzgzNDMwNTMzZGQP0LJECgTtp1lOdVaW3IZPFDdsYw=="   />
         </ div >

         < div >    
         </ div >
     </ form >
</ body >
</ html >

form上面全部的HTML规范定义的表单域(form field)元素，一旦具备name属性，在form进行submit的时候，form field(例如<input type ="text"..>)里面的数据都会自动被收集，而后按照必定的编码方式（如何编码？也有好多种啊，能够在form上设置，没空说了）进行编码，而后发给action定义的URL进行处理。
       前面介绍了那么多关于form的知识，就是为了咱们更好的理解Page的postback处理过程。因此说Page的核心就是一个Html 的<form>元素，它发生提交的时候老是以Post的方式把收集到的form field的值返回。具体关于<form>元素和Http协议，各位能够Google出不少的东西，这里就不详细说了。

2、Page的Post处理过程
       当页面处理一个Http Post请求的时候，它会把form传回来数据进行解码，存入一个NameValueCollection的对象里面，咱们能够经过 Request.Form来观察，这个存储结构比较相似于Hashtable，传入form field的name获得它的值。有了收集回来的post数据，就能够进行处理了。主要有两个Post的处理过程（参见《页面的生命周期》）：一个在Init 阶段结束后，另外一个在Load阶段后。ProcessRequest函数的代码片断以下：
      
       

//  1. PreInit
         this .PerformPreInit();
         //  2. Init
         this .InitRecursive( null );
         this .OnInitComplete(EventArgs.Empty);

         //  对于Postback,插入下面处理
         if  ( this .IsPostBack)
         {
            // 加载ViewState和ControlState，进行场景恢复
            this.LoadAllState();
            // 第一次处理PostData
            this.ProcessPostData(this._requestValueCollection, true);
        }

         //  3. PreLoad
         this .OnPreLoad(EventArgs.Empty);
         //  4. Load
         this .LoadRecursive();

         //  对于Postback，插入下面处理
         if  ( this .IsPostBack)
         {
            // 第二次处理PostData
            this.ProcessPostData(this._leftoverPostData, false);
            // 若是PostData表面某个Control数据发生变化，那么RaisePostDataChanged事件
            this.RaiseChangedEvents();
            // RaisePostBackEvent
            this.RaisePostBackEvent(this._requestValueCollection);
        }

         this .OnLoadComplete(EventArgs.Empty);

   
3、IPostBackDataHandler怎么工做的？
            这个接口有两个方法：LoadPostData()和RaisePostDataChangedEvent(), 每每LoadPostData（）会先被调用，若是返回true，那么表明数据发生变化，RaisePostDataChangedEvent()就会被调用，这样一个完整的Web Control的event就发出来了，例如TextBox的TextChanged就是这样发的。

            先来分析Page页面是如何在请求处理函数里面来调用实现了IPostBackDataHandler接口的Control的，这个实现主要在Page的ProcessPostData函数，具体分析以下：
  

private   void  ProcessPostData(NameValueCollection postData,  bool  fBeforeLoad)
         {
            // 1. 用一个全局变量_changedPostDataConsumers来保存PostData发生
            //    变化的Control全部这些Control都要调用RaistPostDataChangedEvent()
            if (this._changedPostDataConsumers == null)
            {
                this._changedPostDataConsumers = new ArrayList();
            }


            // 2. postData保存的是Form上的表单字段的value，能够经过表单字段的name的索引
            if (postData != null)
            {
                foreach (string str in postData)
                {
                    // 对于系统定义的表单字段，直接跳过，例如:__VIEWSTATE
                    if ((str == null) || IsSystemPostField(str))
                    {
                        continue;
                    }

                    // 得到这个表单字段对应的Control
                    Control control = this.FindControl(str);
                    if (control == null)
                    {
                        // 3. 这个标记为true，表明是在Load阶段前的调用，为false表明是
                        //    在Load阶段后的调用其实这只是防止有些Control在Load阶段前
                        //    尚未建立，因此在Load阶段后进行再一次调用而第二次调用
                        //    处理的数据都是本次调用所没法处理的数据，本次成功处理的
                        //     Control，第二次调用都不会继续处理了。
                        if (fBeforeLoad) 
                        {
                            if (this._leftoverPostData == null)
                            {
                                this._leftoverPostData = new NameValueCollection();
                            }
                            this._leftoverPostData.Add(str, null);
                        }
                        continue;
                    }
                    
                    // 程序走到这里，control不为null，由于若是为null，上面就continue了

                    // 4. 取control.PostBackDataHandler或者PostBackEventHandler能够理
                    //    解为把control as为IPostBackDataHandler 或者 IPostDataEventHandler
                    //    （注：真实逻辑还取adaper，但仅仅是为了Adapter机制，咱们这里不用考虑）
                    IPostBackDataHandler postBackDataHandler = control.PostBackDataHandler;
                    if (postBackDataHandler == null)
                    {
                        // 5. 若是没法取到PostBackDataHandler,可是能够取得PostBackEventHandler，
                        //    那么注册它。这个操做致使在后面的RaisePostBackEvent()函数会调用
                        //    这个control的IPostBackEventHandler.RaisePostBackEvent()                        
                        if (control.PostBackEventHandler != null)
                        {
                            this.RegisterRequiresRaiseEvent(control.PostBackEventHandler);
                        }
                    }
                    else
                    {
                        // 6. postBackDataHandler不为null的时候，就调用它的LoadPostData()函数，
                        //    若是返回结果为true,那么把该control加入_changedPostDataConsumers
                        //   （见注释1），这样在后面的RaiseChangedEvent里面就会依次从集合
                        //    _changedPostDataConsumers里面取出control，而后调用
                        //    control.RaisePostDataChangedEvent()
                        if ((postBackDataHandler != null) && 
                            postBackDataHandler.LoadPostData(str, this._requestValueCollection))
                        {
                            this._changedPostDataConsumers.Add(control);
                        }

                        // 7. 若是这里处理了，就从_controlsRequiringPostBack集合从删除当前control
                        //    的id，避免二次处理，实际上本函数就是处理两个集合，一个是传入的postData
                        //    集合，另外一个就是下面这个_controlsRequiringPostBack集合。这个集合里面的
                        //    control都是经过page的RegisterRequiresPostBack(Control control)方法注册
                        //    进去的，这个集合会做为ControlState的一个附加字段存储，这样
                        //    LoadAllState的时候能够很好恢复。（见注释8）
                        if (this._controlsRequiringPostBack != null)
                        {
                            this._controlsRequiringPostBack.Remove(str);
                        }
                    }
                }
            }

            // 8. 下面开始处理_controlsRequiringPostBack集合里面的control
            ArrayList list = null;
            if (this._controlsRequiringPostBack != null)
            {
                foreach (string str2 in this._controlsRequiringPostBack)
                {
                    Control control2 = this.FindControl(str2);
                    if (control2 != null)
                    {
                        // (见注释4）
                        IPostBackDataHandler handler2 = control2.PostBackDataHandler;
                        if (handler2 == null)
                        {
                            throw new HttpException(SR.GetString("Postback_ctrl_not_found", new object[] { str2 }));
                        }

                        // （见注释6），对于PostBackData变化的Control加入
                        //  _changedPostDataConsumers集合
                        if (handler2.LoadPostData(str2, this._requestValueCollection))
                        {
                            this._changedPostDataConsumers.Add(control2);
                        }
                        continue;
                    }
                    else
                    {
                        // control2为null，因此没法处理，加入集合，等待Load阶段后的调用处理（见注释3）
                        if (fBeforeLoad)
                        {
                            if (list == null)
                            {
                                list = new ArrayList();
                            }
                            list.Add(str2);
                        }
                    }
                }
                this._controlsRequiringPostBack = list;
            }
        }

   对于Page注册的_controlsRequiringPostBack是如何保持到ControlState的，能够参考下面的代码片断：

        private   void  SaveAllState()
         {
            if (this._needToPersistViewState)
            {
                // 1. 把ControlState存储到dictionary里面
                .

                // 2. 把注册的须要PostBack处理的Control的id集合加入到用来保存ControlState
                //    的dictionary里面
                if ((this._registeredControlsThatRequirePostBack != null) && (this._registeredControlsThatRequirePostBack.Count > 0x0))
                {
                    dictionary.Add("__ControlsRequirePostBackKey__", this._registeredControlsThatRequirePostBack);
                }
                
                // 3. 收集ViewState
                .
                // 4. 把全部的State序列化到Page页面的hidden字段
                .
            }
        }

  经过上面的代码，我这里作一个小结：若是要写一个实现IPostBackDataHandler的Control，除了实现接口自己外，还必须作到下面两种方法的一种，才能够顺利完成任务：
  第一种：该Control Render出来的元素自己就是一个表单域(form field)，并且表单域的name和control的id保持一致，这样，Page在拿到表单域的数据后，能够经过name调用FindControl来找到相应的Control，而后若是Control.PostBackDataHandler 不为null，就进入调用入口。
 第二种：该Control存放数据的表单域的name和该control的id并无对应的关系，因此就须要在PreRender的时候（也能够在其它阶段，如Load等,不过大部分是在PreRender里面作），调用Page.RegisterRequiresPostBack(Control control) 方法，传入this做为参数，这样也能够保证Page会遍历全部注册过的Control，而后进入IPostBackDataHandler的调用入口。
   综上所述，PostBackData，就是在客户端的一个数据缓存，当用户在客户端修改的时候，都是修改的数据缓存，不会和服务器通讯，只有当form submit的时候，一次PostBack发生，而后缓存的数据会被form收集并传输到服务器端，服务器端就调用IPostBackDataHandler来处理传回的数据。