开源C++版本CGI库CGICC入门

傷城~ 2022-04-11 02:59 426阅读 0赞

## ##

原发布在ChinaUnix，但未被自动搬迁过来：[http://blog.chinaunix.net/uid-20682147-id-4895772.html][http_blog.chinaunix.net_uid-20682147-id-4895772.html]

PDF版本：[https://download.csdn.net/download/aquester/10827278][https_download.csdn.net_download_aquester_10827278]

# **目录** #

目录 1

1. 简介 1

2. CGICC组成 1

3. CGI输入处理子模块类结构 2

3.1. Cgicc 2

3.2. CgiEnvironment 2

3.3. HTTPCookie 2

3.4. CgiInput 3

3.5. FormFile 3

3.6. FormEntry 3

4. CGI输入处理子模块初始化流程 3

5. 编译和安装CGICC 4

6. CGICC使用示例 5

6.1. 页面效果 5

6.2. HTML文件 5

6.3. test.txt文件 6

6.4. CGI文件 6

6.5. 运行效果 8

7. HTML输出子模块类图 10

7.1. HTTPContentHeader 13

7.2. HTMLElement::render()函数 13

8. 问题？ 16

# **1. 简介** #

CGICC是一个C++语言实现的开源CGI库，采用LGPL授权协议，使用较为简单。

CGICC官网：[http://www.gnu.org/software/cgicc/][http_www.gnu.org_software_cgicc]，截止2015/3/14，CGICC最新稳定版本为3.2.16，下载地址是：[http://ftp.gnu.org/gnu/cgicc/cgicc-3.2.16.tar.gz][http_ftp.gnu.org_gnu_cgicc_cgicc-3.2.16.tar.gz]，最新更新时间为2014/12/7（令人惊讶和欣慰的是作为古老的CGI，CGICC还在不断的更新）。

# **2. CGICC组成** #

CGICC由两大部分组成：

1) CGI输入处理子模块

2) HTML输出子模块

本文暂只介绍CGI输入处理子模块，对于HTML输出，推荐Google开源的[ctemplate][]（https://github.com/OlafvdSpek/**ctemplate**）。

# **3. CGI输入处理子模块类结构** #

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0FxdWVzdGVy_size_16_color_FFFFFF_t_70][]

## **3.1. Cgicc** ##

CGICC的一类，通常直接在CGI的入口函数，如main函数中定义一个CGICC对象，然后即可使用CGICC提供的各种能力。

## **3.2. CgiEnvironment** ##

提供get系列方法取各环境变量的值。

## **3.3. HTTPCookie** ##

提花get系列方法取各Cookie的值，并支持set新增或修改Cookie值。

## **3.4. CgiInput** ##

CgiEnvironment内部类，仅供CgiEnvironment使用。

## **3.5. FormFile** ##

提供访问HTML的Form中的被上传文件信息和数据接口。

## **3.6. FormEntry** ##

提供访问HTML的Form中的非被上传文件类的信息和数据接口。取URL参数值示例：

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> //&nbsp;http://127.0.0.1/?param_name=param_value cgicc::form_iterator&nbsp;iter&nbsp;=&nbsp;cgi.getElement("param_name"); if&nbsp;(iter&nbsp;!=&nbsp;cgi.getElements().end()) { &nbsp;&nbsp;&nbsp;&nbsp;std::string&nbsp;param_value&nbsp;=&nbsp;iter-&gt;getValue(); } &nbsp; //&nbsp;也可以这样做： std::string&nbsp;param_value&nbsp;=&nbsp;cgi("param_name"); &nbsp; //&nbsp;除此之外，FormEntry还提供了直接取指定数据类型的参数值，如：getIntegerValue、getDoubleValue </td> 
 </tr> 
 </tbody> 
</table>

# **4. CGI输入处理子模块初始化流程** #

初始化流程是由Cgicc构造函数触发的，一般可在CGI的main函数中定义一个Cgicc对象：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0FxdWVzdGVy_size_16_color_FFFFFF_t_70 1][]

# **5. 编译和安装CGICC** #

详细编译步骤如下：

1) 将CGICC源代码包（本文下载的是cgicc-3.2.16.tar.gz）上传到Linux某目录（本文将CGICC源代码包cgicc-3.2.16.tar.gz上传到/tmp目录）；

2) 登录Linux，并进入目录/tmp；

3) 解压CGICC源代码包cgicc-3.2.16.tar.gz：tar xzf cgicc-3.2.16.tar.gz；

4) 解压后，会在/tmp下产生一个子目录cgicc-3.2.16，进入到这个子目录；

5) 然后执行configure命令（本文指定的安装目录为**/usr/local/cgicc-3.2.16**，可以根据需要设定为其它目录），以生成Makefile编译文件，如果要在共享库中使用CGICC，请使用下列编译命令：

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> ./configure&nbsp;--prefix=/usr/local/cgicc-3.2.16&nbsp;CXXFLAGS=-fPIC&nbsp;LDFLAGS=-fPIC </td> 
 </tr> 
 </tbody> 
</table>

否则，可按如下命令编译：

在一些环境上，如果不带-fPIC编译静态库，使用静态库时，就会报链接错误。

6) 执行make编译：make

7) 安装CGICC库：make install

8) 为**/usr/local/cgicc-3.2.16**建立不带版本号的软链接：

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> ln&nbsp;-s&nbsp;/usr/local/cgicc-3.2.16&nbsp;/usr/local/cgicc </td> 
 </tr> 
 </tbody> 
</table>

至此，CGICC库就安装好了！

# **6. CGICC使用示例** #

## **6.1. 页面效果** ##

![20181204151334703.png][]

## **6.2. HTML文件** ##

页面效果对应的HTML文件内容如下（HTML中的id一般是给前端如js使用的，而name通常是给服务端如CGI使用的）：

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> &lt;html&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;head&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;title&gt;upload&lt;/title&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;/head&gt; &nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&lt;body&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;p&gt;upload: &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;div&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;form&nbsp;action="/cgi-bin/upload.cgi"&nbsp;method="post"&nbsp;name="formname" &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;enctype="multipart/form-data"&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;input&nbsp;type="text"&nbsp;id="id1"&nbsp;name="name1"&nbsp;/&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;input&nbsp;type="text"&nbsp;id="id2"&nbsp;name="name2"&nbsp;/&gt; &nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;p&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;input&nbsp;type="file"&nbsp;id="fileid"&nbsp;name="filename"&nbsp;/&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;input&nbsp;type="submit"&nbsp;value="upload"&nbsp;id="upid"&nbsp;name="upname"&nbsp;/&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;/form&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;/div&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;/body&gt; &lt;/html&gt; </td> 
 </tr> 
 </tbody> 
</table>

注意，上传文件时，Form的enctype属性值必须被设定为multipart/form-data。

## **6.3. test.txt文件** ##

test.txt是一个被上传的文件，内容只有一行：**0123456789**。

## **6.4. CGI文件** ##

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> //&nbsp;如果是Exe形式的CGI，则使用如下语句编译： //&nbsp;g++&nbsp;-g&nbsp;-o&nbsp;upload.cgi&nbsp;upload.cpp&nbsp;-I/usr/local/cgicc/include&nbsp;/usr/local/cgicc/lib/libcgicc.a //&nbsp;如果是共享库（Windows平台叫动态库）形式的CGI，则使用如下语句编译： //&nbsp;g++&nbsp;-g&nbsp;-o&nbsp;upload.cgi&nbsp;upload.cpp&nbsp;-shared&nbsp;-fPIC&nbsp;-I/usr/local/cgicc/include&nbsp;/usr/local/cgicc/lib/libcgicc.a #include&nbsp;&lt;stdio.h&gt; #include&nbsp;&lt;sstream&gt; #include&nbsp;"cgicc/Cgicc.h" #include&nbsp;"cgicc/HTMLClasses.h" #include&nbsp;"cgicc/HTTPHTMLHeader.h" &nbsp; int&nbsp;main(int&nbsp;argc,&nbsp;char&nbsp;**argv) { &nbsp;&nbsp;&nbsp;&nbsp;try &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;cgicc::Cgicc&nbsp;cgi; &nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//&nbsp;Output&nbsp;the&nbsp;HTTP&nbsp;headers&nbsp;for&nbsp;an&nbsp;HTML&nbsp;document,&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//&nbsp;and&nbsp;the&nbsp;HTML&nbsp;4.0&nbsp;DTD&nbsp;info &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;std::cout&nbsp;&lt;&lt;&nbsp;cgicc::HTTPHTMLHeader() &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;&lt;&nbsp;cgicc::HTMLDoctype(cgicc::HTMLDoctype::eStrict) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;&lt;&nbsp;std::endl; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;std::cout&nbsp;&lt;&lt;&nbsp;cgicc::html().set("lang",&nbsp;"en").set("dir",&nbsp;"ltr") &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;&lt;&nbsp;std::endl; &nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//&nbsp;Set&nbsp;up&nbsp;the&nbsp;page's&nbsp;header&nbsp;and&nbsp;title. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;std::cout&nbsp;&lt;&lt;&nbsp;cgicc::head()&nbsp;&lt;&lt;&nbsp;std::endl; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;std::cout&nbsp;&lt;&lt;&nbsp;cgicc::title()&nbsp;&lt;&lt;&nbsp;"GNU&nbsp;cgicc&nbsp;v"&nbsp;&lt;&lt;&nbsp;cgi.getVersion() &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;&lt;&nbsp;cgicc::title()&nbsp;&lt;&lt;&nbsp;std::endl; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;std::cout&nbsp;&lt;&lt;&nbsp;cgicc::head()&nbsp;&lt;&lt;&nbsp;std::endl; &nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//&nbsp;Start&nbsp;the&nbsp;HTML&nbsp;body &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;std::cout&nbsp;&lt;&lt;&nbsp;cgicc::body()&nbsp;&lt;&lt;&nbsp;std::endl; &nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//&nbsp;Print&nbsp;out&nbsp;a&nbsp;message &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;std::cout&nbsp;&lt;&lt;&nbsp;cgicc::h1("Hello,&nbsp;world&nbsp;from&nbsp;GNU&nbsp;cgicc")&nbsp;&lt;&lt;&nbsp;std::endl; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;const&nbsp;cgicc::CgiEnvironment&amp;&nbsp;env&nbsp;=&nbsp;cgi.getEnvironment(); &nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;std::cout&nbsp;&lt;&lt;&nbsp;"&lt;p&gt;accept:&nbsp;"&nbsp;&lt;&lt;&nbsp;env.&nbsp;getAccept()&nbsp;&lt;&lt;&nbsp;std::endl; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;std::cout&nbsp;&lt;&lt;&nbsp;"&lt;p&gt;user&nbsp;agent:&nbsp;"&nbsp;&lt;&lt;&nbsp;env.getUserAgent()&nbsp;&lt;&lt;&nbsp;std::endl; &nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;std::cout&nbsp;&lt;&lt;&nbsp;"&lt;p&gt;cookie:&nbsp;"&nbsp;&lt;&lt;&nbsp;std::endl; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;const&nbsp;std::vector&lt;cgicc::HTTPCookie&gt;&amp;&nbsp;cookies&nbsp;=&nbsp;env.getCookieList(); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;for&nbsp;(std::vector&lt;cgicc::HTTPCookie&gt;::size_type&nbsp;i=0;&nbsp;i&lt;cookies.size();&nbsp;++i) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;const&nbsp;cgicc::HTTPCookie&amp;&nbsp;cookie&nbsp;=&nbsp;cookies[i]; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;std::cout&nbsp;&lt;&lt;&nbsp;"&lt;br&gt;&nbsp;&nbsp;&nbsp;&nbsp;cookie["&nbsp;&lt;&lt;&nbsp;cookie.getName() &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;&lt;&nbsp;"]&nbsp;=&nbsp;"&nbsp;&lt;&lt;&nbsp;cookie.getValue()&nbsp;&lt;&lt;&nbsp;std::endl;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;std::cout&nbsp;&lt;&lt;&nbsp;"&lt;p&gt;query&nbsp;string:&nbsp;"&nbsp;&lt;&lt;&nbsp;env.getQueryString()&nbsp;&lt;&lt;&nbsp;std::endl; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;std::cout&nbsp;&lt;&lt;&nbsp;"&lt;p&gt;remote:&nbsp;"&nbsp;&lt;&lt;&nbsp;env.getRemoteAddr()&nbsp;&lt;&lt;&nbsp;":"&nbsp;&lt;&lt;&nbsp;env.getServerPort() &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;&lt;&nbsp;std::endl; &nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;std::cout&nbsp;&lt;&lt;&nbsp;"&lt;p&gt;form:&nbsp;"&nbsp;&lt;&lt;&nbsp;std::endl; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;const&nbsp;std::vector&lt;cgicc::FormEntry&gt;&amp;&nbsp;form_entries&nbsp;=&nbsp;cgi.getElements(); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;for&nbsp;(std::vector&lt;cgicc::FormEntry&gt;::size_type&nbsp;i=0;&nbsp;i&lt;form_entries.size();&nbsp;++i) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;const&nbsp;cgicc::FormEntry&amp;&nbsp;form_entry&nbsp;=&nbsp;form_entries[i]; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;std::cout&nbsp;&lt;&lt;&nbsp;"&lt;br&gt;&nbsp;&nbsp;&nbsp;&nbsp;form[" &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;&lt;&nbsp;form_entry.getName()&nbsp;&lt;&lt;&nbsp;"]&nbsp;=&nbsp;" &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;&lt;&nbsp;form_entry.getValue()&nbsp;&lt;&lt;&nbsp;std::endl; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//&nbsp;取被上传的文件信息 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//&nbsp;使用getFile取得指定的被上传文件信息 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;cgicc::const_file_iterator&nbsp;file_iter&nbsp;=&nbsp;cgi.getFile("file"); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//&nbsp;使用getFiles可以取得所有被上传文件信息 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if&nbsp;(file_iter&nbsp;==&nbsp;cgi.getFiles().end()) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;std::cout&nbsp;&lt;&lt;&nbsp;"&lt;p&gt;file:&nbsp;"&nbsp;&lt;&lt;&nbsp;cgi.getFiles().size()&nbsp;&lt;&lt;&nbsp;std::endl; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;else &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;const&nbsp;cgicc::FormFile&amp;&nbsp;file&nbsp;=&nbsp;*file_iter; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;std::cout&nbsp;&lt;&lt;&nbsp;"&lt;p&gt;file:&nbsp;"&nbsp;&lt;&lt;&nbsp;std::endl; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;std::cout&nbsp;&lt;&lt;&nbsp;"&lt;br&gt;&nbsp;&nbsp;&nbsp;&nbsp;name:&nbsp;" &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;&lt;&nbsp;file.getName()&nbsp;&lt;&lt;&nbsp;std::endl; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;std::cout&nbsp;&lt;&lt;&nbsp;"&lt;br&gt;&nbsp;&nbsp;&nbsp;&nbsp;filename:&nbsp;" &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;&lt;&nbsp;file.getFilename()&nbsp;&lt;&lt;&nbsp;std::endl; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;std::cout&nbsp;&lt;&lt;&nbsp;"&lt;br&gt;&nbsp;&nbsp;&nbsp;&nbsp;type:&nbsp;" &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;&lt;&nbsp;file.getDataType()&nbsp;&lt;&lt;&nbsp;std::endl; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;std::cout&nbsp;&lt;&lt;&nbsp;"&lt;br&gt;&nbsp;&nbsp;&nbsp;&nbsp;size:&nbsp;" &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;&lt;&nbsp;file.getDataLength()&nbsp;&lt;&lt;&nbsp;std::endl; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;std::cout&nbsp;&lt;&lt;&nbsp;"&lt;br&gt;&nbsp;&nbsp;&nbsp;&nbsp;content:&nbsp;" &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;&lt;&nbsp;file.getData()&nbsp;&lt;&lt;&nbsp;std::endl; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//&nbsp;Close&nbsp;the&nbsp;document &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;std::cout&nbsp;&lt;&lt;&nbsp;cgicc::body()&nbsp;&lt;&lt;&nbsp;cgicc::html(); &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;catch(const&nbsp;std::exception&amp;&nbsp;e) &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//&nbsp;handle&nbsp;error&nbsp;condition &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp; &nbsp;&nbsp;&nbsp;&nbsp;return&nbsp;0; } </td> 
 </tr> 
 </tbody> 
</table>

## **6.5. 运行效果** ##

点击HTML页面的upload按钮后，页面变成如下：

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> Hello,&nbsp;world&nbsp;from&nbsp;GNU&nbsp;cgicc &nbsp; accept:&nbsp;text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8 &nbsp; user&nbsp;agent:&nbsp;Mozilla/5.0&nbsp;(Windows&nbsp;NT&nbsp;6.1;&nbsp;WOW64)&nbsp;AppleWebKit/535.36&nbsp;(KHTML,&nbsp;like&nbsp;Gecko)&nbsp;Chrome/39.0.2172.95&nbsp;Safari/537.36 &nbsp; cookie:&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;cookie[pgv]&nbsp;=&nbsp;445364884&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;cookie[ku]&nbsp;=&nbsp;f0ab9e006c7f4d5a4e9b394fc44fafc8afd6df6d373f9ff5f2946047974daf0ef9b00c6a1d7c341b&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;cookie[uid]&nbsp;=&nbsp;zhangshan&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;cookie[post-shareto-guide]&nbsp;=&nbsp;1&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;cookie[si]&nbsp;=&nbsp;s4001534976&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;cookie[info]&nbsp;=&nbsp;ssid=s9175124444&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;cookie[pvid]&nbsp;=&nbsp;6963827212&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;cookie[code_user_name]&nbsp;=&nbsp;A5C9579BE8B7C0E0&nbsp; &nbsp; query&nbsp;string: &nbsp; remote:&nbsp;120.16.82.66:80 &nbsp; form:&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;form[name1]&nbsp;=&nbsp;abc&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;form[name2]&nbsp;=&nbsp;xyz&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;form[upname]&nbsp;=&nbsp;upload &nbsp; file:&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;name:&nbsp;filename&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;filename:&nbsp;test.txt&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;type:&nbsp;text/plain&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;size:&nbsp;10&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;content:&nbsp;0123456789 </td> 
 </tr> 
 </tbody> 
</table>

# **7. HTML输出子模块类图** #

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0FxdWVzdGVy_size_16_color_FFFFFF_t_70 2][]

**n ****HTMLBooleanElement**

注意**sState**是类HTMLBooleanElement的静态数据成员，sState的数据类型为bool。

**n ****标签**

对于<html></html>，前者<html>叫开始标签，后者</html>叫关闭标签。

**n ****EElementType**

枚举类型，定义了两个枚举值：eAtomic和**eBoolean**，eAtomic对应的实现类为**HTMLAtomicElement**，eBoolean对应的实现为**HTMLBooleanElement**。类似于strong类的为eBoolean类型，而类似于hr、br之类的为eAtomic类型。对于eAtomic类型的HTML标签，它没有对应的关闭标签（也叫结束标签），观察以下两组的差别：

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> &lt;br&nbsp;/&gt; &lt;strong&gt;This&nbsp;text&nbsp;is&nbsp;strong&lt;/strong&gt; &nbsp; &lt;hr&nbsp;/&gt; &lt;p&gt;This&nbsp;is&nbsp;some&nbsp;text&lt;/p&gt; </td> 
 </tr> 
 </tbody> 
</table>

可以看到**br**和**hr**均是eAtomic类型的标签，而**strong**和**p**均是eBoolean类型的标签。

**n ****fEmbedded**

对于**eBoolean**类型的标签，在HTMLElement::**render**()函数的实现中，会发现还区分是否有fEmbedded，什么是有fEmbedded的eBoolean类型标签？

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> 下面这行为无fEmbedded的eBoolean标签： &nbsp; &nbsp; 下段这段也是含fEmbedded的eBoolean的标签，“&lt;title&gt;CGICC&lt;/title&gt;”为标签head的fEmbedded内容： &lt;head&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;title&gt;CGICC&lt;/title&gt; &lt;/head&gt; &nbsp; </td> 
 </tr> 
 </tbody> 
</table>

**n ****fDataSpecified**

也是针对eBoolean类型标签的，同样在HTMLElement::**render**()函数的实现中，会发现到差别（对应于对HTMLElement::**dataSpecified**()的调用）。下列的a即为fDataSpecified类型的eBoolean标签，其中“**一见的技术博客**”为标签a的Data：

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> &lt;a&nbsp;href="<a href="http://aquester.cublog.cn" rel="nofollow">http://aquester.cublog.cn</a>"&gt;一见的技术博客&lt;/a&gt; </td> 
 </tr> 
 </tbody> 
</table>

**n ****代码中的html()究竟是啥？**

阅读示例代码，可能会有这样一个疑问：html()是如何被调用的？发现没法直接找到名叫html的函数。

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> cout&nbsp;&lt;&lt;&nbsp;html().set("lang",&nbsp;"en").set("dir",&nbsp;"ltr")&nbsp;&lt;&lt;&nbsp;endl; cout&nbsp;&lt;&lt;&nbsp;head()&nbsp;&lt;&lt;&nbsp;endl; cout&nbsp;&lt;&lt;&nbsp;title()&nbsp;&lt;&lt;&nbsp;"GNU&nbsp;cgicc&nbsp;v"&nbsp;&lt;&lt;&nbsp;cgi.getVersion()&nbsp;&lt;&lt;&nbsp;title()&nbsp;&lt;&lt;&nbsp;endl; cout&nbsp;&lt;&lt;&nbsp;head()&nbsp;&lt;&lt;&nbsp;endl;&nbsp;&nbsp;&nbsp;&nbsp; cout&nbsp;&lt;&lt;&nbsp;body()&nbsp;&lt;&lt;&nbsp;endl; cout&nbsp;&lt;&lt;&nbsp;h1("Hello,&nbsp;world&nbsp;from&nbsp;GNU&nbsp;cgicc")&nbsp;&lt;&lt;&nbsp;endl; cout&nbsp;&lt;&lt;&nbsp;body()&nbsp;&lt;&lt;&nbsp;html(); </td> 
 </tr> 
 </tbody> 
</table>

上述调用中的html()、head()、title()、h1()和body()等，实际都是调用类**HTMLBooleanElement**的构造函数，演变成调用**HTMLElement**::**render**(std::ostream& out)。

流函数的定义为：

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> std::ostream&amp;&nbsp;cgicc::operator&nbsp;&lt;&lt;(std::ostream&amp;&nbsp;out,&nbsp;const&nbsp;cgicc::MStreamable&amp;&nbsp;obj) { &nbsp;&nbsp;&nbsp;&nbsp;obj.render(out); &nbsp;&nbsp;&nbsp;&nbsp;return&nbsp;out;&nbsp; } </td> 
 </tr> 
 </tbody> 
</table>

从流函数的定义不难看出，实际上调用的是**render**()。

在HTMLClasses.h文件中，定义了html、body等类（位于cgicc名字空间内），但是有些隐晦，直接看不出来：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0FxdWVzdGVy_size_16_color_FFFFFF_t_70 3][]

翻译一下，以便容易看懂这个过程，先看相关的宏定义：

**1) ****宏****BOOLEAN\_ELEMENT**

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> #define&nbsp;BOOLEAN_ELEMENT(name,&nbsp;tag)&nbsp;\ &nbsp;&nbsp;&nbsp;&nbsp;TAG(name,&nbsp;tag);&nbsp;typedef&nbsp;HTMLBooleanElement&lt;name##Tag&gt;&nbsp;name </td> 
 </tr> 
 </tbody> 
</table>

**2) ****宏TAG**

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> //&nbsp;注意区分下面的tag和Tag #define&nbsp;TAG(name,&nbsp;tag)&nbsp;\ &nbsp;&nbsp;&nbsp;&nbsp;class&nbsp;name##Tag&nbsp;\ &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;public: &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;inline&nbsp;static&nbsp;const&nbsp;char*&nbsp;getName() &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return&nbsp;tag;&nbsp;//&nbsp;注意不是Tag，而是tag &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;}&nbsp;//&nbsp;注意，这里并没有加分号 </td> 
 </tr> 
 </tbody> 
</table>

现在来看HTMLClasses.h文件中定义的**BOOLEAN\_ELEMENT**(html, "html");，宏展开后，变成：

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> class&nbsp;htmlTag { public: &nbsp;&nbsp;&nbsp;&nbsp;inline&nbsp;static&nbsp;const&nbsp;char*&nbsp;getName() &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return&nbsp;"html"; &nbsp;&nbsp;&nbsp;&nbsp;} }; &nbsp; typedef&nbsp;HTMLBooleanElement&lt;htmlTag&gt;&nbsp;html;&nbsp;//&nbsp;html是不是就是一个类了？ </td> 
 </tr> 
 </tbody> 
</table>

html()怎么来的清楚了，还有一个疑问：对于：cout << html()，怎么知道是输出<html>还是</html>的？这个逻辑是在函数HTMLElement::**render**(std::ostream& out)中完成的。

## **7.1. HTTPContentHeader** ##

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0FxdWVzdGVy_size_16_color_FFFFFF_t_70 4][]

HTTPContentHeader负责输出HTTP头中的“**Content-Type:**”，看它的渲染函数reader()实现：

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> void&nbsp;cgicc::HTTPContentHeader::render(std::ostream&amp;&nbsp;out)&nbsp;const { &nbsp;&nbsp;&nbsp;&nbsp;out&nbsp;&lt;&lt;&nbsp;"Content-Type:&nbsp;"&nbsp;&lt;&lt;&nbsp;getData()&nbsp;&lt;&lt;&nbsp;std::endl; &nbsp; &nbsp;&nbsp;&nbsp;&nbsp;std::vector&lt;HTTPCookie&gt;::const_iterator&nbsp;iter; &nbsp;&nbsp;&nbsp;&nbsp;for&nbsp;(iter&nbsp;=&nbsp;getCookies().begin();&nbsp;iter&nbsp;!=&nbsp;getCookies().end();&nbsp;++iter) &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;out&nbsp;&lt;&lt;&nbsp;*iter&nbsp;&lt;&lt;&nbsp;std::endl; &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp; &nbsp;&nbsp;&nbsp;&nbsp;out&nbsp;&lt;&lt;&nbsp;std::endl; } </td> 
 </tr> 
 </tbody> 
</table>

其中，子类HTTP**HTML**Header的getData()返回“**text/html**”，子类HTTP**Plain**Header的getData()返回“**text/plain**”，子类HTTP**XHTML**Header的getData()返回“**application/xhtml+xml**”。

## **7.2. HTMLElement::render()函数** ##

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> void&nbsp;cgicc::HTMLElement::render(std::ostream&amp;&nbsp;out)&nbsp; const { &nbsp;&nbsp;&nbsp;&nbsp;if&nbsp;(eBoolean&nbsp;==&nbsp;getType()&nbsp;&amp;&amp;&nbsp;false&nbsp;==&nbsp;dataSpecified()) &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if&nbsp;(0&nbsp;==&nbsp;fEmbedded)&nbsp;/*&nbsp;no&nbsp;embedded&nbsp;elements&nbsp;*/ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//&nbsp;切换：用来控制是输入开始标签，还是关闭标签 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//&nbsp;HTMLBooleanElement::sState为类静态数据成员， &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//&nbsp;swapState()的作用就是用来切换它的值。 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;swapState(); &nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;/*&nbsp;getState()&nbsp;==&nbsp;true&nbsp;===&gt;&nbsp;element&nbsp;is&nbsp;active&nbsp;*/ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if&nbsp;(true&nbsp;==&nbsp;getState()) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//&nbsp;输出开始标签， &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;out&nbsp;&lt;&lt;&nbsp;'&lt;'&nbsp;&lt;&lt;&nbsp;getName(); &nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//&nbsp;开始标签是可能包含属性的， &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//&nbsp;如：&lt;a&nbsp;href="http://aquester.cublog.cn"&gt;， &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//&nbsp;这里的href即为标签&lt;a&gt;的属性 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if&nbsp;(0&nbsp;!=&nbsp;fAttributes) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;out&nbsp;&lt;&lt;&nbsp;'&nbsp;';&nbsp;//&nbsp;属性间使用一个空格分开 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;fAttributes-&gt;render(out); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;out&nbsp;&lt;&lt;&nbsp;'&gt;'; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;else &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//&nbsp;输出关闭标签，如：&lt;/head&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;out&nbsp;&lt;&lt;&nbsp;"&lt;/"&nbsp;&lt;&lt;&nbsp;getName()&nbsp;&lt;&lt;&nbsp;'&gt;'; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;else&nbsp;/*&nbsp;embedded&nbsp;elements&nbsp;present&nbsp;*/ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//&nbsp;被嵌入的（embedded）的内容总是整体一次性输出， &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//&nbsp;而不是区分其状态值HTMLBooleanElement::sState &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;out&nbsp;&lt;&lt;&nbsp;'&lt;'&nbsp;&lt;&lt;&nbsp;getName(); &nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;/*&nbsp;render&nbsp;attributes,&nbsp;if&nbsp;present&nbsp;*/ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if&nbsp;(0&nbsp;!=&nbsp;fAttributes) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;out&nbsp;&lt;&lt;&nbsp;'&nbsp;'; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;fAttributes-&gt;render(out); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;out&nbsp;&lt;&lt;&nbsp;'&gt;'; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;fEmbedded-&gt;render(out); &nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//&nbsp;输出关闭标签，如：&lt;/head&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;out&nbsp;&lt;&lt;&nbsp;"&lt;/"&nbsp;&lt;&lt;&nbsp;getName()&nbsp;&lt;&lt;&nbsp;'&gt;'; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;else&nbsp;/*&nbsp;For&nbsp;non-boolean&nbsp;elements&nbsp;*/ &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if&nbsp;(eAtomic&nbsp;==&nbsp;getType()) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;out&nbsp;&lt;&lt;&nbsp;'&lt;'&nbsp;&lt;&lt;&nbsp;getName(); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if&nbsp;(0&nbsp;!=&nbsp;fAttributes) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;out&nbsp;&lt;&lt;&nbsp;'&nbsp;'; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;fAttributes-&gt;render(out); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//&nbsp;eAtomic类型的标签 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;out&nbsp;&lt;&lt;&nbsp;"&nbsp;/&gt;"; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;else &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;out&nbsp;&lt;&lt;&nbsp;'&lt;'&nbsp;&lt;&lt;&nbsp;getName(); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if&nbsp;(0&nbsp;!=&nbsp;fAttributes) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;out&nbsp;&lt;&lt;&nbsp;'&nbsp;'; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;fAttributes-&gt;render(out); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;out&nbsp;&lt;&lt;&nbsp;'&gt;'; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if&nbsp;(0&nbsp;!=&nbsp;fEmbedded) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;fEmbedded-&gt;render(out); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;else &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//&nbsp;输出数据， &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//&nbsp;如&lt;a&nbsp;href="http://www.gnu.org/software/cgicc"&gt;CGICC&lt;/a&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//&nbsp;中的CGICC &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;out&nbsp;&lt;&lt;&nbsp;getData(); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//&nbsp;输出关闭标签，如：&lt;/head&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;out&nbsp;&lt;&lt;&nbsp;"&lt;/"&nbsp;&lt;&lt;&nbsp;getName()&nbsp;&lt;&lt;&nbsp;'&gt;'; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;} } </td> 
 </tr> 
 </tbody> 
</table>

# **8. 问题？** #

1) 问题1：怎么取得不在CgiEnvironment支持范围内的环境变量值？

答：可直接调用C库函数getenv()取值。

[http_blog.chinaunix.net_uid-20682147-id-4895772.html]: http://blog.chinaunix.net/uid-20682147-id-4895772.html
[https_download.csdn.net_download_aquester_10827278]: https://download.csdn.net/download/aquester/10827278
[http_www.gnu.org_software_cgicc]: http://www.gnu.org/software/cgicc/
[http_ftp.gnu.org_gnu_cgicc_cgicc-3.2.16.tar.gz]: http://ftp.gnu.org/gnu/cgicc/cgicc-3.2.16.tar.gz
[ctemplate]: https://github.com/OlafvdSpek/ctemplate
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0FxdWVzdGVy_size_16_color_FFFFFF_t_70]: /images/20220411/9f617a66de6740918a706a064a08da2b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0FxdWVzdGVy_size_16_color_FFFFFF_t_70 1]: /images/20220411/055751a2d0c84efdbf2d0fa8c44fcdbf.png
[20181204151334703.png]: /images/20220411/3b45e2dccfaf4154a44df0c73a130324.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0FxdWVzdGVy_size_16_color_FFFFFF_t_70 2]: /images/20220411/56b70a92262b47ce875f60754f6266b5.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0FxdWVzdGVy_size_16_color_FFFFFF_t_70 3]: /images/20220411/32658281a4aa435aa77a23381dc8df34.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0FxdWVzdGVy_size_16_color_FFFFFF_t_70 4]: /images/20220411/dda5e60705964d259ad0bc290b8b3040.png