VC中实现FTP功能

来源:互联网 发布:蒙古音乐软件 编辑:程序博客网 时间:2024/05/16 15:51

 

要联接到FTP服务器,需要两个步骤,首先必须创建一个CInternetSession对象,用类CInterSession创建并初始化一个或几个同时存在的Internet会话(session),并描述与代理服务器的连接(如果有必要的话),如果在程序运行期间需要保持与Internet的连接,可以创建一个CInternetSession对象作为类CWinApp的成员。

---- MFC中的类CFtpConnection管理我们与Internet服务器的连接,并直接操作服务器上的目录和文件,FTP是MFC的WinInet支持的三个Internet功能之一,我们需要先创建一个CInternetSession实例和一个CFtpConnection对象就可以实现和一个FTP服务器的通信,我们不需要直接创建CFtpConnection对象,而是通过调用CInternetSession::GetFtpConnection来完成这项工作。它创建CFtpConnection对象并返回一个指向该对象的指针。

Ftp连接类的信息

---- 下面我们简要介绍连接类的信息

1.     CInternetSession对象

---- CInternetSession(LPCTSTR pstrAgent,DWORD dwConText ,DWORD dwAccessType,LPCTSTR pstrProxyName,LPCTSTR pstrProxyBypass,DWORD dwFlags);

---- 在创建CInternetSession对象时调用这个成员函数,CInternetSession是应用程序第一个要调用的Internet函数,它将创始化内部数据结构,以备将来在应用程序中调用。如果dwFlags包含INTERNET_FLAG_ASYNC,那末从这个句柄派生的所有的句柄,在状态回调例程注冊之前,都会出现异步状态。如果沒有打开Internet连接,CInternetSession就会抛出一个例外,AfxThorowInternetException。

2.     GetFtpConnection()函数

---- CFtpConnection* CIternetSession::GetFtpConnection(LPCTSTR pstrServer,LPCTSTR pstrUserName,LPCTSTR pstrPassword,INTERNET_PORT nPort,BOOL bPassive);

---- 调用这个函数建立一个FTP连接,并获得一个指向CFtpConnection对象的指针,GetFtpConnection连接到一个FTP服务器,创建并返回指向CFtpConnection对象的指针,它不在服务器上进行任何操作。如果打算读写文件,必须进行分步操作。关于查找,打开和读/写文件的信息需参考CFtpConnection和CFtpFileFind类。

---- 对这个函数的调用返回一个指向CFtpConnection对象的指针。如果调用失败,检查抛出的CInternetException对象,就可以确定失败的原因。

3.     GetFile()函数

---- BOOL GetFile(LPCTSTR pstrRemoteFile,LPCTSTR pstrLocalFile,BOOL bFailExists ,DWORD dwAttributes,DWORD dwFlags,DWORD dwContext);

---- 调用这个成员函数,可以从FTP服务器取得文件,并且把文件保存在本地机器上。GetFile()函数是一个比较高级的例程,它可以处理所有有关从FTP服务器读文件,以及把文件存放在本地机器上的工作。如果dwFlags为FILE_TRANSFER_TYPE_ASCII,文件数据的传输也会把控制和格式符转化为Windows中的等阶符号。默认的传输模式是二进制模式,文件会以和服务器上相同的格式被下载。

---- pstrRemoteFile和 pstrLocalFile可以是相对于当前目录的部分文件名,也可以是全文件名,在这两个名字中间,都既可以用反斜杠(/)或者正斜杠(/)来作为文件名的目录分隔符,GetFile()在使用前会把目录分隔符转化为适当的字符。

---- 可以用自己选择的值来取代dwContext默认的值,设置为上下文标识符与CFtpConnection对象的定位操作有关,这个操作由CFtpConnection中的CInternetSession对象创建。返回给CInternetSession::OnStatusCallBack的值指出了所标识操作的状态。

---- 如果调用成功,函数的返回为非0,否则返回0,如果调用失败,可以调用Win32函数GetLastError(),确认出错的原因。

4.     PutFile()函数

---- BOOL PutFile(LPCTSTR pstrLocalFile, LPCTSTR pstrRemoveFile ,DWORD dwFlags, DWORD dwContext);

---- 调用这个成员函数可以把文件保存到FTP服务器。PutFile()函数是一个比较高级的例程,它可以处理有关把文件存放到服务器上的工作。只发送数据,或要严格控制文件传输的应用程序,应该调用OpenFile和 CInternet::Write。利用自己选择的值来取代dwContext默认的值,设置为上下文标识符,上下文标识符是CInternetSession对象创建的CFtpConnection对象的特定操作有关,这个值返回给CInternetSession::OnStateCallBack,从而把操作的状态通报给它所标识的上下文。

---- 如果调用成功,函数的返回为非0,否则返回0,如果调用失败,可以调用Win32函数GetLastError(),确认出错的原因。

连接到FTP站点

---- 建立连接到ftp.microsoft.com的程序,它是一个单文档程序。并且连接由视图类的构造函数完成。

1.     建立单文档程序ftp

2.     在ftpview.h中加入包含#include < afxinet.h >

3.     在ftpview.h中添加如下的成员变量

4.     public:

5.     CInternetSession *m_pInetSession;

6.     CFtpConnection *m_pFtpConnection;

7.     在ftpview.cpp中的ftpview构造函数中加入下面的代码

8.     CFtpView::CFtpView()

9.     {

10.     m_pInetSession=new CInternetSession

11.     (AfxGetAppName(),1,

12.     PRE_CONFIG_INTERNET_ACCESS);

13.     try

14.     {

15.     m_pFtpConnection=m_pInetSession->

16.     GetFtpConnection("FTP.MICROSOFT.COM");

17.     }

18.     catch(CInternetException *pEx)

19.     {

20.     TCHAR szError[1024];

21.     if(pEx->GetErrorMessage(szError,1024))

22.     AfxMessageBox(szError);

23.     else

24.     AfxMessageBox("There was an exception");

25.           pEx->Delete();

26.           m_pFtpConnection=NULL;

27.       }

28.     }

29.     在ftpview.cpp中的ftpview析构函数中加入下面的代码

30.       CFtpView::~CFtpView()

31.       {

32.         if(m_pFtpConnection!=NULL)

33.         {

34.       m_pFtpConnection->Close();

35.       delete m_pFtpConnection;

36.         }

37.         delete m_pInetSession;

38.       }

39.     编译并且执行程序,如果连接出现问题,将会在一个消息框中报告出错消息。

发送文件到FTP文件服务器

---- 创建一个发送文件到FTP文件服务器的程序

40.     建立单文档程序ftpfw, 在ftpfwview.h中加入包含 #include < afxinet.h >

41.     在ftpfwview.h中添加如下的成员变量

42.     public:    

43.       bool m_bConnectionAttempted;

44.         int m_nFileStatus;

45.     在ftpview.cpp中的ftpview构造函数中加入下面的代码

46.     CFtpfwView::CFtpfwView()

47.     {  

48.         m_bConnectionAttempted=false;

49.     }

50.     使用ClassWizard加入新的类CFtpThread,该类派生于CWinThread 在ftpthread.h中加入如下变量

51.     public:

52.         static UINT PutFile(LPVOID Status);

53.     添加新类成员函数代码

54.     UINT CFtpThread::PutFile(LPVOID Status)

55.       {

56.     int *pnFileStatus;

57.     CInternetSession *pInetSession;

58.     CFtpConnection *pFtpConnection=NULL;

59.     pnFileStatus=(int *)Status;

60.     *pnFileStatus=0;

61.     pInetSession=new

62.     CInternetSession(AfxGetAppName(),1,

63.     PRE_CONFIG_INTERNET_ACCESS);

64.     try

65.     {

66.     pFtpConnection=pInetSession->

67.     GetFtpConnection("192.34.45.0");

68.         }

69.     catch(CInternetException *pEx)

70.         {

71.     pEx->Delete();

72.     pFtpConnection=NULL;

73.     *pnFileStatus=-1;

74.     goto BallOut;

75.         }

76.         *pnFileStatus =1;

77.     pFtpConnection->Remove("test.txt");

78.     if(!pFtpConnection->PutFile

79.     ("test.txt","test.txt"))

80.     *pnFileStatus=-2;

81.         else

82.     *pnFileStatus=2;

83.       BallOut:

84.     if(pFtpConnection!=NULL)

85.         {

86.     pFtpConnection->Close();

87.     delete pFtpConnection;

88.         }

89.         delete pInetSession;

90.         AfxEndThread(0);

91.         return false;

92.       }

93.     编辑ftpfwview.cpp中的OnDraw()函数

94.       void CFtpfwView::OnDraw(CDC* pDC)

95.       {

96.         CFtpfwDoc* pDoc = GetDocument();

97.         ASSERT_VALID(pDoc);

98.         if(!m_bConnectAttempted)

99.         {

100.     m_bConnectAttempted=TRUE;

101.     AfxBeginThread((AFX_THREADPROC)

102.     CFtpThread::PutFile,&m_nFileStatus);

103.         }

104.       }

105.     编译并且执行程序,在连接和传输的过程中,应用程序仍然可以作自己的工作,这是因为传输的过程发生在线程中。

总结语

---- 通过以上的程序我们可以明白FTP的工作原理,我们可以编制自己的获得FTP服务器的文件以及获得FTP服务器的根目录,亲自体验一下我们的程序工作的怎末样。

 

源文档 <http://life0.blog.51cto.com/87691/12410/>

 

原创粉丝点击