CURL 开源网络库

时间:2022-10-19 18:09:30

~~~~我的生活,我的点点滴滴!!


游戏之中需要用到大量的客户端与服务端交互的东西,自己动手去实现网络库那是重复造*,并且稳定性、效率等不见得好,下面介绍

一个开源网络库CURL,引用百度百科对CURL的介绍:

      curl是一个基于命令行的应用工具,提供利用URL标准进行文件传输的功能。目前已经支持非常多的流行的互联网协议,如:FTP, 

FTPS, HTTP, HTTPS, SCP, SFTP, TFTP, TELNET, DICT, LDAP, LDAPS and FILE等。curl支持SSL认证,HTTP POST/PUT,FTP上传,HTTP

上传、代理、cookies、用户+密码认证、文件续传、代理管道等一系列强大功能。curl是用C语言写的,但是绑定了很多开发语言。大体

上可以把curl分成命令行工具和libcurl库两个部分,命令行工具可以直接输入指令完成相应功能,libcurl则是一个客户端URL传输库,

是线程安全且兼容IPv6,可以非常方便地用来做相关开发。


       
curl可以使用命令行直接操作,也可以使用libcurl库进行上层应用的开发。我们这里主要讲解libcurl库的使用,平台:win7 编

译器:VS2012 引擎:cocos2dx


       libcurl提供了一组C语言API函数直接调用。首先需要提到的两个函数就是curl_global_init()和curl_global_cleanup()。libcurl

要用到一系列的全局常量,curl_global_init()初始化这些变量,并分配一些全局资源;curl_global_cleanup()释放这些资源。因此一般情

况下,在调用libcurl函数之前,先用curl_global_init(CURL_GLOBAL_ALL)做初始化,在调用完毕后,用curl_global_cleanup()退出。需要

注意的是,这些全局变量和资源不是线程安全的,因此在多线程的环境中,最好不要多次调用curl_global_init()和curl_global_cleanup()。


libcurl支持3种不同接口调用方式,分别是"easy"、"multi"和"share"模式。

a、libcurl-easy是一组同步接口,函数都是curl_easy_*形式,这种模式调用curl_easy_perform()函数进行URL数据传输,直到传输完成函数

   才返回;

b、libcurl-multi是一组异步接口,函数都是curl_multi_*形式,调用curl_multi_perform()函数进行传输,但是每次调用只传一片数据,我

   们可以用select()函数控制多个下载任务进行同步下载,来实现在一个线程中同时下载多个文件;

c、libcurl-share允许在多线程中操作共享数据。


下面以libcurl-easy为例讲一下libcurl的函数。


1、CURL *curl_easy_init()

此函数需要最先被调用,返回CRUL easy句柄;后续其他函数调用都要用到这个句柄。如果没有调用curl_global_init(),该函数自动调用,但

是考虑到线程安全的问题,最好自己调用curl_global_init()。


2、CURLcode curl_easy_setopt(CURL *handle, CURLoption option, parameter)

所有参数和选项设置都是通过这个函数完成的,它告诉libcurl怎样去进行传输。参数handle即为curl_easy_init()返回的句柄,后面根据option

的类型,设置相应的parameter值,该函数每次调用只能设置一个选项。具体的option讲解在这篇博文中有较全面的介绍:

CURLOPT_URL

字符串类型,该选项设置要处理的URL地址,该选项是进行curl_easy_perform之前唯一必须要设置的选项。

CURLOPT_COOKIE

字符串类型,设置http头中的cookie信息。

CURLOPT_COOKIEFILE

字符串类型,同CURLOPT_COOKIE,不过cookie信息从文件中读取。

CURLOPT_FOLLOWLOCATION

布尔值类型,该参数设置为非零值表示follow服务器返回的重定向信息。

CURLOPT_POSTFIELDS

字符串类型,提交http的post操作字符串数据。

CURLOPT_TIMEOUT

long数值类型,设置函数执行的最长时间,时间单位为s。

CURLOPT_CONNECTTIMEOUT

long数值类型,设置连接服务器最长时间,时间单位为s;当置为0时表示无限长。

CURLOPT_MAX_RECV_SPEED_LARGE

curl_off_t类型数据,指定下载过程中最大速度,单位bytes/s。

CURLOPT_HEADERFUNCTION

函数指针类型,该选项设置一个处理接收到的header数据的回调函数,函数原型为:

size_t function( void *ptr, size_t size, size_t nmemb, void *stream);

其中,ptr指向接收到的header头数据,数据大小为size*nmemb,stream指向调用CURLOPT_WRITEHEADER选项设置的参数。

该回调函数应返回实际处理的数据量大小,或者出错返回-1。

CURLOPT_WRITEFUNCTION

函数指针类型,该选项设置一个处理接收到的下载数据的回调函数,函数原型为:

size_t function( void *ptr, size_t size, size_t nmemb, void *stream);

其中,ptr指向接收到的数据,数据大小为size*nmemb,stream指向调用CURLOPT_WRITEDATA选项设置的参数。

如果函数指针置为NULL,则会调用默认的函数,将数据写入到由CURLOPT_WRITEDATA指定的FILE*中。

CURLOPT_HTTPHEADER
curl_slist结构体类型,该选项自定义请求头信息。

CURLOPT_NOPROGRESS

布尔值类型,设置该值为非零值关闭PHP为CRUL传输显示的进度条。


3、void curl_easy_reset(CURL *handle )

重新初始化CURL句柄的选项设置。


4、CURLcode curl_easy_getinfo(CURL *curl, CURLINFO info, ... )

查询CRUL会话的内部信息,具体说明请参考curl自带文档。


5、void curl_easy_cleanup(CURL * handle )

该函数与curl_easy_init函数成对出现,handle即为调用curl_easy_init返回的句柄。该函数在CURL会话结束退出时调用,之后handle无效。


6、CURLcode curl_easy_perform(CURL *handle)

执行远程请求


下面引用别人的一个简单的使用CURL的easy方式(阻塞式连接)的例子:


.h文件里面添加代码:


//需要加入头文件
#include "curl/curl.h"


//回调函数声明
static size_t writehtml(uint8_t* ptr,size_t size,size_t number,void *stream);

.cpp文件里面添加代码:


void HallView::denglu(){//登陆游戏
CURL *curl;
CURLcode res;
string cc;
curl=curl_easy_init();
if(curl)
{
curl_easy_setopt(curl, CURLOPT_URL, ""); //设置请求的地址
curl_easy_setopt(curl, CURLOPT_POST, true); //设置数据类型
string caozuo="";
curl_easy_setopt(curl, CURLOPT_POSTFIELDS,caozuo.c_str()); //将操作代码,和连接的网站组合,一起发送!
curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
curl_easy_setopt(curl,CURLOPT_WRITEFUNCTION,HallView::writehtml); //数据处理回调函数
curl_easy_setopt(curl, CURLOPT_WRITEDATA, &cc);//缓冲的内存
curl_easy_setopt(curl,CURLOPT_TIMEOUT_MS,5000);//设置连接超时时间
res=curl_easy_perform(curl);
if(res!=CURLE_OK)
{
CCDictionary* pDict = CCDictionary::createWithContentsOfFile("chines.xml");
string mes=((CCString*)pDict->objectForKey("networking"))->getCString();
platform::showMsg(mes);
}
curl_easy_cleanup(curl);
}
else
{
CCLog("curl is null");
}
}


//回调函数处理
size_t HallView::writehtml(uint8_t* ptr,size_t size,size_t number,void *stream)
{
CCString* a=CCString::createWithFormat("%s",ptr);
std::string str1=a->getCString();
Json::Reader reader;//json解析
Json::Value value;//表示一个json格式的对象
if(reader.parse(str1,value))//解析出json放到json中区
{
string out=value["gameId"].asString();
gameda->gameId=out;
out=value["newIMSI"].asString();
gameda->newIMSI=out;
}
return size*number;//这里一定要返回实际返回的字节数
}