Cgicc類是主類。首先是一些常用的typedef
//! A vector of FormEntry objects
typedef STDNS vector<FormEntry>::iterator form_iterator;
//! A vector of \c const FormEntry objects
typedef STDNS vector<FormEntry>::const_iterator const_form_iterator;
//! A vector of FormFile objects
typedef STDNS vector<FormFile>::iterator file_iterator;
//! A vector of \c const FormFile objects
typedef STDNS vector<FormFile>::const_iterator const_file_iterator;
cigcc里面很多地方用到了STL的vector.STDNS就就是std::,因為整個文件的定義是在namespace cgicc里面,所以此處要聲明std.。網頁文件的元素很適合用vector來標示,迭代器也是直接使用vector的。
cgicc主要是用來存取form的元素信息的。
cigcc通常的用法是:
int
main(int argc, char **argv) {
try {
cgicc::Cgicc cgi;
// do something with cgi
}
catch(const exception& e) {
//handle the error
}
}
類的定義相關,簡單的成員函數不再介紹,只在后面介紹具體的重要的成員函數。下面是類的私有數據與函數:private:
CgiEnvironment fEnvironment;
STDNS vector<FormEntry> fFormData;
STDNS vector<FormFile> fFormFiles;
// Convert query string into a list of FormEntries
void parseFormInput(const STDNS string& data);
// Parse a multipart/form-data header
MultipartHeader parseHeader(const STDNS string& data);
// Parse a (name=value) form entry
void parsePair(const STDNS string& data);
// Parse a MIME entry for ENCTYPE=""
void parseMIME(const STDNS string& data);
// Find elements in the list of entries
bool findEntries(const STDNS string& param,
bool byName,STDNS vector<FormEntry>& result) const;
};
構造函數:
Cgicc(reader_function_t stream_reader = NULL);
如果使用的是FastCGI(CGI的一個擴展版本)的話,會需要一個reader_function_t的參數,用來讀取輸入。如果忽略或者是NULL的話,
則使用標準輸入
read_function_t也是一個typedef .定義在CgiEnvironment.h中
typedef size_t (* reader_function_t)(void *, size_t);
是一種函數指針類型。size_t 是Linux上常用的一種數據類型。一般為long unsigned int.這種函數類型接受兩個參數,返回一個size_t.
實現:
CGICCNS Cgicc::Cgicc(reader_function_t stream_reader) //CGICCNS--->cgicc::
: fEnvironment(stream_reader) //fEnvironment是一個CgiEnvironment 實例。
{
#if DEBUG
#if HAVE_STRFTIME //是否有strftime這個函數,有的話就會有下面的調用。LINUX上一般都有。
time_t now;
tm *date;
char s[80];
now = time(0); //獲取UNIX時間(秒數)。
date = localtime(&now); //轉換成通常用的時間格式
strftime(s, 80, "%A, %B %d, %Y %I:%M:%S %p", date); //寫入字符數組s中
LOG("Cgicc debugging log started on ") //LOG和下面的stringsAreEqual都是Cgiutils.h中定義的一些實用函數,見本文
LOGLN(s) //附錄。
#else
LOGLN("Cgicc debugging log started.")
#endif /* HAVE_STRFTIME */
#endif /* DEBUG */
// this can be tweaked for performance
fFormData.reserve(40); //請求存儲空間,最少能容納40個元素,STL中的接口
fFormFiles.reserve(5); //同上。Cgicc提供了整個庫最主要的也是最基本的接口,其中就包括存貯取得的信息。
if(stringsAreEqual(getEnvironment().getRequestMethod(), "post")) //具體函數見附錄2.
parseFormInput(getEnvironment().getPostData());
else
parseFormInput(getEnvironment().getQueryString());
}
析構函數:
1 CGICCNS Cgicc::~Cgicc()
2 {
3 LOGLN("Cleaning up

")
4 LOGLN("Cgicc debugging log closed.")
5 }
同構造函數一樣,若開啟DEBUG宏,輸出一些提示信息。否則什么也不做。
附錄:
1.LOG。一個宏,牽扯到DEBUG這個宏,默認情況下DEBUG為0,此時LOG(S)和LOGIN(S)都為空。若DEBUG=1,則定義為:
extern STDNS ofstream gLogFile;
#define LOGLN(s) gLogFile << s << STDNS endl;
#define LOG(s) gLogFile << s;
所以此時上面的構造函數的輸出為(標準輸出):
Cgicc debugging log started on\n+一個時間2.stringsAreEqual比較兩個字符串是否相等,忽視大小寫。
bool
CGICCNS stringsAreEqual(const STDNS string& s1, //CGICCNS------>cgicc:: STDNS----->std::
const STDNS string& s2)
{
STDNS string::const_iterator p1 = s1.begin();
STDNS string::const_iterator p2 = s2.begin();
STDNS string::const_iterator l1 = s1.end();
STDNS string::const_iterator l2 = s2.end();
while(p1 != l1 && p2 != l2) {
if(toupper(*(p1++)) != toupper(*(p2++))) //忽略大小寫
return false;
}
return (s2.size() == s1.size()) ? true : false;
}