HttpResponse（联网 http回应）

#ifndef __HTTP_RESPONSE__

#define __HTTP_RESPONSE__

#include "cocos2d.h"

#include "ExtensionMacros.h"

#include "HttpRequest.h"

NS_CC_EXT_BEGIN

/** 

 @brief defines the object which users will receive at onHttpCompleted(sender, HttpResponse) callback

 Please refer to(参考；涉及) samples/TestCpp/Classes/ExtensionTest/NetworkTest/HttpClientTest.cpp as a sample

 */

class CCHttpResponse : public CCObject

{

public:

    /** Constructor, it's used by CCHttpClient internal(内部的), users don't need to create HttpResponse（http响应，回调） manually（手动的）

     @param request the corresponding（相应的） HttpRequest which leads to（导致；通向） this response */

    CCHttpResponse(CCHttpRequest* request)

    {

        _pHttpRequest = request;

        if (_pHttpRequest)

        {

            _pHttpRequest->retain();

        }

        

        _succeed = false;

        _responseData.clear();

        _errorBuffer.clear();

    }

    

    /** Destructor, it will be called in CCHttpClient internal,

     users don't need to desturct HttpResponse object manully 

     */

    virtual ~CCHttpResponse()

    {

        if (_pHttpRequest)

        {

            _pHttpRequest->release();

        }

    }

    

    /** Override autorelease method to prevent（预防prevent from ） developers（开发者） from calling it */

    CCObject* autorelease(void)

    {

        CCAssert(false, "HttpResponse is used between network thread and ui thread \

                        therefore, autorelease is forbidden here");

        return NULL;

    }

    

    // getters, will be called by users

    

    /** Get the corresponding HttpRequest object which leads to this response 

        There's no paired（成对的） setter for it, coz it's already setted in class constructor

     */

    inline CCHttpRequest* getHttpRequest() //没有set方法 因为内嵌在了构造函数里

    {

        return _pHttpRequest;

    }

        

    /** To see if the http reqeust is returned successfully,

        Althrough users can judge if (http return code = 200), we want an easier way

        If this getter returns false, you can call getResponseCode and getErrorBuffer to find more details

     */

    inline bool isSucceed()  //判断 http return code = 200 同一个作用

    {

        return _succeed;

    };

    

    /** Get the http response raw（原始） data */

    inline std::vector<char>* getResponseData()  //这个用的最多

    {

        return &_responseData;

    }

    

    /** get the Rawheader **/

    inline std::vector<char>* getResponseHeader()

    {

        return &_responseHeader;

    }

    /** Get the http response errorCode

     *  I know that you want to see http 200 :)

     */

    inline int getResponseCode() 

    {

        return _responseCode;

    }

    /** Get the rror buffer which will tell you more about the reason why http request failed

     */

    inline const char* getErrorBuffer()

    {

        return _errorBuffer.c_str();

    }

    

    // setters, will be called by CCHttpClient

    // users should avoid invoking these methods

    //下面的 set方法供CCHttpClient内部使用 因避免外部调用

    

    /** Set if the http request is returned successfully,

     Althrough users can judge if (http code == 200), we want a easier way

     This setter is mainly used in CCHttpClient, users mustn't set it directly

     */

    inline void setSucceed(bool value)

    {

        _succeed = value;

    };

    

    

    /** Set the http response raw buffer, is used by CCHttpClient

     */

    inline void setResponseData(std::vector<char>* data)

    {

        _responseData = *data;

    }

    

    /** Set the http response Header raw buffer, is used by CCHttpClient

     */

    inline void setResponseHeader(std::vector<char>* data)

    {

        _responseHeader = *data;

    }

    

    

    /** Set the http response errorCode

     */

    inline void setResponseCode(int value)

    {

        _responseCode = value;

    }

    

    

    /** Set the error buffer which will tell you more the reason why http request failed

     */

    inline void setErrorBuffer(const char* value)

    {

        _errorBuffer.clear();

        _errorBuffer.assign(value);

    };

    

protected:

    bool initWithRequest(CCHttpRequest* request);//这个怎么实现？？？？？

    

    // properties

    CCHttpRequest*        _pHttpRequest;  ///response对应的CCHttpRequest  the corresponding HttpRequest pointer who leads to this response 

    bool                _succeed;       /// to indecate if the http reqeust is successful simply

    std::vector<char>   _responseData;  /// the returned raw data. You can also dump it as a string

    std::vector<char>   _responseHeader;  /// the returned raw header data. You can also dump it as a string

    int                 _responseCode;    /// the status code returned from libcurl, e.g. 200, 404

    std::string         _errorBuffer;   /// if _responseCode != 200, please read _errorBuffer to find the reason 

    

};

NS_CC_EXT_END

#endif //__HTTP_RESPONSE_H__