在cocos2dx中使用HttpClient进行网络通信一般来说有post和get两种方法,从代码的角度上讲较为相似,官方文档对两种方法的简单使用都做了介绍,但是没有介绍post需要发送json数据格式时的情况,因此本篇文章简单介绍一下。
说明:本次代码基于cocos2d-x 3.10,所使用的编辑器为Xcode 7.3.1。
首先是头文件:
//
// HttpHelper.hpp
// CSanguo
//
// Created by 小羽毛 on 16/9/6.
//
//
#ifndef HttpHelper_hpp
#define HttpHelper_hpp
#include "cocos2d.h"
#include "network/HttpClient.h"
#include "json/rapidjson.h"
#include "json/document.h"
#include "json/stringbuffer.h"
#include "json/writer.h"
class HttpHelper : public cocos2d::Layer{
public:
virtual bool init();
void postHttpRequest();
void onRequestCompleted(cocos2d::network::HttpClient* sender, cocos2d::network::HttpResponse* response);
std::string getJsonData();
CREATE_FUNC(HttpHelper);
};
#endif /* HttpHelper_hpp */
简单说明一下, "HttpClient.h"是官方提供的Http通信类,(看其他文档里如果编辑器是vs还需要增加库引用,由于编辑器不一样,本人未作尝试),"json/rapidjson.h" 和"json/document.h" 是采用rapidjson解析返回的json数据所必须引入的,"json/stringbuffer.h" 和 "json/writer.h" 是采用rapidjson构造发送的son数据所必须引入的,如果采用的是拼接参数的方法发送数据则不需要引入。
代码中在.cpp文件中引入了如下两个命名空间:
USING_NS_CC;
using namespace cocos2d::network;
下面分别介绍一下主要的三个方法
(1)发送数据方法:
void HttpHelper::postHttpRequest()
{
HttpRequest* request = new (std::nothrow) HttpRequest();
// 这是一个专门供开发者测试发送请求的服务器地址,post方法会返回POST请求发送的数据
request -> setUrl("http://httpbin.org/post");
// 设置请求类型,可以选择GET
request -> setRequestType(HttpRequest::Type::POST);
// 设置请求完成之后的响应方法
request -> setResponseCallback(CC_CALLBACK_2(HttpHelper::onRequestCompleted, this));
// const char* postData = "visitor=cocos2d&TestSuite=Extensions Test/NetworkTest";
auto postData = getJsonData();
std::vector
headers;
headers.push_back("Content-Type: application/json; charset=utf-8");
// 设置请求头,如果数据为键值对则不需要设置
request -> setHeaders(headers);
// 传入发送的数据及数据ch n g
request -> setRequestData(postData.c_str(), postData.size());
request -> setTag("POST TEST");
HttpClient::getInstance() -> send(request);
request -> release();
}
这里采用getJsonData方法得到编码后的json字符串,因此需要设置请求头格式,如果数据比较简单,采用注释中的拼接字符串来生成数据即可,此时不需要设置请求头,默认即为键值对。
(2) 生成json数据方法:
std::string HttpHelper::getJsonData()
{
rapidjson::Document document;
document.SetObject();
rapidjson::Document::AllocatorType& allocator = document.GetAllocator();
document.AddMember("ID", 123, allocator);
rapidjson::Value array(rapidjson::kArrayType);
rapidjson::Value object(rapidjson::kObjectType);
object.AddMember("no", 1, allocator);
object.AddMember("content", "hello", allocator);
object.AddMember("state", true, allocator);
array.PushBack(object, allocator);
document.AddMember("info", array, allocator);
rapidjson::StringBuffer buffer;
rapidjson::Writer
writer(buffer);
document.Accept(writer);
return buffer.GetString();
}
通过rapidjson封装了一个json格式的数据并将其转化成字符串,其中rapidjson::Value array(rapidjson::kArrayType) 是定义JSON数组类型的Value对象,其中kArrayType是数组类型标志,是在rapidjson.h文件内的枚举类型中定义的
//! Type of JSON value
enum Type {
kNullType = 0, //!< null
kFalseType = 1, //!< false
kTrueType = 2, //!< true
kObjectType = 3, //!< object
kArrayType = 4, //!< array
kStringType = 5, //!< string
kNumberType = 6 //!< number
};
(3) 接下来就是重头戏的数据处理方法
void HttpHelper::onRequestCompleted(HttpClient* sender, HttpResponse* response)
{
if(!response){
return;
}
log("%s completed", response -> getHttpRequest() -> getTag());
int statusCode = response -> getResponseCode();
log("response code: %d", statusCode);
if(!response -> isSucceed()){
log("response failed");
log("error buffer: %s", response -> getErrorBuffer());
return;
}
// 得到返回数据流
std::vector
* responseData = response -> getResponseData();
// 将其转换成string并打印
std::string responseStr = std::string(responseData -> begin(), responseData -> end());
log("%s", responseStr.c_str());
// 声明文档对象
rapidjson::Document document;
// 将json数据进行解码,会对json格式进行有效性验证
document.Parse<0>(responseStr.c_str());
CCASSERT(!document.HasParseError(), "Parsing to document failed");
// 判断是不是对象
if(document.IsObject()){
// 判断有没有args键
if(document.HasMember("args")){
const rapidjson::Value& val_args = document["args"];
// 此处args为一个空对象
if(val_args.IsObject()){
log("args: \n");
}
}
// 判断是否有data键
if(document.HasMember("data")){
const rapidjson::Value& val_data = document["data"];
// 采用getString得到data的内容,必须与实际储存的数据格式相一致,
// 否则会报错
log("data: %s \n", val_data.GetString());
}
if(document.HasMember("json")){
const rapidjson::Value& val_form = document["json"];
if(val_form.IsObject()){
log("json:{");
if(val_form.HasMember("ID")){
log(" ID: %d", val_form["ID"].GetInt());
}
if(val_form.HasMember("info")){
const rapidjson::Value& info = val_form["info"];
CC_ASSERT(info.IsArray());
// 由于info储存的信息为一个数组,因此需要循环遍历内容
log(" info: { ");
for(unsigned int i = 0; i < info.Size(); ++i){
// 获得一条记录对象
const rapidjson::Value& record = info[i];
CC_ASSERT(record.HasMember("no"));
log(" no: %d", record["no"].GetInt());
CC_ASSERT(record.HasMember("content"));
log(" content: %s", record["content"].GetString());
}
}
log(" } \n");
}
}
if(document.HasMember("origin")){
const rapidjson::Value& val_visitor = document["origin"];
log("origin: %s \n", val_visitor.GetString());
}
if(document.HasMember("url")){
const rapidjson::Value& val_headers = document["url"];
log("url: %s \n", val_headers.GetString());
}
}
}
可以看到采用rapidjson的解码过程真的是很复杂。。在取某个键所对应的值之前,最好先判断其是否存在或者用断言,否则没有这个键的时候会直接报错。
程序运行之后的输出如下:
下面是解码时打印的数据:
到此就完成了cocos2dx中采用HttpClient 和rapidjson来post json格式数据的网络请求。总的来说不是很麻烦,但是我在查找资料过程中没有找到一篇能完美解决问题的文章。。所以纪录一下,希望对后来者有用。