第二人生的源码分析(六十二)类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库的功能调用。