【Cocos2dx-3.x】通信协议之HTTP通信协议篇

来源：互联网发布：淘宝体验中心编辑：程序博客网时间：2024/06/05 11:18

好记性不如烂笔头

前言

Cocos2d-x提供了3种网络连接通信方式,分别为:HTTT、Socket、WebSocket等;本小结主要以Http协议为主:2.x和3.x的通信协议没有太大的变化，HTTP中有3种数据提交方式,分别为: GET、POST、PUT; 这里以HTTP中常用的GET、POST作为代码示例，GET和POST区别在于，GET适用于从服务器获取小的数据;而POST则适用于向服务器提交比较多的数据，用法如下:

预备工作

首先创建2个文字按钮，分别为GET、POSTS。点击按钮GET，调用createGetHttp()函数；点击按钮POST，调用createPostHttp()函数。接下来的操作就在这两个函数里进行(按钮创建这里就不多说了)

HTTP 之 GET方式通信

首先在使用HTTp协议的类中要把HttpClient.h、HttpRequest.h、HttpResponse.h这三个头文件包含进来，并且声明好命名空间:using namespace cocos2d::network;

1
2
3
4
5
#include "HttpClient.h"
#include "HttpRequest.h"
#include "HttpResponse.h"
 
using namespace cocos2d::network;

在方法createGetHttp()中：
1. 生成HttpRequest对象

1
2
//  生成HttpRequest对象
autorequest=newHttpRequest();

2 . 设置请求链接

1
2
//  设置请求(这里的链接是TestCpp中的)
request->setUrl("http://httpbin.org/get");

3. 设置请求类型

1
2
3
4
5
6
7
8
9
10
11
12
//  设置请求方式  GET类型
request->setRequestType(HttpRequest::Type::GET);
 
//  这里的类型是枚举值，我们可以看他内部实现:
enumclassType
{
  GET,
  POST,
  PUT,
  DELETE,
  UNKNOWN,
};

4. 设置请求完成后的回调函数

1
2
//  设置请求完成后的回调函数(这里在.h中声明getHttp_handshakeResponse(HttpClient *sender, HttpResponse *response)方法)
request->setResponseCallback(CC_CALLBACK_2(TestNetWork::getHttp_handshakeResponse, this));

5. 设置请求tag值

1
2
//  设置请求tag
request->setTag("getHttp_handshake");

6. 生成HttpClient对象，并且发送请求

1
2
//  生成HttpClient对象，并且发送请求
HttpClient::getInstance()->send(request);

7. 释放 HttpRequest对象

1
2
//  释放HttpRequest对象
request->release();

请求完整代码:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
//  GET通信
void TestNetWork::createGetHttp()
{
//  生成HttpRequest对象
auto request = new HttpRequest();
//  设置请求
request->setUrl("http://httpbin.org/get");
//  设置请求方式  GET类型
request->setRequestType(HttpRequest::Type::GET);
//  设置请求完成后的回调函数
request->setResponseCallback(CC_CALLBACK_2(TestNetWork::getHttp_handshakeResponse, this));
//  设置请求tag
request->setTag("getHttp_handshake");
//  生成HttpClient对象，并且发送请求
HttpClient::getInstance()->send(request);
//  释放HttpRequest对象
request->release();
}

到这里我们的请求已经发出，接下来要对请求返回的数据进行处理，上面已经设置好了请求响应函数，下面是对返回的一些处理:
函数getHttp_handshakeResponse(HttpClient *sender, HttpResponse *response)

1. 通过参数response得到请求tag值，如果能够成功获取则请求发送成功。

1
2
3
4
5
//  通过response 获取请求tag，能获取到说明请求发出，并且输出请求tag值
if(0!=strlen(response->getHttpRequest()->getTag()))
{
    CCLOG("request tag: %s",response->getHttpRequest()->getTag());
}

2. 通过getResponseCode()函数来获取请求状态码，状态码为200时，则发送请求成功

1
2
3
4
5
6
7
8
9
10
11
12
13
//  判断是否请求成功 方法一: 获取请求状态码
long codeActive = response->getResponseCode();
if (codeActive==200)
{
MessageBox("请求发送成功", "提示");
CCLOG("%ld",codeActive);
}
else
{
//  response->getErrorBuffer() 返回错误代码
erroeStr =  String::createWithFormat("请求发送失败! \n 错误代码: %s",response->getErrorBuffer());
CCLOG("%ld",codeActive);
}

3. 也可以根据 isSucceed()这个函数来判断是否发送请求成功，这个函数返回bool类型

1
2
3
4
5
6
7
8
//  判断是否请求成功 方法二:使用HttpResponse对象提供的函数isSucceed() 进行判断(返回值bool类型)
if(!response->isSucceed())
{
//  response->getErrorBuffer() 返回错误代码
autoerroeStr=  String::createWithFormat("请求发送失败! \n 错误代码: %s",response->getErrorBuffer());
MessageBox(erroeStr->getCString(),"提示");
return;
}

4. 确认请求发送成功后，利用getResponseData()函数来得到请求返回的数据，得到的数据，根据自己项目所需进行响应处理即可，这里只做了输出处理

1
2
3
4
5
6
7
8
9
10
//  使用response->getResponseData(); 获取请求返回的数据
std::vector<char> *buffer = response->getResponseData();
std::stringstream s;
 
//  输出数据
for (unsigned int i = 0; i < buffer->size(); i++)
{
s << (*buffer)[i];
}
CCLOG("data: %s", s.str().c_str());

到这里GET请求与接收就完成了，下面是完整代码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
// GET通信
voidTestNetWork::createGetHttp()
{
// 生成HttpRequest对象
autorequest=newHttpRequest();
// 设置请求
request->setUrl("http://httpbin.org/get");
// 设置请求方式  GET类型
request->setRequestType(HttpRequest::Type::GET);
// 设置请求完成后的回调函数
request->setResponseCallback(CC_CALLBACK_2(TestNetWork::getHttp_handshakeResponse,this));
// 设置请求tag
request->setTag("getHttp_handshake");
// 生成HttpClient对象，并且发送请求
HttpClient::getInstance()->send(request);
// 释放HttpRequest对象
request->release();
}
voidTestNetWork::getHttp_handshakeResponse(HttpClient*sender,HttpResponse*response)
{
// 通过response 获取请求tag，能获取到说明请求发出，并且输出请求tag值
if(0!=strlen(response->getHttpRequest()->getTag()))
{
CCLOG("request tag: %s",response->getHttpRequest()->getTag());
}
// 判断是否请求成功 方法一: 获取请求状态码
longcodeActive=response->getResponseCode();
if(codeActive==200)
{
MessageBox("请求发送成功","提示");
CCLOG("%ld",codeActive);
}
else
{
// response->getErrorBuffer() 返回错误代码
autoerroeStr=  String::createWithFormat("请求发送失败! \n 错误代码: %s",response->getErrorBuffer());
MessageBox(erroeStr->getCString(),"提示");
CCLOG("%ld",codeActive);
}
// 判断是否请求成功 方法二:使用HttpResponse对象提供的函数isSucceed() 进行判断(返回值bool类型)
if(!response->isSucceed())
{
// response->getErrorBuffer() 返回错误代码
autoerroeStr=  String::createWithFormat("请求发送失败! \n 错误代码: %s",response->getErrorBuffer());
MessageBox(erroeStr->getCString(),"提示");
return;
}
// 使用response->getResponseData(); 获取请求返回的数据
std::vector<char>*buffer=response->getResponseData();
std::stringstreams;
// 输出数据
for(unsignedinti=0;i<buffer->size();i++)
{
s<<(*buffer)[i];
}
CCLOG("data: %s",s.str().c_str());
}

HTTP 之 POST方式通信

POST 方式与GET方式通信请求过程几乎相近，只要把请求方式修改下即可:
在方法createPostHttp()中：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
//POST通信
void TestNetWork::createPostHttp()
{
//从 testCpp中可以找到源码
//生成HttpRequest对象
HttpRequest* request = new HttpRequest();
//设置请求
request->setUrl("http://httpbin.org/post");
//设置请求方式  GET类型
request->setRequestType(HttpRequest::Type::POST);
//选择性的设置Http请求的Content-Type
std::vector<std::string> headers;
headers.push_back("Content-Type: application/json; charset=utf-8");
request->setHeaders(headers);
//设置请求完成后的回调函数
request->setResponseCallback(CC_CALLBACK_2(TestNetWork::PostHttp_handshakeResponse, this));
// 使用setRequestData()函数设置提交数据
const char* postData = "visitor=cocos2d&TestSuite=Extensions Test/NetworkTest";
request->setRequestData(postData, strlen(postData));
//设置请求tag
request->setTag("postHttp_handshake");
//生成HttpClient对象，并且发送请求
HttpClient::getInstance()->send(request);
//释放HttpRequest对象
request->release();
}

以上就是POST的发送请求，和GET很像，这里我们的post请求已经发出，接下来要对请求返回的数据进行处理，上面已经设置好了请求响应函数，下面是对返回的一些处理:
函数PostHttp_handshakeResponse(HttpClient *sender, HttpResponse *response)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
voidTestNetWork::PostHttp_handshakeResponse(HttpClient*sender,HttpResponse*response)
{
// 通过response 获取请求tag，能获取到说明请求发出，并且输出请求tag值
if(0!=strlen(response->getHttpRequest()->getTag()))
{
CCLOG("request tag: %s",response->getHttpRequest()->getTag());
}
// 请求码
longstatusCode=response->getResponseCode();
CCLOG("response code: %ld",statusCode);
// 判断请求是否成功
if(!response->isSucceed())
{
// response->getErrorBuffer() 返回错误代码
autoerroeStr=  String::createWithFormat("请求发送失败! \n 错误代码: %s",response->getErrorBuffer());
MessageBox(erroeStr->getCString(),"提示");
return;
}
// 输出返回的数据
std::vector<char>*buffer=response->getResponseData();
printf("Http Test, dump data: ");
for(unsignedinti=0;i<buffer->size();i++)
{
printf("%c",(*buffer)[i]);
}
}

总结

到这里本章节的学习就结束，想看项目运行效果的可以从我的gitHub上获取本节源码点击这里，Socket以及WebSocket网络通信方式分别会在下章节讲到！
更多文章请访问我的个人博客:http://www.sydev.cn

0 0