Cocos2d-x网络模块2：HTTP连接

在第一课中，我们了解了网络的基本概念。接下来，我们将深入学习有关HTTP连接的知识。HTTP通常用于客户端终端与服务器（WEB）之间的数据通讯。若你对WEB不太熟悉，也未掌握服务端开发，那么本文将着重介绍客户端如何使用HTTP连接WEB服务器。

常见的WEB服务器与Cocos封装接口

常见的WEB服务器类型有PHP、JSP、ASP等。Cocos为开发者封装了HTTP客户端的接口，即HttpClient类。该类封装了各种对象，可处理cookies、身份认证、连接管理等功能。

HTTP简介

超文本传输协议（HyperText Transfer Protocol，缩写：HTTP），是互联网上应用最为广泛的一种网络协议。设计HTTP最初的目的是为了提供一种发布和接收HTML页面的方法。通过HTTP或者HTTPS协议请求的资源由统一资源标识符（Uniform Resource Identifiers，URI）来标识。

HTTP是一个无连接、无状态的应用层协议，采用请求 - 响应的交互方式，是标准的C/S模型，主要解决如何包装数据的问题。HTTP连接使用“请求——响应”的方式，在请求时需要先建立连接，并且客户端向服务器发出请求后，服务器端才能回复数据。

HTTP主要有两种请求方式：GET和POST，它们的区别如下：

• 数据获取与传输方向：GET用于从服务器上获取（查询）数据；而POST是向服务器传送（修改）数据。
• 传输数据量：GET传输数据量较小，通常限制在2KB；而POST传输一般不受限制。
• 安全性与执行效率：GET安全性非常低，但执行效率比较好；而POST安全性相对较好。

建议：在进行数据查询时，使用GET方式；而在进行数据添加、修改或删除时，使用POST方式。

以下是两种请求方式的示例：

• GET请求：用GET获取表单数据时，表单数据对任何人都是可见的。例如：http://www.abc.com/index.php?username=shahdza&password=123
• POST请求：用POST获取表单数据，表单数据则是不可见的。例如：http://www.abc.com.cn/index.php

HTTP连接的步骤

1. 客户端请求服务器连接：客户端发起与服务器的连接请求。
2. 客户端发送请求指令：客户端发送GET或POST指令，请求数据。
3. 服务端响应请求：服务端接收到请求数据指令后，发送响应请求的数据。
4. 释放连接：一次连接结束，释放连接资源。

HttpClient类

Cocos封装的HttpClient类是一个单例类，用于管理HTTP连接请求。除了HttpClient类，还有两个重要的类：

• HttpRequest：提供发送HTTP请求有关的数据信息，包含URL、请求方式、数据、响应函数等信息。
• HttpResponse：服务器返回的响应信息，包含响应代码、错误信息、响应的数据等信息。

引入头文件

#include "network/HttpClient.h"
using namespace network;

相关函数

HttpRequest类

class HttpRequest {
// 请求方式
enum class Type { GET, POST };
// 设置请求方式
void setRequestType(Type type);
// 设置访问服务器的资源URL
void setUrl(const char* url);
// 发送请求数据，用于POST方式
void setRequestData(const char* buffer, size_t len);
// 绑定请求的响应函数
void setResponseCallback(const ccHttpRequestCallback& callback);
// HttpResponse为服务器返回的响应信息
// callback(HttpClient* sender, HttpResponse* response);
};

HttpResponse类

class HttpResponse {
// HTTP请求是否成功
bool isSucceed();
// 响应代码
long getResponseCode();
// 错误信息
const char* getErrorBuffer();
// 发送回来的响应数据信息
std::vector<char>* getResponseData();
};

HttpClient类

class HttpClient {
// 获取HttpClient单例
static HttpClient* getInstance();
static void destroyInstance();
// 发送HTTP请求
void send(HttpRequest* request);
// 设置连接超时时长
inline void setTimeoutForConnect(int value) { _timeoutForConnect = value; };
// 设置下载超时时长
inline void setTimeoutForRead(int value) { _timeoutForRead = value; };
};

使用步骤

1. 创建HttpRequest请求：创建一个HttpRequest对象。
2. 设置请求信息：设置请求的URL、请求方式（GET/POST）、发送的数据、请求的响应函数。
3. 发送请求：调用HttpClient::getInstance()->send(request);发送请求。
4. 处理响应：处理请求的响应函数。
5. 释放连接：释放HTTP连接资源。

代码例子

// 发送HTTP请求
void HelloWorld::onHttpRequest(std::string type) {
// 创建HTTP请求
HttpRequest* request = new HttpRequest();
if (type == "get") {
request->setRequestType(HttpRequest::Type::GET);
// url后面附加数据信息
request->setUrl("http://httpbin.org/get?name=hello&pwd=world");
} else if (type == "post") {
request->setRequestType(HttpRequest::Type::POST);
request->setUrl("http://httpbin.org/post");
// 设置post发送请求的数据信息
std::string data = "hello world!";
request->setRequestData(data.c_str(), data.length());
}
// HTTP响应函数
request->setResponseCallback(CC_CALLBACK_2(HelloWorld::onHttpResponse, this));
// 发送请求
HttpClient::getInstance()->send(request);
// 释放链接
request->release();
}

// HTTP响应请求函数
void HelloWorld::onHttpResponse(HttpClient* sender, HttpResponse* response) {
// 没有收到响应
if (!response) {
CCLOG("no response");
return;
}
int statusCode = response->getResponseCode();
char statusString[64] = {};
sprintf(statusString, "HTTP Status Code: %d, tag = %s", statusCode, response->getHttpRequest()->getTag());
CCLOG("response code: %s", statusString);
// 链接失败
if (!response->isSucceed()) {
CCLOG("response failed");
CCLOG("error buffer: %s", response->getErrorBuffer());
return;
}
// 获取数据
std::vector<char>* v = response->getResponseData();
for (int i = 0; i < v->size(); i++) {
printf("%c", v->at(i));
}
printf("\n");
}

运行结果

运行上述代码后，你可以根据不同的请求方式（GET或POST），观察服务器返回的数据信息。通过响应函数的处理，你可以将服务器返回的数据打印输出，以便进行调试和分析。