QFtpLib

QFtpLib头文件：

//名称：QFtpLib //描述：基于Winsock2实现的一个Q版的FTP客户端协议库 //作者：冷却 //时间：2010-6-14 //版本：v1.0 正式发布版 #ifndef _QFTP_H_ #define _QFTP_H_ #include <WinSock2.h> #include <string> #include <vector> using namespace std; typedef void* QFtpHandle; //QFTP返回码 #define ERROR_QFTP_BASE (-1000) #define ERROR_QFTP_OK (0) #define ERROR_QFTP_UNKNOWN_ERROR (ERROR_QFTP_BASE+0) //未知类型的错误 #define ERROR_QFTP_WSASTARTUP_FAILED (ERROR_QFTP_BASE+1) //初始化winsock2库失败 #define ERROR_QFTP_GETSOCKET_FAILED (ERROR_QFTP_BASE+2) //获取socket句柄失败 #define ERROR_QFTP_CLOSESOCKET_FAILED (ERROR_QFTP_BASE+3) //关闭socket句柄失败 #define ERROR_QFTP_PARAMETER_INVALID (ERROR_QFTP_BASE+4) //无效参数 #define ERROR_QFTP_OPENHANDLE_TOOMUCH (ERROR_QFTP_BASE+5) //同时打开的句柄数太多 #define ERROR_QFTP_SENDPASV_FAILED (ERROR_QFTP_BASE+6) //[PASV]命令执行失败 #define ERROR_QFTP_COMMAND_NOSUPPORTED (ERROR_QFTP_BASE+7) //该命令暂不支持 #define ERROR_QFTP_CREATEDIR_FAILED (ERROR_QFTP_BASE+8) //创建目录失败 #define ERROR_QFTP_RECVDATA_TOOLONG (ERROR_QFTP_BASE+9) //服务器返回的信息长度超过接收缓冲区的大小 #define ERROR_QFTP_NEW_FAILED (ERROR_QFTP_BASE+10)//内存不足导致new操作失败 namespace nsQFTP { //[说明] 初始化QFtpLib INT QFtpInitialize(VOID); //[说明] 卸载QFtpLib，释放相关的资源。 INT QFtpUnInitialize(VOID); //[说明] 登录ftp服务器 //[备注] 若返回的句柄值为NULL，则表明发生了错误，详细的错误码存放在piErr所指向的内容中。 QFtpHandle LoginFtp(LPCSTR szIP, LPCSTR szUser, LPCSTR szPass, INT* piErr=NULL); //[说明] 登出ftp服务器 INT LogoutFtp(QFtpHandle hQFtp); //[说明] 关闭句柄 INT CloseQFtpHandle(QFtpHandle hQFtp); //[说明] 数据接收回调函数 typedef INT (CALLBACK *RECV_DATA_CALLBACK)(PBYTE pbResultsData, UINT uDataLen, LPVOID lpParam); //[说明] 设置数据接收回调 INT SetCallBack(QFtpHandle hQFtp, RECV_DATA_CALLBACK pCbFunc, LPVOID lpCbFuncParam=NULL); //[说明] 上传数据 //[备注] fAutoCreateDir：是否自动创建不存在的目录 // fAppend: 是否附加数据到指定文件后 INT SaveData(QFtpHandle hQFtp, LPCSTR szSaveFileFullName, PBYTE pbDataForSend, UINT uDataLen, BOOL fAutoCreateDir=TRUE, BOOL fAppend=FALSE); //[说明] 下载数据 INT LoadData(QFtpHandle hQFtp, LPCSTR szLoadFileFullName); //[说明] 删除文件 INT DelFile(QFtpHandle hQFtp, LPCSTR szDestFile); //[说明] 删除空目录 INT DelEmptyDir(QFtpHandle hQFtp, LPCSTR szDestDirectory); //[说明] 测试连接的有效性 INT ConnectTest(QFtpHandle hQFtp); //[说明] 获取ftp服务器端返回的最新错误码以及详细错误信息 INT GetLastErrCode(QFtpHandle hQFtp, INT& iErrCode, LPSTR* pszErrInfo=NULL); //[说明] 执行ftp命令 //[备注] 目前支持的命令有：NOOP、DELE、XRMD、XCWD、XPWD、XMKD、STOR、APPE、RETR、NLST、LIST // 其中的部分命令执行后会有返回数据，这些数据可在“SetCallBack”所设置的数据接收回调函数中获取。 // wConnectType必须为0，表示以被动模式连接。 INT ExecFtpCommand(QFtpHandle hQFtp, LPCSTR szCommand, PBYTE pbDataForSend=NULL, UINT uDataLen=0, WORD wConnectType=0); //[说明] 列出指定目录的下一级内容 //[备注] 结果将存入vContentList，或通过数据接收回调函数获取。 INT ListDir(QFtpHandle hQFtp, LPCSTR szDir, vector<string>* vContentList); } #endif

 

Demo演示：

#include <stdio.h> #include "qftp.h" using namespace nsQFTP; //数据接收回调函数 INT CALLBACK RecvResult(PBYTE pbResultsData, UINT uDataLen, LPVOID lpParam); int main(void) { int iErr=0; char* pszErrInfo=NULL; //初始化 QFtpInitialize(); //登录ftp QFtpHandle h = LoginFtp("127.0.0.1", "anonymous", "anonymous@anonymous.com"); //设置数据接收回调函数 SetCallBack(h, RecvResult); //列出“/”目录（根目录）的下一级内容 vector<string> vList; ListDir(h, "/", &vList); for ( vector<string>::iterator it = vList.begin(); it != vList.end(); ++it ) { printf("%s/r/n", (*it).c_str()); } //上传数据 if ( ERROR_QFTP_OK == SaveData(h, "/a/b/c/hi.txt", PBYTE("hi"), (UINT)strlen("hi")) ) { printf("上传数据成功/r/n"); } else { GetLastErrCode(h, iErr, &pszErrInfo); printf("上传失败：iErr = %d, pszErrInfo = [%s]/r/n", iErr,pszErrInfo); } //下载数据 if ( ERROR_QFTP_OK == LoadData(h, "/a/b/c/hi.txt") ) { printf("下载数据成功/r/n"); } else { GetLastErrCode(h, iErr, &pszErrInfo); printf("下载失败：iErr = %d, pszErrInfo = [%s]/r/n", iErr,pszErrInfo); } //直接执行ftp命令 ExecFtpCommand(h, "XPWD"); //登出ftp LogoutFtp(h); //关闭句柄 CloseQFtpHandle(h); //卸载QFtp库 QFtpUnInitialize(); printf("Exit..."); getchar(); return 0; } char g_Buffer[1024*1024]; INT CALLBACK RecvResult(PBYTE pbResultsData, UINT uDataLen, LPVOID lpParam) { memcpy(g_Buffer, pbResultsData, uDataLen); memset(g_Buffer+uDataLen, 0, 1); printf("数据：[%d] %s/n", uDataLen,g_Buffer); return 0; }

 

在本人机器上运行Demo演示程序后的输出：

 

 

说明：

一个很精简的FTP客户端协议的实现，同时考虑到可移植性，把socket套接口分离出来了，你可以根据不同平台的特点重新实现这些socket套接口函数就行了。

最后，感谢你的使用，希望它能对你有用！Enjoy yourself！

 

下载地址：http://download.youkuaiyun.com/source/2482291