第二人生的源码分析(六十二)类Easy实现多协议文件传送

从上一节里可以看到，在类 LLCurl声明里主要声明嵌套类Easy，最后通过嵌套类Easy来实现libcurl功能，下面就来仔细地分析它。它的类声明如下：

#001 class LLCurl::Easy

#002 {

#003     LOG_CLASS(Easy);

#004 

#005 private:

#006     Easy();

#007    

#008 public:

 

用工厂模式来创建类实例。

#009     static Easy* getEasy();

#010     ~Easy();

#011 

 

返回当前 libcurl库的句柄。

#012     CURL* getCurlHandle() const { return mCurlEasyHandle; }

#013 

 

设置错误缓冲区。

#014     void setErrorBuffer();

 

设置授权认证。

#015     void setCA();

#016    

 

调用库的函数 curl_easy_setopt。

#017     void setopt(CURLoption option, S32 value);

#018     // These assume the setter does not free value!

#019     void setopt(CURLoption option, void* value);

#020     void setopt(CURLoption option, char* value);

#021     // Copies the string so that it is gauranteed to stick around

#022     void setoptString(CURLoption option, const std::string& value);

#023    

 

调用库函数 curl_slist_append来添加到列表头里面。

#024     void slist_append(const char* str);

 

设置 HTTP协议头数据。

#025     void setHeaders();

#026    

 

报告错误信息。

#027     U32 report(CURLcode);

 

获取传送信息。

#028     void getTransferInfo(LLCurl::TransferInfo* info);

#029 

 

在使用库下载数据前的设置。

#030     void prepRequest(const std::string& url, ResponderPtr, bool post = false);

#031    

#032     const char* getErrorBuffer();

#033 

 

获取输入流对象。

#034     std::stringstream& getInput() { return mInput; }

 

获取输出协议头流对象。

#035     std::stringstream& getHeaderOutput() { return mHeaderOutput; }

 

获取输出流对象。

#036     LLIOPipe::buffer_ptr_t& getOutput() { return mOutput; }

#037     const LLChannelDescriptors& getChannels() { return mChannels; }

#038    

 

清空所有流对象和一些状态。

#039     void resetState();

#040 

#041 private:   

#042     CURL*               mCurlEasyHandle;

#043     struct curl_slist* mHeaders;

#044    

#045     std::stringstream   mRequest;

#046     LLChannelDescriptors mChannels;

#047     LLIOPipe::buffer_ptr_t mOutput;

#048     std::stringstream   mInput;

#049     std::stringstream   mHeaderOutput;

#050     char                mErrorBuffer[CURL_ERROR_SIZE];

#051 

#052     // Note: char*'s not strings since we pass pointers to curl

#053     std::vector<char*> mStrings;

#054    

#055     ResponderPtr        mResponder;

#056 };

 

上面的类Easy封装了函数curl_easy_init来初始化一个协议实例，函数curl_easy_cleanup来删除相应的实例，函数curl_easy_reset来复位相关状态，通过函数curl_easy_getinfo来获取信息。最后通过函数curl_easy_setopt来设置不同的参数，这样才实现libcurl库的功能调用。