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

2年前 (2022) 程序员胖胖胖虎阿
375 0 0

文章回顾:

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:上节中,还有一个多语言翻译的没有解析,因此下节会先补充多语言翻译内容,同时增加对本节的示例演示内容。

 

一:普通的操作与填充

 

先看如下图:

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

在右上角,有一个带链接的用户名: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);

 

看看:两个方法配合,如何节源节流,先上图:

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

 

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

            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方法实现。

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

 

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

 

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

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

 

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

        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相关使用教程,敬请关注。

 

相关文章

暂无评论

暂无评论...