Cocos网络篇[3.2](2) ——HTTP连接

【唠叨】

    HTTP用于客户端终端(用户)与服务器(WEB)之间的数据通讯。

    若菜不懂WEB,也不会服务端开发。所以在这里只能讲讲客户端如果使用http连接WEB服务器了。

    常见的WEB服务器有PHP、JSP、ASP等。

    Cocos为我们封装了HTTP客户端的接口:HttpClient类。HttpClient封装了各种对象,处理cookies,身份认证,连接管理等。


【参考】

    http://blog.****.net/jackystudio/article/details/17347069 (弱联网与服务器的通讯)


【Demo下载】

    https://github.com/shahdza/Cocos_LearningTest/tree/master/HttpClient 




【HTTP简介】

    Wiki百科 :http://zh.m.wikipedia.org/wiki/Http 

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

    HTTP是一个无连接,无状态连接的应用层协议,由请求 — 响应构成,是标准的C/S模型,主要解决如何包装数据。

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

    HTTP主要由两种请求方式:GET、POST

1
2
3
4
5
6
7
//
    // 用GET获取表单数据,表单数据对任何人都是可见的
    http://www.abc.com/index.php?username=shahdza&password=123
 
    // 用POST获取表单数据,表单数据则是不可见的
    http://www.abc.com.cn/index.php
//

        > get是从服务器上获取(查询)数据;而post是向服务器传送(修改)数据。

        > get传输数据量较小,2KB;而post传输一般不受限制。

        > get安全性非常低,但执行效率比较好;而post安全性相对来说就比较好。

    建议:在做数据查询时用get方式,而在做数据添加,修改或删除时用post方式。


【HTTP连接的步骤】

    (1)客户端请求服务器连接。

    (2)客户端发送GET或POST指令,请求数据。

    (3)服务端接收到请求数据指令后,发送响应请求的数据。

    (4)释放连接,一次连接结束。

Cocos网络篇[3.2](2) ——HTTP连接




【HttpClient】

    Cocos为我们封装了HTTP客户端的接口:HttpClient类

    HttpClient类是一个单例类,用于管理HTTP连接请求。

    HttpClient封装了各种对象,处理cookies,身份认证,连接管理等。

    还有两个重要的类:

        > HttpRequest :提供发送HTTP请求有关的数据信息(包含:url、请求方式、数据、响应函数等信息)

        > HttpResponse :服务器返回的响应信息(包含:响应代码、错误信息、响应的数据等信息)


0、引入头文件

1
2
3
4
//
    #include "network/HttpClient.h"
    using namespace network;
//


1、相关函数

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
62
63
//
/**
 * HttpRequest 相关
 **/
HttpRequest 
{
    // 请求方式
    HttpRequest::Type::GET
    HttpRequest::Type::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 相关
 **/
HttpResponse 
{
    // HTTP请求是否成功
    bool isSucceed();
 
    // 响应代码
    long getResponseCode();
 
    // 错误信息
    const char* getErrorBuffer();
 
    // 发送回来的响应数据信息
    std::vector<char>* getResponseData();
};
 
/**
 * HttpClient 相关
 **/
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;};
};
//


2、使用步骤

    (1)创建HttpRequest请求

    (2)设置request请求的url、请求方式GET/POST、发送的数据、请求的响应函数。

    (3)发送request请求,HttpClient::getInstance()->send(request); 。

    (4)处理请求的响应函数。

    (5)释放HTTP连接。


3、代码例子

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
62
63
64
65
//
// 发送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");
}
//


4、运行结果

Cocos网络篇[3.2](2) ——HTTP连接