关闭

C++模板引擎Ctemplate的介绍

标签: 模板引擎c++tablewhitespaceincludegoogle
506人阅读 评论(0) 收藏 举报

    C&C++的模板引擎相对比较少,比较有名的是ClearSilverTeng,他们功能都比较强大,我需要一个轻量级的模板引擎Ctemplate
    ctemplate的设计哲学是轻量级,快速,且逻辑和界面分离,因此和ClearSilver和Teng是有一些差异的。比如Ctemplate就没有模板函数,没有条件判断和循环语句(当然,它可以通过变通的方式来实现)。
1.Ctemplate介绍
    ctemplate大体上分为两个部分,一部分是模板,另一部分是数据字典。模板定义了界面展现的形式(V),数据字典就是填充模板的数据(M),你自己写业务逻辑去控制界面展现(C),典型的MVC模型。
    ctemplate模板中有四中标记,对应的数据字典也有不同的处理方式:

  • 变量,{{变量名}},用两个大括号包含的就是变量名,在c++代码中,可以对变量赋值,任何类型的值都可以(如字符,整数,日期等)。
  • 片断,{{#片断名}},片断在数据字典中表现为一个子字典,字典是可以分级的,根字典下面有多级子字典。片断可以处理条件判断和循环。
  • 包含,{{>模板名}}包含指的是一个模板可以包含其他模板,对应的也是一个字字典。
  • 注释,{{!注释名}},包含注释。

一份演示了完整四种标记的例子如下,

  1. <!--ctexample.tpl-->
  2. <html>
  3. <head>
  4.   <title>{{NAME}}</title>
  5. </head>
  6. {{!This is a example of template.}}
  7. <body>
  8. Hello {{NAME}},
  9. You have just won ${{VALUE}}!
  10. <table>
  11. {{#IN_TABLE}}
  12. <tr>
  13.     <td>{{ITEM}}</td>
  14.     <td>{{TAXED_VALUE}}</td>
  15. </tr>
  16. {{/IN_TABLE}}
  17. </table>
  18. {{>INCLUDED_TEMPLATE}}
  19. </body>
  20. </html>
  21. <!--ctinclude.tpl-->
  22.  <div>
  23. {{INCLUDE_VAR}}
  24. </div>

c++代码如下

  1. #include <stdlib.h>
  2. #include <string>
  3. #include <iostream>
  4. #include <google/template.h>
  5. int main(int argc, char** argv) {
  6.     TemplateDictionary dict("example");
  7.     dict.SetValue("NAME""John Smith");
  8.     int winnings = random() % 100000;
  9.     dict.SetIntValue("VALUE", winnings);
  10.     TemplateDictionary *dict1 = dict.AddSectionDictionary("IN_TABLE");
  11.     TemplateDictionary *dict2 = dict.AddSectionDictionary("IN_TABLE");
  12.     dict1->SetValue("ITEM""Lihaibo");
  13.     dict1->SetFormattedValue("TAXED_VALUE""%.2f", winnings * 0.83);
  14.     dict2->SetValue("ITEM""Qiyuehua");
  15.     dict2->SetFormattedValue("TAXED_VALUE""%.2f", winnings * 0.73);
  16.     if (1)
  17.     {
  18.         dict.ShowSection("IN_TABLE");
  19.     }

  20.     TemplateDictionary *dict3 = dict.AddIncludeDictionary("INCLUDED_TEMPLATE");
  21.     dict3->SetFilename("../tpl/ctInclude.tpl");    
  22.     dict3->SetValue("INCLUDE_VAR","This is a include template.");

  23.      Template* tpl = Template::GetTemplate("../tpl/ctexample.tpl",nwsc::DO_NOT_STRIP);
  24.     std::string output;
  25.     tpl->Expand(&output, &dict);
  26.     std::cout << output;
  27.     Template::ClearCache();
  28.     return 0;
  29. }

注意:

  • 模板字典类似Key和Value的结构,对应的是变量名和值。
  • 片断是可以有多条记录的,如果要显示列表,可以定义为片断,获取多条记录填充到字典中。
  • 片断可以显示,也可以不显示。如果片断的字典有数据,显示。如果片断的字典没有数据,默认是不显示的,可以调用ShowSection来显示。

2.ctemplate高级

  1. Modifier(修改器),意思变量的类型(html,js或者其他),会进行校验和编码处理,比如html类型会将&转换成&amp。类型有html,pre,url query,javascript,css和json。如果觉得在模板变量中定义这些麻烦,可以在加载模板是使用google::Template::GetTemplateWithAutoEscaping()方法,使用自动替换模式,指定是Html,js还是css。你可以编写你自己的modifier,来处理一些特殊的需求。
  2. Strip(清除器),模板中有一些空行和空白字符,在加载时,可以指定参数,是否需要清除。如google::STRIP_BLANK_LINESgoogle::STRIP_WHITESPACE
  3. ExpandEmitter,在ctemplate中有这个接口,这个接口是在展开模板时,输出数据用的,默认实现了std::string版本的StringEmitter,这种方式是处理完毕后,才能发送到客户端,std::string性能并不高。如果你要一个高效率的Web服务器,则可以用流式的模式。比如自己实现ExpandEmitter接口,实现数据流式发送到客户浏览器。
  4. 字典copy,如果两个字典很类似,可以copy一个字典,然后修改,调用dict->MakeCopy()。
  5. Template::ClearCache()这句,正式使用时不要加这句,因为模板只要用过一次,就会缓存起来,ClearCache会加锁,导致性能下降。


    C&C++的模板引擎相对比较少,比较有名的是ClearSilverTeng,他们功能都比较强大,我需要一个轻量级的模板引擎Ctemplate
    ctemplate的设计哲学是轻量级,快速,且逻辑和界面分离,因此和ClearSilver和Teng是有一些差异的。比如Ctemplate就没有模板函数,没有条件判断和循环语句(当然,它可以通过变通的方式来实现)。
1.Ctemplate介绍
    ctemplate大体上分为两个部分,一部分是模板,另一部分是数据字典。模板定义了界面展现的形式(V),数据字典就是填充模板的数据(M),你自己写业务逻辑去控制界面展现(C),典型的MVC模型。
    ctemplate模板中有四中标记,对应的数据字典也有不同的处理方式:

  • 变量,{{变量名}},用两个大括号包含的就是变量名,在c++代码中,可以对变量赋值,任何类型的值都可以(如字符,整数,日期等)。
  • 片断,{{#片断名}},片断在数据字典中表现为一个子字典,字典是可以分级的,根字典下面有多级子字典。片断可以处理条件判断和循环。
  • 包含,{{>模板名}}包含指的是一个模板可以包含其他模板,对应的也是一个字字典。
  • 注释,{{!注释名}},包含注释。

一份演示了完整四种标记的例子如下,

  1. <!--ctexample.tpl-->
  2. <html>
  3. <head>
  4.   <title>{{NAME}}</title>
  5. </head>
  6. {{!This is a example of template.}}
  7. <body>
  8. Hello {{NAME}},
  9. You have just won ${{VALUE}}!
  10. <table>
  11. {{#IN_TABLE}}
  12. <tr>
  13.     <td>{{ITEM}}</td>
  14.     <td>{{TAXED_VALUE}}</td>
  15. </tr>
  16. {{/IN_TABLE}}
  17. </table>
  18. {{>INCLUDED_TEMPLATE}}
  19. </body>
  20. </html>
  21. <!--ctinclude.tpl-->
  22.  <div>
  23. {{INCLUDE_VAR}}
  24. </div>

c++代码如下

  1. #include <stdlib.h>
  2. #include <string>
  3. #include <iostream>
  4. #include <google/template.h>
  5. int main(int argc, char** argv) {
  6.     TemplateDictionary dict("example");
  7.     dict.SetValue("NAME""John Smith");
  8.     int winnings = random() % 100000;
  9.     dict.SetIntValue("VALUE", winnings);
  10.     TemplateDictionary *dict1 = dict.AddSectionDictionary("IN_TABLE");
  11.     TemplateDictionary *dict2 = dict.AddSectionDictionary("IN_TABLE");
  12.     dict1->SetValue("ITEM""Lihaibo");
  13.     dict1->SetFormattedValue("TAXED_VALUE""%.2f", winnings * 0.83);
  14.     dict2->SetValue("ITEM""Qiyuehua");
  15.     dict2->SetFormattedValue("TAXED_VALUE""%.2f", winnings * 0.73);
  16.     if (1)
  17.     {
  18.         dict.ShowSection("IN_TABLE");
  19.     }

  20.     TemplateDictionary *dict3 = dict.AddIncludeDictionary("INCLUDED_TEMPLATE");
  21.     dict3->SetFilename("../tpl/ctInclude.tpl");    
  22.     dict3->SetValue("INCLUDE_VAR","This is a include template.");

  23.      Template* tpl = Template::GetTemplate("../tpl/ctexample.tpl",nwsc::DO_NOT_STRIP);
  24.     std::string output;
  25.     tpl->Expand(&output, &dict);
  26.     std::cout << output;
  27.     Template::ClearCache();
  28.     return 0;
  29. }

注意:

  • 模板字典类似Key和Value的结构,对应的是变量名和值。
  • 片断是可以有多条记录的,如果要显示列表,可以定义为片断,获取多条记录填充到字典中。
  • 片断可以显示,也可以不显示。如果片断的字典有数据,显示。如果片断的字典没有数据,默认是不显示的,可以调用ShowSection来显示。

2.ctemplate高级

  1. Modifier(修改器),意思变量的类型(html,js或者其他),会进行校验和编码处理,比如html类型会将&转换成&amp。类型有html,pre,url query,javascript,css和json。如果觉得在模板变量中定义这些麻烦,可以在加载模板是使用google::Template::GetTemplateWithAutoEscaping()方法,使用自动替换模式,指定是Html,js还是css。你可以编写你自己的modifier,来处理一些特殊的需求。
  2. Strip(清除器),模板中有一些空行和空白字符,在加载时,可以指定参数,是否需要清除。如google::STRIP_BLANK_LINESgoogle::STRIP_WHITESPACE
  3. ExpandEmitter,在ctemplate中有这个接口,这个接口是在展开模板时,输出数据用的,默认实现了std::string版本的StringEmitter,这种方式是处理完毕后,才能发送到客户端,std::string性能并不高。如果你要一个高效率的Web服务器,则可以用流式的模式。比如自己实现ExpandEmitter接口,实现数据流式发送到客户浏览器。
  4. 字典copy,如果两个字典很类似,可以copy一个字典,然后修改,调用dict->MakeCopy()。
  5. Template::ClearCache()这句,正式使用时不要加这句,因为模板只要用过一次,就会缓存起来,ClearCache会加锁,导致性能下降。
本文转自:http://blog.csdn.net/marising/article/details/3069346

0
0

查看评论
* 以上用户言论只代表其个人观点,不代表CSDN网站的观点或立场
    个人资料
    • 访问:137803次
    • 积分:1929
    • 等级:
    • 排名:千里之外
    • 原创:33篇
    • 转载:123篇
    • 译文:0篇
    • 评论:18条
    文章分类
    最新评论