libcurl

使用libcurl进行文件下载类项目开发

　　(一)、libcurl简单使用介绍

　　(二)、用libcurl实现获取目标文件大小, 下载进度显示, 断点续传等功能

　　(三)、Libcurl中使用curl_easy_perform阻塞, 遇到无信号卡死的完美解决方案

　　(四)、使用Libcurl下载文件,解决无信号中断,下载中掉电恢复后断点续传问题的源代码

Libcurl使用介绍:

       四个关键函数:

　　　　1. curl_easy_init() 初始化curl环境,新建curl对象,返回对象句柄,使用举例:    CURL *handler = curl_easy_init();

　　　　2. curl_easy_setopt() 各种设置, 包括URL设置等,使用举例:

  　　　　　　　curl_easy_setopt(handler, CURLOPT_URL, “www.baidu.com”),其中中间的参数是设置的类别,比较重要,后面会列举说明.

　　　　3. curl_easy_perform() 开始执行下载操作, 若下载失败会返回错误码.例如: CURLcode code = curl_easy_perform(handler)

　　　　4. curl_easy_getinfo() 得到各种下载信息, 包括下载文件名,文件大小等,此操作必须放在curl_easy_perform()之后执行才能得到正确的值.使用举例: long resultCode;

   　　　　curl_easy_getinfo(handler, CURLINFO_RESPONSE_CODE, &resultCode);

　　必要的参数说明

   　　　　curl_easy_setopt()参数:

    　　　　 CURLOPT_URL  设置目标URL地址

     　　　　CURLOPT_HEADER 是否包含http头,包含则设置为一个非0值

     　　　　CURLOPT_NOBODY 如果你不需要http的body部分(除header头以外其他部分),设置此项为一个非0值

     　　　　CURLOPT_TIMETOU 设置一个超时时间,若超过此时间perform会立即返回,返回码为下载失败对应错误码,单位秒.注意此时间为从调用perform开始后的总的下载时间

　　　　　　　　举例curl_easy_setopt(handler, CURLOPT_TIMEOUT, 30) 设置超时时间为30秒,即下载必须在30秒内完成,否则返回下载失败

     　　　　CURLOPT_CONNECTIONTIMEOUT 连接超时时间,单位秒.这个参数在easy curl下载中基本没什么实用价值.

    　　　　 CURLOPT_RESUME_FROM_LARGE 从什么位置开始下载,断点续传主要使用此参数进行配置,使用非常简单,只需要传递一个字节偏移量即可,例如

 　　　　　　curl_easy_setopt(handler, CURLOPT_ RESUME_FROM, 0),表示从第0个字节开始下载, curl_easy_setopt(handler, CURLOPT_ RESUME_FROM, 500),从第500个字节开始下载

    　　　　 CURLOPT_RANGE 下载指定字节的文件块,参数对应的值格式为X-Y,例如curl_easy_setopt(handler, CURLOPT_ RESUME_FROM, “500-”),下载从500个字节开始到字节结束的文件块

     　　　　CURLOPT_NOPROGRESS 如果不需要下载进度设置此项为一个非0值

    　　　　 CURLOPT_PROGRESSFUNCTION 设置回调的进度函数,设置后,会不断的调用进度函数,并传递参数总大小和已下载大小给该函数

     　　　　CURLOPT_PROGRESSDATA 设置传递给回调的进度函数的一个参数,类型为字符串类型,后面jwisp会举例说明

　　　　　　curl_easy_getinfo() 部分参数说明

    　　　　 CURLINFO_RESPONSE_CODE 得到perform的执行结果码

     　　　　CURLINFO_CONTENT_LENGTH_DOWNLOAD 得到下载文件大小

使用libcurl的过程中,如何获取下载目标文件的大小, 下载进度条,断点续传等,这些基本的函数,将为在最后处理下载过程异常中断等问题提供支持.

　　1. 编写得到下载目标文件的大小的函数

 1 long getDownloadFileLenth(const char *url){  
 2     long downloadFileLenth = 0;  
 3     CURL *handle = curl_easy_init();  
 4     curl_easy_setopt(handle, CURLOPT_URL, url);  
 5     curl_easy_setopt(handle, CURLOPT_HEADER, 1);    //只需要header头  
 6     curl_easy_setopt(handle, CURLOPT_NOBODY, 1);    //不需要body  
 7     if (curl_easy_perform(handle) == CURLE_OK) {  
 8         curl_easy_getinfo(handle, CURLINFO_CONTENT_LENGTH_DOWNLOAD, &downloadFileLenth);  
 9     } else {  
10         downloadFileLenth = -1;  
11     }  
12     return downloadFileLenth;  
13 }  

　　2. 下载中回调自己写的得到下载进度值的函数

　　　　下载回调函数的原型应该为:

　　　　应该在外部声明一个远程下载文件大小的全局变量

　　　　为了断点续传, 还应该声明一个本地文件大小的全局变

　　　　　　double localFileLenth = 0;  

　　　　编写一个得到进度值的函数getProgressValue()

 1 int getProgressValue(const char* flag, double dt, double dn, double ult, double uln){  
 2     double showTotal, showNow;  
 3     if (downloadFileLenth == 0){  
 4         downloadFileLenth = getDownloadFileLenth(url);  
 5     }  
 6     showTotal = downloadFileLenth;  
 7     if (localFileLenth == 0){  
 8         localFileLenth = getLocalFileLenth(filePath);  
 9     }  
10     showNow = localFileLenth + dn;  
11     //然后就可以调用你自己的进度显示函数了, 这里假设已经有一个进度函数, 那么只需要传递当前下载值和总下载值即可.  
12     showProgressValue(showNow, showTotal);  
13 }  

　　c.在下载中进行三个下载参数的设置

1 curl_easy_setopt(handle, CURLOPT_NOPROGRESS, 0);  
2   
3 curl_easy_setopt(handle, CURLOPT_PROGRESSFUNCTION, getProgressValue);  //设置回调的进度函数  
4   
5 curl_easy_setopt(handle, CURLOPT_PROGRESSDATA, “flag”);   //此设置对应上面的const char *flag  

　　3.  断点续传

　　用libcurl实现断点续传很简单,只用两步即可实现,一是要得到本地文件已下载的大小,通过函数getLocalFileLenth()方法来得到,二是设置CURLOPT_RESUME_FROM_LARGE参数的值为已下载本地文件大小.

　　得到本地文件大小的函数:

　　设置下载点如下即可: