Cocos2d-x官方中文文档 v3.x HttpClient
来源:互联网 发布:重装系统网络不可用 编辑:程序博客网 时间:2024/05/16 14:15
如何使用HttpClient
介绍
HttpClient是HTTP客户端的接口。HttpClient封装了各种对象,处理cookies,身份认证,连接管理等。
概念
HttpClient的使用一般包含下面6个步骤:
- 创建 HttpRequest 的实例;
- 设置某种连接方法的类型(GET、POST等),这里通过setUrl传入待连接的地址;
- 设置响应回调函数,读取response;
- 添加请求到HttpClient任务队列;
- 释放连接。无论执行方法是否成功,都必须释放连接;
- 对得到后的内容进行处理。
如何使用
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 datastd::vector *buffer = response->getResponseData();printf("Http Test, dump data: ");for (unsigned int i = 0; i < buffer->size(); i++){ printf("%c", (*buffer)[i]);}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 dataconst 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)[i]); } printf("\n");}
Android
需要注意的是,如果你是Android环境,不要忘了在您的应用程序的Manifest 中增加相应的权限:
<uses-permission android:name=”android.permission.INTERNET” />
详细代码可参照..\samples\Cpp\TestCpp\Classes\ExtensionsTest\NetworkTest\HttpClientTest.cpp
- Cocos2d-x官方中文文档 v3.x HttpClient
- Cocos2d-x官方中文文档 v3.x
- Cocos2d-x官方中文文档
- Cocos2d-x官方中文文档
- Cocos2d-x官方中文文档
- Cocos2d-x官方中文文档
- [Cocos2d-x v3.x官方文档]cocos2d::Value
- [Cocos2d-x v3.x官方文档]cocos2d::Vector
- [Cocos2d-x v3.x官方文档]cocos2d::Map 分享0
- Cocos2d-x官方中文文档 v2.x
- [Cocos2d-x v3.x官方文档]场景转换(Transitions)
- Cocos2d-x v3.x官方文档]动作 (Action)
- [Cocos2d-x v3.x官方文档]调度器(scheduler)
- [Cocos2d-x v3.x官方文档]事件分发机制
- Cocos2d-x v3.x官方文档: 事件分发机制
- Cocos2d-x v3.x官方文档]菜单(Menu) 分享0
- [Cocos2d-x v3.x官方文档]菜单(Menu)
- Cocos2d-x v3.x官方文档]场景转换(Transitions)
- $.post传JSON到后台及接收方法
- Win8.1应用开发之Bing Maps
- 设计模式学习笔记——模板方法模式
- HDU 4085 斯坦纳树
- 页面跳转与传值(Activity跳转与传值)
- Cocos2d-x官方中文文档 v3.x HttpClient
- 暑期集训
- C++ 11 新关键字
- java:String、StringBuffer和StringBuilder的区别
- 暑期大作战 第五天(第四天待补)
- 纯手工打造漂亮的垂直时间轴,使用最简单的HTML+CSS+JQUERY完成100个版本更新记录的华丽转身!
- poj3667 线段树区间合并
- jqgrid使用步骤及说明
- 《Head First 设计模式》之单例模式