Libcurl的初步实现tfp上传下载功能

该学习笔记的目标是利用libcurl实现ftp文件上传和下载功能

一、Libcurlde的简介

Libcurl是一个免费的并且易于使用的利用url进行文件传输的库。, libcurl当前支持DICT, FILE, FTP, FTPS, Gopher, HTTP, HTTPS, IMAP, IMAPS, LDAP,LDAPS, POP3, POP3S, RTMP, RTSP, SCP, SFTP, SMTP, SMTPS, Telnet and TFTP协议。libcurl同样支持HTTPS证书授权，HTTP POST, HTTP PUT, FTP 上传, HTTP基本表单上传，代理，cookies,和用户认证。

Libcurl是一个轻量级的库，编译后能够运行到多种平台，包括：Solaris, NetBSD, FreeBSD, OpenBSD, Darwin, HPUX, IRIX, AIX, Tru64,Linux, UnixWare, HURD, Windows, Amiga, OS/2, BeOs, Mac OS X, Ultrix, QNX,OpenVMS, RISC OS, Novell NetWare, DOS 等

二、libcurl的接口

Libcurl分为简单和复杂的接口。简单的接口是一个同步的，高效的，快速的，这种借口主要用于文件传输。大量的应用程序都使用这种方式。而复杂的姐姐偶是一个异步的，在这里不做过多研究

三、libcurl简单的接口工作流程

1、使用libcurl中的curl_easy_init()来初始化一个简单的文件传输会话并且获取到一个handle

2、通过使用curl_easy_setopt()来设置所有的选项参数，在这些参数中最重要的就是URL，同时你也极有可能需要设置一些回调函数，这些回调函数将会在条件符合的情况下被调用。

3、当上面的工作都做完了的时候，就可以使用curl_easy_perform()通知libcurl进行文件传输了，该函数在整个传输过程完成或者失败的时候才会返回一个值。

4、当你执行了第3步之后，你可以使用curl_easy_getinfo()来获取传输的信息

5、最后，你同样可以使用curl_easy_cleanup()来结束本次文件会话

下面针对这五个步骤，编写一个实例进行测试

四、部分功能函数的介绍

1、CURL *curl_easy_init( );

该函数必须首先调用，将会返回一个CURL*类型的handle.并且该函数将会和curl_easy_cleanup()一起配合使用。加入初始化出错的话，该函数将会返回一个NULL；

2、void curl_easy_cleanup(CURL *handle)

该函数一定是最后被调用的，他的参数应该是curl_easy_init的返回值；

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

该函数从名字上看就知道是设置一些参数的，通过设置不同的参数，将会改变libcurl的功能作用，这个需要仔细阅读指导文档，一旦设置方式不恰当，导致的错误将是致命的。

具体参数的使用方式在这个网址上描述的很详细

http://curl.haxx.se/libcurl/c/curl_easy_setopt.html

4、CURLcode curl_easy_perform(CURL * easy_handle);

像我们刚才提到的那样，这个函数应该是在init和setopt之后使用的，这个函数一旦执行，将会通知libcurl执行我们之前设置的所有方法，值得注意的是，当一个handle被加入到一个multi handle中之后，该参数handle将不能被函数perform调用

五、实例演示

1、下面来看一个简单的实例：

#include<stdio.h>
#include<curl/curl.h>
int main(int argc,char** argv)
{
    CURL *pCurlHandle = NULL;
    CURLcode errorCode = 0;
    /*1. 初始化一个pCurlHandle*/
    pCurlHandle = curl_easy_init();

    if( pCurlHandle )
    {
        /*2. 设置pCurlHandle的URL*/
        curl_easy_setopt( pCurlHandle,CURLOPT_URL, "http://blog.csdn.net/jxnu_xiaobing" );
        /*3. 因为上述网址已被重定向了，所以设置为CURLOPT_FOLLOWLOCATION*/
        curl_easy_setopt( pCurlHandle,CURLOPT_FOLLOWLOCATION, 1L );
        /*4. 开始执行上述opt*/
        errorCode = curl_easy_perform(pCurlHandle );
        if( errorCode != CURLE_OK )
        {
                printf("curl_easy_perform()  failed \n ");
        }
    }
    else
    {
        printf(" curl_easy_init()  failed \n ");
    }
    /*5. 最后关闭pCurlHandle*/
    curl_easy_cleanup( pCurlHandle );
    return 0;
}

2、上述的例子比较简单就是一个访问网页的例子，下面继续学习一个ftp上传的例子

#include<stdio.h>
#include<string.h>
#include<curl/curl.h>
#include<sys/types.h>
#include<sys/stat.h>
#include<fcntl.h>
#include<errno.h>
#include<unistd.h>

#defineLOCAL_FILE     "/tmp/xiaobing.txt"
#defineREMOTE_URL     "ftp://172.30.26.247:21/xiaobing.txt" 

static size_tread_callback(void *ptr, size_t size, size_t nmemb, void *stream)
{
  curl_off_t nread;
  /* in real-world cases, this would probablyget this data differently
     as this fread() stuff is exactly what thelibrary already would do
     by default internally */
  size_t retcode = fread(ptr, size, nmemb,(FILE*)stream);

  nread = (curl_off_t)retcode;

  fprintf(stderr, "*** We read %"CURL_FORMAT_CURL_OFF_T
          " bytes from file\n",nread);
  return retcode;
}

int main(int argc,char **argv)
{
  CURL *pCurlhandle;
  CURLcode res;
  FILE *hd_src;
  struct stat file_info;
  curl_off_t fsize;

  /*1. 获取待上传文件的大小 */
  if(stat(LOCAL_FILE, &file_info)) {
    printf("Couldnt open '%s': %s\n",LOCAL_FILE, strerror(errno));
    return 1;
  }
  fsize = (curl_off_t)file_info.st_size;

  printf("Local file size: %"CURL_FORMAT_CURL_OFF_T " bytes.\n", fsize);

  /*2. 获取待上传文件的描述符 */
  hd_src = fopen(LOCAL_FILE, "rb");

  /*3. 初始化所有可能的调用*/
  curl_global_init(CURL_GLOBAL_ALL);

  /*4. 创建一个curlhandle*/
  pCurlhandle = curl_easy_init();
  if(curl)
    {

      /*5.设置一个回调函数 */
     curl_easy_setopt(pCurlhandle, CURLOPT_READFUNCTION, read_callback);

      /*6.使能上传标志位 */
     curl_easy_setopt(pCurlhandle, CURLOPT_UPLOAD, 1L);

      /*7.指定ftp服务器的url */
     curl_easy_setopt(pCurlhandle,CURLOPT_URL, REMOTE_URL);

      /*8.指定需要上传的文件 */
     curl_easy_setopt(pCurlhandle, CURLOPT_READDATA, hd_src);

      /*9.设置待上传文件的大小，这个大小是上面获取到的注意：当参数
      为CURLOPT_INFILESIZE_LARGE的时候，size类型应该是curl_off_t的，
      当参数为CURLOPT_INFILESIZE的时候size应该是long类型的*/
     curl_easy_setopt(pCurlhandle, CURLOPT_INFILESIZE_LARGE,
                       (curl_off_t)fsize);

     /*10. 开始执行我们上述设定的方法*/
      res= curl_easy_perform(pCurlhandle);
     /*11. 检查是否执行成功 */
     if(res != CURLE_OK)
       fprintf(stderr, "curl_easy_perform() failed: %s\n",
               curl_easy_strerror(res));

    /*12. 关闭pCurlhandle*/
     curl_easy_cleanup(pCurlhandle);
    }
  fclose(hd_src); /* close the local file */
  /*13. 清除所有可能的调用*/
  curl_global_cleanup();
  return 0;
}

上述程序就能够实现ftp上传文件

3、最后来看一个tfp下载的实例：

/*************************************************************************************
 *  * 文件名:              TfpcurlDownload.c
 *  * 功能:                curl测试程序
 *  * 作者:                http://blog.csdn.net/King_BingGe
 *  * 创建时间:            2014年09月29号
 *  * 最后修改时间:				 2014年09月29号
 *  * 详细:                无
 *  **************************************************************************************/
#include <stdio.h>
#include <string.h>
#include <curl/curl.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <fcntl.h>
#include <errno.h>
#include <unistd.h>

#define REMOTE_URL      "ftp://172.30.26.247:21/xiao.txt"  

typedef struct Ftpfile {
  const char *filename;
  FILE *stream;
}Cftpfile;

static size_t write_callback(void *ptr, size_t size, size_t nmemb, void *stream)
{
  Cftpfile *out = (Cftpfile*)stream;
  if( out && !out->stream )
  {
        out->stream = fopen(out->filename, "wb");
        if(!out->stream)
        {
                printf("write_callback failed \n ");
                return -1;
        }
  }
  return fwrite(ptr, size, nmemb, out->stream);
}

int main(int argc, char **argv)
{
  CURL *pCurlhandle;
  CURLcode res;
  curl_off_t fsize;

  Cftpfile ftpfile = {
  	"/tmp/xiaoxiao.txt"	,
    NULL
  };

  /*3. 初始化所有可能的调用*/
  curl_global_init(CURL_GLOBAL_ALL);

  /*4. 创建一个curlhandle*/
  pCurlhandle = curl_easy_init();
  if(pCurlhandle)
  {
    /*5. 设置一个回调函数 */
    curl_easy_setopt(pCurlhandle, CURLOPT_WRITEFUNCTION, write_callback );
    /*7. 指定ftp服务器的url */
    curl_easy_setopt(pCurlhandle,CURLOPT_URL, REMOTE_URL);

    /*8. 指定需要上传的文件 */
    curl_easy_setopt(pCurlhandle, CURLOPT_USERPWD, "cdn_ftp:123456");

    /*9. 指定需要上传的文件 */
    curl_easy_setopt(pCurlhandle, CURLOPT_WRITEDATA, &ftpfile );

    /*10. 设置待下载文件的大小，这个大小是上面获取到的注意：当参数
    为CURLOPT_INFILESIZE_LARGE的时候，size类型应该是curl_off_t的，
    当参数为CURLOPT_INFILESIZE的时候size应该是long类型的*/
    curl_easy_setopt(pCurlhandle, CURLOPT_INFILESIZE_LARGE,
                     (curl_off_t)fsize);
    /*11. 开始执行我们上述设定的方法 */
    res = curl_easy_perform(pCurlhandle);
    /*12. 检查是否执行成功 */
    if(res != CURLE_OK)
      fprintf(stderr, "curl_easy_perform() failed: %s\n",
              curl_easy_strerror(res));

    /*13. 关闭pCurlhandle*/
    curl_easy_cleanup(pCurlhandle);
  }
  else
  {
        printf("curl_easy_init failed \n ");
  }
  /*14. 清除所有可能的调用*/
  curl_global_cleanup();
  return 0;
}
时间： 2024-10-31 09:43:00

Libcurl的初步实现tfp上传下载功能的相关文章

java上传下载功能的实现

上传下载是很简单的功能,但是每次用的时候还是要查,这里整理一下 前台:   <form action="xxoo.do" enctype="multipart/form-data" method="post"> <input type="file" name="file" />  <button type="submit" class="btn b

JavaWeb实现文件上传下载功能实例解析

转:http://www.cnblogs.com/xdp-gacl/p/4200090.html JavaWeb实现文件上传下载功能实例解析 在Web应用系统开发中,文件上传和下载功能是非常常用的功能,今天来讲一下JavaWeb中的文件上传和下载功能的实现. 对于文件上传,浏览器在上传的过程中是将文件以流的形式提交到服务器端的,如果直接使用Servlet获取上传文件的输入流然后再解析里面的请求参数是比较麻烦,所以一般选择采用apache的开源工具common-fileupload这个文件上传组件

Asp.net实现MVC处理文件的上传下载功能实例教程

这篇文章主要介绍了Asp.net实现MVC处理文件的上传下载功能,比较全面而系统的对Asp.net MVC的文件上传下载功能进行了深入分析,有很好的借鉴价值,需要的朋友可以参考下 上传于下载功能是程序设计中非常常见的一个功能,在ASP.NET程序开发中有着非常广泛的应用.本文就以实例形式来实现这一功能. 一.概述 如果你仅仅只有Asp.net Web Forms背景转而学习Asp.net MVC的,我想你的第一个经历或许是那些曾经让你的编程变得愉悦无比的服务端控件都驾鹤西去了.FileUploa

JavaWeb实现文件上传下载功能实例解析 （好用）

转: 转:http://www.cnblogs.com/xdp-gacl/p/4200090.html JavaWeb实现文件上传下载功能实例解析 在Web应用系统开发中,文件上传和下载功能是非常常用的功能,今天来讲一下JavaWeb中的文件上传和下载功能的实现. 对于文件上传,浏览器在上传的过程中是将文件以流的形式提交到服务器端的,如果直接使用Servlet获取上传文件的输入流然后再解析里面的请求参数是比较麻烦,所以一般选择采用apache的开源工具common-fileupload这个文件上

基于Java的一个简单的文件上传下载功能

最近在公司给客户端做接口,有一个图片上传和文件下载的功能,本来想用Struts来做文件上传下载,但是看了下公司好像没有这个配置,然后看了下同事的代码,才发现原来Apache也可以简单的实现文件上传下载. 首先引入commons-io-2.2.jar FileUtils为我们提供了很多对文件的操作的方法,比如上传整个文件夹的文件.上传单个文件等 然后请看代码下载: public static void uploadFile(String targetDirectory,String targetF

Libcurl最初的实现tfp上传和下载功能

研究报告指出的目标是使用libcurl实现ftp文件上传和下载功能 一.Libcurlde简要 Libcurl的而且易于使用的利用url进行文件传输的库. , libcurl当前支持DICT, FILE, FTP, FTPS, Gopher, HTTP, HTTPS, IMAP, IMAPS, LDAP,LDAPS, POP3, POP3S, RTMP, RTSP, SCP, SFTP, SMTP, SMTPS, Telnet and TFTP协议.libcurl相同支持HTTPS证书授权,HT

Java实现FTP上传下载功能

Java FTP客户端工具包很多,在此我选用的Apache的FTPClient.这个包的获取可以通过http://commons.apache.org/net/来获取,我使用的是最新的commons-net-1.4.1.zip.其中包含了众多的java网络编程的工具包,官方文档列举如下: 1.支持网络协议如下: FTP.NNTP. SMTP.POP3.Telnet.TFTP.Finger.Whois.rexec/rcmd/rlogin.Time (rdate) and Daytime.Echo.

biweb后台添加上传下载功能

1.数据库对应表添加字段 file       varchar(100) 2.对应的后台 模块名/admin/addinfo.php里添加如下代码: //文件上传 if ((($_FILES["file"]["type"] == "image/doc")         || ($_FILES["file"]["type"] == "image/docx")         || ($_

selectors 模块完成文件上传下载功能

1 ############ server端 2 3 import selectors,socket,time,pickle,os,struct 4 ip_port = ('192.168.43.182',8080) 5 buffer_size = 1024 6 back_log = 5 7 BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) 8 9 class SelectorsServer: 10 de