【Cocos2d-x v3.x 教程】如何使用HttpClient

http://www.cocoachina.com/cocos/20140510/8369.html

介绍

HttpClient是HTTP客户端的接口。HttpClient封装了各种对象，处理cookies，身份认证，连接管理等。

 

概念

HttpClient的使用一般包含下面6个步骤：

1. 创建 HttpRequest 的实例；

2. 设置某种连接方法的类型（GET、POST等），这里通过setUrl传入待连接的地址；

3. 设置响应回调函数，读取response；

4. 添加请求到HttpClient任务队列；

5. 释放连接。无论执行方法是否成功，都必须释放连接；

6. 对得到后的内容进行处理。

 

如何使用

HttpRequest 实例

 

我们将使用HttpRequest无参数的构造函数，它为大多数情况提供了一个很好的默认设置，所以我们使用它。

 
 
cocos2d::extension::HttpRequest* request = new cocos2d::extension::HttpRequest(); 

 

设置连接方法的类型和待连接的地址

由HTTP规范定义的各种方法对应各种不同的HttpRequest类。

 

我们将使用Get方法，这是一个简单的方法，它只是简单地取得一个URL，获取URL指向的文档。

 
 
request->setRequestType(HttpRequest::Type::GET); 
request->setUrl("http://www.httpbin.org/get"); 

 

设置回调

无论服务器返回怎样的状态，响应主体response body总是可读的，这至关重要。

 
 
request->setResponseCallback(this,httpresponse_selector(HelloWorld::onHttpComplete)); 

 

在onHttpComplete里读取响应数据：

 
 
std::vector<char> *buffer = response->getResponseData();//Get the request data pointer back 

 

添加请求到HttpClient任务队列

 
 
cocos2d::network::HttpClient::getInstance()->send(request); 

 

释放连接

这是一个可以让整个流程变得完整的关键步骤, 我们必须告诉HttpClient，我们已经完成了连接，并且它现在可以重用。如果不这样做的话，HttpClient将无限期地等待一个连接释放，以便它可以重用。

要释放连接，使用:

 
 
request->release(); 

 

处理响应

现在，我们已经完成了与HttpClient的交互，可以集中精力做我们需要处理的数据。在这个例子中，我们仅仅将它在控制台上输出。

 
 
// dump data 
std::vector *buffer = response->getResponseData(); 
printf("Http Test, dump data: "); 
for (unsigned int i = 0; i < buffer->size(); i++) 
{ 
printf("%c", (*buffer)); 
} 
printf("\n"); 

 

如果你需要把response作为一个流来读取它里面的信息，上面的步骤将会同如何解析这个连接结合，当你处理完所有的数据后，关闭输入流，并释放该连接。

 

GET请求示例

下面是一个通过HttpClient的HTTP GET请求的例子。

 
 
HttpRequest* request = new HttpRequest(); 
request->setUrl("http://just-make-this-request-failed.com"); 
request->setRequestType(HttpRequest::Type::GET); 
request->setResponseCallback(this, httpresponse_selector(HelloWorld::onHttpRequestCompleted)); 
request->setTag("GET test111"); 
cocos2d::network::HttpClient::getInstance()->send(request); 
request->release(); 

 

POST请求示例

下面将发送一个POST请求到URL“ http://httpbin.org/post”。

 
 
HttpRequest* request = new HttpRequest(); 
request->setUrl("http://httpbin.org/post"); 
request->setRequestType(HttpRequest::Type::POST); 
request->setResponseCallback(this, httpresponse_selector(HelloWorld::onHttpRequestCompleted)); 
// write the post data 
const char* postData = "visitor=cocos2d&TestSuite=Extensions Test/NetworkTest"; 
request->setRequestData(postData, strlen(postData)); 
request->setTag("POST test1"); 
cocos2d::network::HttpClient::getInstance()->send(request); 
request->release(); 

 

处理网络回调函数

 
 
void HelloWorld::onHttpRequestCompleted(HttpClient *sender, HttpResponse *response) 
{ 
if (!response) 
{ 
return; 
} 
// You can get original request type from: response->request->reqType 
if (0 != strlen(response->getHttpRequest()->getTag())) 
{ 
log("%s completed", response->getHttpRequest()->getTag()); 
} 
int statusCode = response->getResponseCode(); 
char statusString[64] = {}; 
sprintf(statusString, "HTTP Status Code: %d, tag = %s", statusCode, response->getHttpRequest()->getTag()); 
_labelStatusCode->setString(statusString); 
log("response code: %d", statusCode); 
if (!response->isSucceed()) 
{ 
log("response failed"); 
log("error buffer: %s", response->getErrorBuffer()); 
return; 
} 
// dump data 
std::vector<char> *buffer = response->getResponseData(); 
printf("Http Test, dump data: "); 
for (unsigned int i = 0; i < buffer->size(); i++) 
{ 
printf("%c", (*buffer)); 
} 
printf("\n"); 
} 

 

Android

需要注意的是，如果你是Android环境，不要忘了在您的应用程序的Manifest中增加相应的权限：

 
 
<uses-permission android:name=”android.permission.INTERNET” />