秋色园QBlog技术原理解析：Web之页面处理-内容填充(八)

文章回顾：

1： 秋色园QBlog技术原理解析：开篇：整体认识(一) --介绍整体文件夹和文件的作用

2： 秋色园QBlog技术原理解析：认识整站处理流程(二) --介绍秋色园业务处理流程

3： 秋色园QBlog技术原理解析：UrlRewrite之无后缀URL原理(三) --介绍如何实现无后缀URL

4： 秋色园QBlog技术原理解析：UrlRewrite之URL重定向体系(四) --介绍URL如何定位到处理程序

5： 秋色园QBlog技术原理解析：Module之页面基类设计(五) --介绍创建基类和自定义生命周期

6： 秋色园QBlog技术原理解析：Module之页面基类-生命周期流程(六) --介绍基类生命周期内部业务

7： 秋色园QBlog技术原理解析：Module之基类生命周期-页面加载(七) --介绍界面html加载原理

 

ps：秋色园QBlog下载地址：http://www.cyqdata.com/download/article-detail-427

 

上节，我们解析了页面html是如何被加载并显示的

本节，将接着解析秋色园QBlog中的html的内容是将如何填充。

 

温馨提示：

好多网友表示看不懂本节内容，主要是由于本系列上下节关联性比较大，最好是先了解上节内容，才能更好的阅读和理解本节内容。

另提示：

1：由于本节内容，已跨越到Web.dll的处理范围，因此，把标题修正了一下。

2：上节中，还有一个多语言翻译的没有解析，因此下节会先补充多语言翻译内容，同时增加对本节的示例演示内容。

 

一：普通的操作与填充

 

先看如下图：

在右上角，有一个带链接的用户名：cyqdata

 

正常加载html后，根据ID获取A链接节点，并进行内容填充时，所需要的代码大致为：

        XmlDocument xDoc = new XmlDocument();
        try
        {
            xDoc.Load("xml文件路径");
            XmlNode xNode = xDoc.SelectSingleNode("xpath语法");
            if (xNode != null)
            {
                xNode.InnerText = "秋色园：cyqdata";//用户名填充
                if (xNode.Attributes["href"] == null)//用户名链接填充
                {
                    XmlAttribute attr = xDoc.CreateAttribute("href");
                    xNode.Attributes.Append(attr);
                }
                xNode.Attributes["href"].Value = "http://www.cyqdata.com/";
            }
        }

 

使劲想啊：

一个节点填充，需要写这么长的代码，开发起来那得是何等相当的吃力？

对于Xml操作赋值，还需要考虑使用：<![CDATA[带特殊字符的内容]]>，来解析复杂内容。

 

如果没有一个好的思路来简化这些代码，开发起来不仅吃力，写完后的代码叠起来都得好几本书那么厚。

写的痛苦，看的难受，接手维护的还得赶往富士康接着跳。

 

为解救世人的这些苦难，在好多个日日夜夜后，XmlHelper出世了，它的出现，将这种开发简化到难与想象的地步，大大节省了代码量及提高了开发速度。

 

二：XmlHelper，秋色园镇山之宝

 

上节示例中话说已完成了页面html的加载，接着将分到各ashx处理程序中实现内容填充。

 

且看XmlHelper 出手，填充上面那用户名：

 

方法一：public void Set(string id, SetType setType, params string[] values);

Document.Set("labUserName", SetType.A, "秋色园：cyqdata", "http://www.cyqdata.com/");

用此方法，就一行，够省了吧。[Document是什么？其实就是XmlHelper定义的对象，在上节的示例中，在基类里定义成属性，因此各ashx中可以直接拿到]

介绍：

此方法，仅用于对单个节点填充。而SetType带有很多html标签类型，可根据不同类型选择不同标签。

同时此方法也有几个重载，详细使用，请先看CYQ.Data API文档，后续再写教程文章,敬请关注。

 

当然了，很多时候，值并不是固定的，通常是从数据库读取的较多，为了更好的和CYQ.Data下的MAction系列更好的结合，使出更简洁的用法，终于推出另一个方法：

 

方法二：

public void LoadData(MDataRow row);

public void SetFor(string id, SetType setType, params string[] values);

 

看看：两个方法配合，如何节源节流，先上图：

 

上图，有用户的博客标题和博客简介，还有用户简介，这些都得读数据库，代码如何？

            Document.LoadData(DomainUser);
            Document.SetFor(IDKey.labSpaceName, forAdmin ? SetType.InnerText : SetType.InnerXml);
            Document.SetFor(IDKey.labSpaceIntro, forAdmin ? SetType.InnerText : SetType.InnerXml);
            if (!forAdmin)
            {
                Document.SetFor(IDKey.labCustomCss);
            }

 

这是秋色园中使用的代码，用户前台和后台，加了点小分支。

说明：

SetFor是如何从DomainUser(即MDataRow)中取数据的呢？关键还是约定的ID。

如labSpaceName，默认会读MDataRow中SpaceName字段的值，通过约定，内部最后再调用Set方法实现。

从上面两个方法看出，最终，还是只针对一个节点进行填充。

 

实际上，页面内容，多数是一个列表循环填充出来的。

 

再上一个很传统的列表循环图：

 

如果按传统的思路开发，应该将产生以下形式的代码：

        using (MAction action = new MAction(TableNames.Blog_Content))
        {
            MDataTable table = action.Select();//取得表
            XmlNode tableNode=Document.GetByID("tableID");//拿出table节点
            XmlNode child = tableNode.ChildNodes[0].Clone();//复制一份要循环的tr节点。
            tableNode.RemoveAll();//清除所有子节点
            foreach (MDataRow row in table)//循环行
            {
                XmlNode newTrNode = child.Clone();//复制行一份
               newTrNode.InnerText=row.Get<string>(Content.Title);
                //然后赋第二个值。。第三个值...此处省略27个了
               tableNode.AppendChild(newTrNode);//加载行
            }
        }

 

很勉强的挤出了以上一堆的代码，还是用上了CYQ.Data的MAction才能这么省。

要是用其它框架写代码，那代码不还得往下排着走，试试CYQ.Data，有杀错不放过。

不过，写多了，还是觉得很不可思议。

 

其循环时，处理属性节点较多时，一个循环，那个代码写起来就得上百行了。

你的天啊我的天，再写多几个循环，痛苦莫过于想跳楼还得排队买票再排队那个那个...

为了将世人解救的更彻底些，怀胎十日后终于又生下了一个方法...

 

方法三：

public void LoadData(MDataTable table);

public void SetForeach(string id, SetType setType, params object[] formatValues);

 

介绍：

看着熟悉吧：Set、SetFor、SetForeach，一看就是一个家族的。

少说多做，看下SetForeach如何简化：

            using (MAction action = new MAction(CustomTable.ArticleView))
            {
                Document.LoadData(action.Select());
                Document.SetForeach("tableID", "<li><a href=\"" + Config.HttpHost + "/{0}/article-detail-{1}\" >{2}</a></li>", Users.UserName, Content.ID, Content.Title);
            }

 

看，看，看，知道有多省了吧。

 

不过情况往往是复杂的，在循环的过程中，多数情况需要二次处理？咋整？

这个在秋色园里当然会出现，比如分页控件的样式，就是一种情况。

 

为此，增加一个事件，Document_OnForeach(string text, object[] values, int row)

且看用法：

using (MAction action = new MAction(CustomTable.ArticleView))
            {
                Document.LoadData(action.Select());
                Document.OnForeach+=new XmlHelper.SetForeachEventHandler(Document_OnForeach);
                Document.SetForeach("tableID", "<li><a href=\"" + Config.HttpHost + "/{0}/article-detail-{1}\" >{2}</a></li>", Users.UserName, Content.ID, Content.Title);
            }

        string  Document_OnForeach(string text, object[] values, int row)
        {
          //text就是被循环的标签内容
            //values就是row的值
            //row就是循环到第几行了
            //最后，爱咋处理就咋处理，反正最后 return text;
        }

 

总结：

基于秋色园这种（MVQ[简称MV秋模式]）框架开发的，没有一套杀手锏，那是不成的，那得累死多少壮汗？老板得出多少血？周期得拖多少月？

因此，最好的莫过于借助：Set、SetFor、SetForeach小三口之助，才能开发起来如虎添翼、如梦如幻，如获至宝啊，超高的性价比，超常的理念，试一试，用一用，快乐无比、心花怒放，心血来潮啊。

一切尽在:CYQ.Data （视频）教程地址：http://www.cyqdata.com/cyqdata

CYQ.Data 赞助热线：http://www.cyqdata.com/cyqdata/article-detail-28641

 

下节：将为你解析秋色园QBlog是Post事件原理，同时会出产XmlHelper相关使用教程，敬请关注。