一个用于动态生成静态页面的类——TextTemplate

    动态生成静态页面有许多好处，比如生成html网页有利于被搜索引擎收录。同时，由于减少了数据访问，减轻对数据库访问的压力，提高了网页打开速度。于是自己编写了一个用于动态生成静态页面的类——TextTemplate（名称似乎和静态页面没有关系，这是因为它还有其他功能，这些功能将在下文提及）

笔者之前发布的.net文档生成工具中的页面和编译CHM所需的工程文件(HHP)和内容文件(HHC)都是用这个类生成的。

基本思路：

使用一个字符串作为页面模板，再页面中包含用若干标志（用 {标志名} 表示），生成页面时，将标志替换为对应的值。

实现方法：

在初始化TextTemplate实例时读入模板，以标志为分割点将模板分割成几部分，生成页面时只需简单的将模板内容和标志的值连接起来。例如：

假如有一个模板 ABCD{TAG1}EFG{TAG2}HIJ{TAG3}KMUN

初始化时将模板分割成 "ABCD"，"EFG"，"HIJ"，"KMUN"四个字符串，

假设TAG1=“123”，TAG2=“456”，TAG3=“789”

则生成是相当于执行"ABCD"+"123"+"EFG"+"456"+"HIJ"+"789"+"KMUN"

代码： 

完整代码下载 

using System;
using System.Collections.Generic;
using System.Text;
using System.Text.RegularExpressions;
using System.Collections;
using System.IO;

/// <summary>
/// 表示一个文本模板，该类使用一个字符串作为模板，
/// 通过将模板中的标志替换为对应的值（模板中的标志用{标志名} 表示）生成新的文本
/// </summary>
public class TextTemplate
{
TextTemplateTag[] _tags;
String[] _contentParts;
int _tagCount;

private TextTemplate()
{
_tagCount = 0;
_tags = null;
_contentParts = null;
}

/// <summary>
/// 用指定的模板初始化TextTemplate
/// </summary>
/// <param name="content">模板内容</param>
public TextTemplate(String content);

/// <summary>
/// 用指定的模板初始化TextTemplate,模板内容重文件读入
/// </summary>
/// <param name="file">模板文件位置</param>
/// <param name="encoding">文件使用的编码</param>
public TextTemplate(string file, Encoding encoding);

/// <summary>
/// 读入模板并以标志为分割点分割模板
/// </summary>
/// <param name="content"></param>
private void FromString(String content);

/// <summary>
/// 用指定的值生成文本
/// </summary>
/// <param name="values">各标志对应的值（用标志名作为key）</param>
/// <returns>生成的文本</returns>
public string Render(Hashtable values);

/// <summary>
/// 用指定的值生成文本
/// </summary>
/// <param name="args">各标志对应的值(忽略标志名，第一个标志对应第一个参数，以此类推)</param>
/// <returns>生成的文本</returns>
public string Render(params object[] args);

/// <summary>
/// 用指定的值生成文本，并保存到文件中
/// </summary>
/// <param name="file">要保存的文件路径</param>
/// <param name="encoding">文件的编码</param>
/// <param name="values">各标志对应的值（用标志名作为key）</param>
public void SaveAs(string file, Encoding encoding, Hashtable values);

/// <summary>
/// 用指定的值生成文本，并保存到文件中
/// </summary>
/// <param name="file">要保存的文件路径</param>
/// <param name="encoding">文件的编码</param>
/// <param name="args">各标志对应的值(忽略标志名，第一个标志对应第一个参数，以此类推)</param>
public void SaveAs(string file, Encoding encoding, params object[] args);

/// <summary>
/// 将模板以指定的分隔标志分隔成小模板
/// </summary>
/// 假如有一个模板ABCD{TAG1}EFG{TAG2}HIJ{TAG3}KMUN
/// 调用Split("Tag2")后生成两个模板：
/// ABCD{TAG1}EFG
/// HIJ{TAG3}KMUN
/// <param name="splitTag"></param>
/// <returns></returns>
public TextTemplate[] Split(string splitTag);
}

internal class TextTemplateTag
{
int _position, _length;
string _name;

public TextTemplateTag(string name, int pos, int len)
{
_name = name;
_position = pos;
_length = len;
}

public string Name
{
get { return _name; }
}

public int Position
{
get { return _position; }
}

public int Length
{
get { return _length; }
}
}

实例代码： 

static class Program
{
[STAThread]
static void Main()
{
TextTemplate temp = new TextTemplate("<img src='{src}' alt='{alt}' />");
Console.WriteLine(temp.Render("pic.bmp","Image"));
Hashtable values = new Hashtable();
values.Add("src", "pic.bmp");
values.Add("alt", "image");
Console.WriteLine(temp.Render(values));
}
}

  输出为：

<img src='pic.bmp' alt='Image' />

<img src='pic.bmp' alt='image' />

 其他应用：

TextTemplate还可以用来在安装网站时生成Web.Config文件,只需定义以下模板：

<?xml version="1.0"?>
<configuration xmlns="http://schemas.microsoft.com/.NetConfiguration/v2.0">
<appSettings></appSettings>
<connectionStrings>
<add
name="DJDB.LocalSqlServer"
connectionString="{CONNECTIONSTRING}"
providerName="System.Data.SqlClient"
/>
</connectionStrings>
其他配置
</configuration>

在设置标志 CONNECTIONSTRING 的值即可，这种方法比用XMLDocument类要方便得多。

总结：

TextTemplate的优点有：

1、模板只在初始化时就分析并分割存储，当使用同一模板生成多个页面时，只是简单的件模板内容和标志的值连接起来，不需要每次都去分析模板，如果使用string的Replace方法则每一次都要去分析字符串，而且如果标志值中含有标志，会影响生成的页面。

2、模板可以从文件读入，因此模板文件可以使用各种网页制作工具编辑。

TextTemplate虽然简单，但是功能很多...