使用 acl_cpp 的 HttpServlet 类及 google 的 ctemplate 库编写 WEB 应用

      文章《用C++实现相似于JAVA HttpServlet 的编程接口》中讲述了如何使用 acl_cpp 库之 HTTP 模块编写象 Java Servlet 同样的 WEB 应用。其中也讲到了 acl_cpp HTTP 模块中有关 Http Session、Cookie 的使用方法。而做为 WEB 编程中很是重要的网页模板引擎在 acl_cpp 并未实现。本文将结合谷歌的 ctemplate 库,讲解如何使用 acl_cpp 的 WEB 类库和谷歌的 ctemplate 模板引擎库来实现相似于 Java Servet + Velocity 的 WEB 应用。固然,用户也能够根据须要使用其它的模板引擎,如:CTPP(俄罗斯人写的)、Teng。关于 C++ 的模板引擎能够参考 《基于C++的模板引擎》。html

      1、HTML 模板:test.htmc++

 

<!--test.htm-->
<html>
<head>
   <title> {{NAME}} </title>
</head>
{{!This is a example of template.}}
<body>
SID: {{SID}} <br>
COOKIE: {{COOKIE}} <br>
PARAM: {{PARAM}} <br>
<br>
Hello {{NAME}},
You have just won ${{VALUE}}!
<table border=1>
  {{#IN_TABLE}}
  <tr>
    <td> {{ITEM}} </td>
    <td> {{TAXED_VALUE}} </td>
  </tr>
  {{/IN_TABLE}}
</table>
<br>
{{!Include child template.}}
{{>INCLUDED_TEMPLATE}}
</body>
</html>  

 

      下面是内嵌在 test.htm 中的子模板:include.htmgit

 

<!--include.htm-->
<div>
{{INCLUDE_VAR}}
</div>

 

      ctemplate 模板说明(摘自 marising 的《C++模板引擎Ctemplate的介绍》,该文中还有关于 ctemplate 更为高级的说明):github

 

      ctemplate大致上分为两个部分,一部分是模板,另外一部分是数据字典。模板定义了界面展示的形式(V),数据字典就是填充模板的数据(M),你本身写业务逻辑去控制界面展示(C),典型的MVC模型。web

      ctemplate模板中有四中标记,对应的数据字典也有不一样的处理方式:编程

      1)变量,{{变量名}},用两个大括号包含的就是变量名,在c++代码中,能够对变量赋值,任何类型的值均可以(如字符,整数,日期等)。浏览器

      2)片段,{{#片段名}},片段在数据字典中表现为一个子字典,字典是能够分级的,根字典下面有多级子字典。片段能够处理条件判断和循环。服务器

      3)包含,{{>模板名}}包含指的是一个模板能够包含其余模板,对应的也是一个字字典。cookie

      4)注释,{{!注释名}},包含注释。session

 

 

       2、使用 ctemplate 库来替换 test.htm 模板中的参数,同时将子模板 include.htm 包含进 test.htm 中,功能实现以下:

 

#include <string>
#include "ctemplate/template.h"

using namespace ctemplate;

// 打开模板文件将其中的标记进行替换,而后生成 HTML 页面

bool create_html(std::string* out, const char* sid,
	const char* cookie, const char* param)
{
	// 调用 google ctemplate 模板引擎生成页面

	// 建立父模板
	TemplateDictionary dict("example");

	// 设置模板中的参数值
	dict.SetValue("SID", sid ? sid : "null");
	dict.SetValue("COOKIE", cookie ? cookie : "null");
	dict.SetValue("PARAM", param ? param : "null");
	dict.SetValue("NAME", "John Smith");
	int  winnings = rand() % 100000;
	dict.SetIntValue("VALUE" , winnings);

	// 设置模板中的片段

	// 建立表格:10 行
	for (int i = 0; i < 10; i++)
	{
		TemplateDictionary *dict1 = dict.AddSectionDictionary("IN_TABLE");
		dict1->SetValue("ITEM", "Lihaibo");
		dict1->SetFormattedValue("TAXED_VALUE", "%.2f", winnings * 0.83);
	}
	// 容许显示表格内容
	dict.ShowSection( "IN_TABLE" );

	// 建立 dict 模板的子模板
	TemplateDictionary *dict3 = dict.AddIncludeDictionary("INCLUDED_TEMPLATE");
	// 设置子模板文件名
	dict3->SetFilename("include.htm" ); 
	// 替换子模板中的标记
	dict3->SetValue("INCLUDE_VAR", "This is a include template.");

	// 根据 test.htm 页面模板建立 HTML 页面,并返回
	return ExpandTemplate("test.htm", DO_NOT_STRIP, &dict, out);
}

 

       3、使用 acl::HttpServlet 类编写 HTTP 处理过程

 

#include "lib_acl.hpp"
#include <string>

class http_servlet : public acl::HttpServlet
{
public:
	http_servlet(void)
	{

	}

	~http_servlet(void)
	{

	}

	// HTTP GET 请求过程
	virtual bool doGet(acl::HttpServletRequest& req, acl::HttpServletResponse& res)
	{
		return doPost(req, res);
	}

	// HTTP POST 请求过程
	virtual bool doPost(acl::HttpServletRequest& req, acl::HttpServletResponse& res)
	{
		// 得到 session
		const char* sid = req.getSession().getAttribute("sid");
		if (sid == NULL || *sid == 0)
			req.getSession().setAttribute("sid", "xxxxxx");
		sid = req.getSession().getAttribute("sid");

		// 取得浏览器 cookie
		const char* cookie = req.getCookieValue("name");
		// 取得请求参数
		const char* param = req.getParameter("name");

		// 建立 HTTP 响应头过程

		// 添加 cookie
		res.addCookie("name", "value");

		// 以 acl_master 框架控制方式或单独服务运行时必须设置状态位
		res.setStatus(200);

		// 设置 Content-Type 字段
		res.setContentType("text/html");
		// 设置字符集
		res.setCharacterEncoding("gb2312");

		std::string buf;
		create_html(&buf, sid, cookie, param);  // 生成 HTML 页面

		// 发送 http 响应头
		if (res.sendHeader() == false)
			return false;
		// 发送 http 响应体
		if (res.getOutputStream().write(buf.c_str(), buf.length()) == -1)
			return false;
		return true;
	}
};
int main(void)
{
	http_servlet servlet;
	servlet.doRun("127.0.0.1:11211");  // 开始运行,并假设 memcached 监听于 127.0.0.1:11211
	return 0;
}

 

 

      由上面的例子能够看出,使用 acl::HttpServlet 类库及 ctemplate 模板库编写 WEB 应用仍是比较简单的,这是一种典型的 MVC 的设计示例,要比传统的 CGI 编程简易很多并且功能更为强大。

 

 

     我的微博:http://weibo.com/zsxxsz

     原文地址

       下载:http://sourceforge.net/projects/acl/

        svn:svn checkout svn://svn.code.sf.net/p/acl/code/trunk acl-code

        github:https://github.com/zhengshuxin/acl

        QQ 群:242722074

        bbs:http://www.aclfans.com

 

      用C++实现相似于JAVA HttpServlet 的编程接口

      使用 acl_cpp 的 HttpServlet 类及服务器框架编写WEB服务器程序

      acl_cpp web 编程之文件上传

      更多文章...

 

     模板引擎参考文章

     ctemplate 下载地址

     尝试使用google-template模板引擎

     C++模板引擎Ctemplate的介绍

     基于C++的模板引擎

相关文章
相关标签/搜索