HttpResponse Class Reference

defines the object which users will receive at onHttpCompleted(sender, HttpResponse) callback. More...

Inherits Ref.

Public Member Functions
	HttpResponse (HttpRequest *request)
	Constructor, it's used by HttpClient internal, users don't need to create HttpResponse manually. More...
virtual	~HttpResponse ()
	Destructor, it will be called in HttpClient internal. More...
cocos2d::Ref *	autorelease ()
	Override autorelease method to prevent developers from calling it. More...
HttpRequest *	getHttpRequest () const
	Get the corresponding HttpRequest object which leads to this response. More...
bool	isSucceed () const
	To see if the http request is returned successfully. More...
std::vector< char > *	getResponseData ()
	Get the http response data. More...
std::vector< char > *	getResponseHeader ()
	Get the response headers. More...
long	getResponseCode () const
	Get the http response code to judge whether response is successful or not. More...
const char *	getErrorBuffer () const
	Get the error buffer which will tell you more about the reason why http request failed. More...
void	setSucceed (bool value)
	Set whether the http request is returned successfully or not, This setter is mainly used in HttpClient, users mustn't set it directly. More...
void	setResponseData (std::vector< char > *data)
	Set the http response data buffer, it is used by HttpClient. More...
void	setResponseHeader (std::vector< char > *data)
	Set the http response headers buffer, it is used by HttpClient. More...
void	setResponseCode (long value)
	Set the http response code. More...
void	setErrorBuffer (const char *value)
	Set the error buffer which will tell you more the reason why http request failed. More...
void	setResponseDataString (const char *value, size_t n)
	Set the response data by the string pointer and the defined size. More...
const char *	getResponseDataString () const
	Get the string pointer that point to the response data. More...
Public Member Functions inherited from Ref
void	retain ()
	Retains the ownership. More...
void	release ()
	Releases the ownership immediately. More...
Ref *	autorelease ()
	Releases the ownership sometime soon automatically. More...
unsigned int	getReferenceCount () const
	Returns the Ref's current reference count. More...
virtual	~Ref ()
	Destructor. More...

Additional Inherited Members
Public Attributes inherited from Ref
unsigned int	_ID
	object id, ScriptSupport need public _ID
int	_luaID
	Lua reference id.
void *	_scriptObject
	scriptObject, support for swift
bool	_rooted
	When true, it means that the object was already rooted.

Detailed Description

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.

Since

v2.0.2. @lua NA

Constructor & Destructor Documentation

HttpResponse()

HttpResponse ( HttpRequest *  request )

inline

Constructor, it's used by HttpClient internal, users don't need to create HttpResponse manually.

Parameters

request

the corresponding HttpRequest which leads to this response.

~HttpResponse()

virtual ~HttpResponse ( )

inlinevirtual

Destructor, it will be called in HttpClient internal.

Users don't need to destruct HttpResponse object manually.

Member Function Documentation

autorelease()

cocos2d::Ref* autorelease ( )

inline

Override autorelease method to prevent developers from calling it.

If this method is called , it would trigger CCASSERT.

Returns

cocos2d::Ref* always return nullptr.

getHttpRequest()

HttpRequest* getHttpRequest ( ) const

inline

Get the corresponding HttpRequest object which leads to this response.

There's no paired setter for it, because it's already set in class constructor

Returns

HttpRequest* the corresponding HttpRequest object which leads to this response.

isSucceed()

bool isSucceed ( ) const

inline

To see if the http request is returned successfully.

Although users can judge if (http response code = 200), we want an easier way. If this getter returns false, you can call getResponseCode and getErrorBuffer to find more details.

Returns

bool the flag that represent whether the http request return successfully or not.

getResponseData()

std::vector<char>* getResponseData ( )

inline

Get the http response data.

Returns

std::vector<char>* the pointer that point to the _responseData.

getResponseHeader()

std::vector<char>* getResponseHeader ( )

inline

Get the response headers.

Returns

std::vector<char>* the pointer that point to the _responseHeader.

getResponseCode()

long getResponseCode ( ) const

inline

Get the http response code to judge whether response is successful or not.

I know that you want to see the _responseCode is 200. If _responseCode is not 200, you should check the meaning for _responseCode by the net.

Returns

long the value of _responseCode

getErrorBuffer()

const char* getErrorBuffer ( ) const

inline

Get the error buffer which will tell you more about the reason why http request failed.

Returns

const char* the pointer that point to _errorBuffer.

setSucceed()

void setSucceed ( bool  value )

inline

Set whether the http request is returned successfully or not, This setter is mainly used in HttpClient, users mustn't set it directly.

Parameters

value

the flag represent whether the http request is successful or not.

setResponseData()

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

inline

Set the http response data buffer, it is used by HttpClient.

Parameters

data	the pointer point to the response data buffer.

setResponseHeader()

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

inline

Set the http response headers buffer, it is used by HttpClient.

Parameters

data	the pointer point to the response headers buffer.

setResponseCode()

void setResponseCode ( long  value )

inline

Set the http response code.

Parameters

value

the http response code that represent whether the request is successful or not.

setErrorBuffer()

void setErrorBuffer ( const char *  value )

inline

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

Parameters

value

a string pointer that point to the reason.

setResponseDataString()

void setResponseDataString ( const char *  value, size_t  n  )

inline

Set the response data by the string pointer and the defined size.

Parameters

value	a string pointer that point to response data buffer.
n	the defined size that the response data buffer would be copied.

getResponseDataString()

const char* getResponseDataString ( ) const

inline

Get the string pointer that point to the response data.

Returns

const char* the string pointer that point to the response data.

---

The documentation for this class was generated from the following file:

• HttpResponse.h