Cocos2d-X网络编程(2) Cocos2d中的网络通信协议——http协议

HTTP协议也叫超文本传输协议。是互联网广泛使用的通信协议，常用于B/S架构中。

HTTP连接使用的是短连接形式，也就是“请求－响应”的方式，不仅在请求时需要先建立连接，而且需要客户端向服务器发出请求后，服务器端才能回复数据。

 

HTTP常用的有2种数据提交方式，分别是GET、POST

 1：get是从服务器上获取（查询）数据，post是向服务器传送数据；

 2：get传送的数据量较小，不能大于2KB,post传送的数据量较大，一般认为不受限；

 3：get安全性非常低；post安全性相对来说就比较好了；

 

Cocos2d-x封装了3个类来处理HTTP请求，HttpRequest、HttpClient和HttpResponse。它们在命名空间cocos2d::network中定义，所以使用时要先声明该命名空间。

请求过程：

1. 创建 HttpRequest 的实例；

2. 设置请求方式，GET、POST等。

3. 设置请求地址和发送的数据；

4. 设置响应回调函数,在回调函数中处理获取的数据；

5. 创建HttpClient实例，发送请求；

6. 释放连接。

---

一：HttpRequest

是一种数据类型，它提供了一些方法用来定义或获取HTTP请求的参数。常用方法包括下面几种。

设置请求连接：void setUrl(const char * url);

设置请求类型：void setRequestType(Type type)

    Type是Cocos2d-x定义的一个枚举类型，包括5种类型。

    enum class Type

    {

          GET,

          POST,

          PUT,

          DELETE,

          UNKNOWN,

    };

设置回调函数：void setResponseCallback(Ref * pTarget,SEL_HttpResponse pSelector )

设置请求的数据，参数buffer是提交的数据，len是请求数据的长度：void setRequestData(const char* buffer, unsigned int len)；

二：HttpClient

用来控制请求相关的参数，比如发送请求，设置请求超时时间。它使用单例模型。这一模式的目的是使得类的一个对象成为系统中的唯一实例。cocos2d中多处用到这一模型。

比如Director对象，创建Director::getInstance()。

又比如，音频处理对象： SimpleAudioEngine::getInstance();

常用方法：

   发送请求：send(HttpRequest* request)

   设置连接超时时间：setTimeoutForConnect(int value)

三：HttpResponse

包含服务器返回的数据等信息。使用HttpResponse提供的方法可以获取这些数据。

常用方法：

   获取请求返回的数据：std::vector<char>* getResponseData();

   获取返回状态：getResponceCode    返回值是一个整数，200表示请求成功，400表示服务器错误，404表示服务器上找不到相应的文件。

  issucced()：用来判断是否返回成功

在发送请求的时候可能一次不止发送一条请求，那么怎么区分呢？可以在发送请求时设置tag，在响应中接收tag，判断，然后执行后续操作。

设置请求头：setHeaders

Content-Type：内容类型。用于定义网络文件的类型和网页的编码，决定浏览器将以什么形式、什么编码读取这个文件。如果未指定 ContentType，默认为TEXT/HTML。

    charset：编码格式

    设置格式： Content-Type: application/json; charset=utf-8

sendImmediate和send的区别：使用send，按顺序发送请求，使用sendImmediate，立即发送

---

代码实操：

头文件：

#ifndef __TestHttp_SCENE_H__
#define __TestHttp_SCENE_H__

#include "cocos2d.h"

#include "network\HttpRequest.h"
#include "network\HttpClient.h"
#include "network\HttpResponse.h"

USING_NS_CC;
using namespace cocos2d::network;

class TestHttp : public cocos2d::Layer
{
public:
    static cocos2d::Scene* createScene();
    virtual bool init();
    void menuCloseCallback(cocos2d::Ref* pSender);
	CREATE_FUNC(TestHttp);

	// 发送请求后收到响应的回调函数
	void complete(HttpClient *client,HttpResponse *response);
};

#endif // __TestHttp_SCENE_H__

源文件：

#include "TestHttpScene.h"
#include "curl\include\win32\curl\curl.h"

Scene* TestHttp::createScene()
{
    auto scene = Scene::create();
    auto layer = TestHttp::create();
    scene->addChild(layer);
    return scene;
}

bool TestHttp::init()
{
    if ( !Layer::init() )
    {
        return false;
    }

	// GET方式
	// 一 1:创建 HttpRequest 的实例
	auto getReq = new HttpRequest();
	// 一 2:设置请求地址
	getReq->setUrl("http://httpbin.org/ip");
	getReq->setTag("type get");
	// 一 3:设置请求类型 get
	getReq->setRequestType(HttpRequest::Type::GET);
	// 一 4:设置请求的数据
	char data[50] = "data";
	getReq->setRequestData(data,strlen(data));
	// 一 5:设置服务器响应回调函数
	getReq->setResponseCallback(CC_CALLBACK_2(TestHttp::complete,this));

	// 二 1:创建HttpClinet对象
	auto client = HttpClient::getInstance();
	// 二 2:设置超时时间
	client->setTimeoutForConnect(60);
	// 二 2:设置读取时间（可设可不设）
	client->setTimeoutForRead(100);
	// 二 3:发送请求
	client->send(getReq);
	// 二 4:释放请求
	getReq->release();

	// POST方式
	auto postReq = new HttpRequest();
	// 设置标记，用于区分不同请求
	postReq->setTag("type post");
	postReq->setUrl("http://httpbin.org/post");
	postReq->setRequestType(HttpRequest::Type::POST);
	// 设置请求头（内容类型和编码方式）
	std::vector<std::string> header;
	header.push_back("Content-Type:application/json;charset=utf-8");
	postReq->setHeaders(header);
	const char* reqData = "controller=cocos2d&action=testHttpPost";
	postReq->setRequestData(reqData,strlen(reqData));
	postReq->setResponseCallback(CC_CALLBACK_2(TestHttp::complete,this));

	auto client2 = HttpClient::getInstance();
	client2->sendImmediate(postReq);
	postReq->release();

    return true;
}

// 服务器响应回调函数
void TestHttp::complete(HttpClient *client,HttpResponse *response)
{
	// 获取请求的tag
	log("request tag is:%s",response->getHttpRequest()->getTag());
	// 获取响应状态
	log("response code is:%d",response->getResponseCode());
	if(response->isSucceed())    // 返回成功
	{
		/*std::vector<char> * data = response->getResponseData();
		log("response data is:");
		for (int i = 0; i < data->size(); i++)
		{
			log("%c",(*data)[i]);
		}*/
		std::vector<char> * data = response->getResponseData();
		std::stringstream oss;
		for (int i = 0; i < data->size(); i++)
		{
			oss<<(*data)[i];
		}
		std::string str = oss.str();
		log("response data is:%s",str.c_str());
	}else   //  失败，打印错误信息
	{
		log("error msg is:%s",response->getErrorBuffer());
	}
}