动易模板解析引擎使用外部组件实战.docx

模板解析引擎使用外部组件实战

引言
随着08年3月SiteFactoryCMS正式版的发布，动易网络正式拉开了下一代网站管理应用的序幕，并提供了一个高度的稳定、灵活、安全、易用的管理环境。
08年12月，动易网络正式发布了SiteFactory2.0以及BizIeda2.0版本，这是一个更加重要的升级和里程碑版本。
毫无疑问，你已经知道SiteFactory独创的Xpower模板解析引擎聚合了紧密相关的多种技术，彻底改变了传统模板解析的不足和局限性。而标签解析引擎是SiteFactory中最重要的部件，你要用它去转换数据至Web呈现。
SiteFactory的用户很容易对标签解析引擎技术感兴趣，毫不夸张的说，SiteFactory的Xpower引擎是针对转换数据呈现最为完整的技术平台。Xpower引擎输出页面的每一个字节都交给了用户进行控制、多种数据源的支持、丰富的函数库。本教程将讲述Xpower引擎对外部组件的支持。

读者对象
本教程是针对有一定服务端Web开发知识的开发者。本教程没有完整的描述教程所涉及到的每一个细节，否则，那样可能是好几本书的大辞典（比如如何去写C#代码）。相反，本教程为开发者提供精练的Xpower引擎对外部组件的技术介绍，而这类读者基本上都不想去重复那些最基本的概念。在阅读本教程的过程中，你要关注的是需要用来构建专业网站管理应用程序SiteFactory的Xpower模板解析引擎技术。
为了更好的理解本教程，你最好熟悉C#语法，XSLT转换以及面向对象的概念。如果你熟悉Java或者C++但没有用过.NET。否则你可能需要同时考虑阅读一些介绍.NET的书籍。
学习本教程的硬件和软件环境
你需要一个安装有VisualStudio（也可以选择免费SharpDeveloper、VisualStudioWebDeveloperExpress）、SiteFactory2.0的电脑来配合阅读本教程。虽然理论上说你可以手写代码，但这是极其乏味的，并且极易出错，所以在专业环境下从来不用这种方法。
客户支持
我们非常重视读者的反馈，我们也希望能了解你对本教程的看法——哪些是你喜欢的地方，哪些是你不喜欢的地方，还有你希望我们应该在下次改进的地方，以及你更希望关注SiteFactory哪方面的教程，甚至是你觉得标签解析引擎在哪里需要改进。你可以至bbs.powereasy.net（动易官方论坛）参与讨论。
示例代码
在本教程的末尾有与本教程配套的示例代码，在使用这些代码之前，需要解压缩下载文件。本教程的示例代码项目版本为VisualStudio2008你可能需要相应或者更高的版本来打开。
模板解析引擎使用外部组件实战
建立类库项目：
如下图所示，在新建项目对话框，模板选择类库，指定名称，这里命名为Components（组件之意）完成后点确定。

VisualStudio会自动创建一个项目并且包含一个Class1.cs的文件，对这个文件单击右键将其重命名为MyUtils.cs，并且在此文件中的MyUtils类中键入下面的代码：
///<summary>
///返回字符串真实长度,1个汉字长度为2
///</summary>
///<returns>字符长度</returns>
publicstaticintGetStringLength(stringstr)
{
returnEncoding.Default.GetBytes(str).Length;
}
此主题如下：

（注意：示例源代码中包含了数十个有用的方法，简繁体转换，比较时间差等等，本教程重点在教授如何在SiteFactory标签解析引擎中使用外部组件，而非教授大家如何去编写C#代码。）
编译组件，并将组件复制到SiteFactory站点根目录下的bin文件夹中
配置站点根目录下Config文件夹中的ConsumerExtensionObject.config文件。
打开此文件后会发现这就是一个xml文件，结构良好并且严谨。下面是对属性的释义：
<Object>标签对：为注册一个外部程序集所必要的配置节
Assembly程序集：此为组件的名称，比如范例中编译完成的Components.dll
className类名：只有通过类名才能反射到类中所包含的方法
xmlns命名空间：浅显的可理解为名字空间就是给文档做一个标记
按照上文罗列的释义，配置适应刚才编译的Components.dll文件，配置代码如下：
<Objectassembly="Components"className="Components.MyUtils"xmlns="MyUtils"/>
配置标签模板
随意新建立一个标签，类型选择简单XSLT解析，不需要任何参数，下一步到标签内容编辑面板，在X