《MFC那点事儿》---WinInet基础

WinInet全称是Win32 Internet Extension，它提供一个通用的网络协议访问接口，包括Gohper、FTP和HTTP。

使用WinInet开发网络应用程序的优点：

1）隐藏协议细节，简化编程：可不必深入了解协议。像使用WinSocket编程需要理解网络通信及协议基本原理；

2）熟悉编程接口：WinInet API函数和很多WinAPI函数相似；

3）稳定性好，不要求程序与底层直接联系：WinInet隐藏了协议的具体细节，使得程序不必直接使用各种协议；

4）支持数据缓存：WinInet函数为所有的协议提供缓存能力，程序员只需关心数据而不用去管理数据缓存；

5）支持多线程：由于WinInet函数在内部处理多线程的并发问题，因此WinInet函数支持多线程，在多线程中可以调用各种WinInet函数而不用担心发生问题或死锁。

 

WinInet类是一个总称，目前的版本中分为四组：

1）CInternetSession类：

直接继承自CObject类，用来建立与某个Internet服务器的会话。还可以向代理服务器描述连接，如果应用程序所使用的Internet连接必须保持一段时间，则可以在CWinApp类中创建相应的CInternetSession成员。CInternetSession类的成员函数如下：

QueryOption                   //提供一个可能的错误检测判断

SetOption       //设置Internet会话的选项

OpenURL       //设置URL，并对其进行分析

GetFtpConnection         //打开一个FTP会话并进行连接

GetHttpConnection      //打开HTTP服务器并进行连接

GetGopherConnection          //打开Gopher服务器并进行连接

EnableStatusCallback    //建立异步操作的状态回调

ServiceTypeFromHandle      //通过Internet句柄返回服务器类型

GetContext    //获取Internet和应用程序会话句柄

Close        //关闭Internet连接

 

2）CInternetConnection类：

包括CInternetConnection类及其派生类：

CInternetConnection  //管理与Internet服务器的连接

CHttpConnection   //管理与HTTP服务器的连接

CFtpConnection   //管理与FTP服务器的连接，可以对服务器上的文件和目录进行直接操作

CGopherConnection   //管理与Gopher服务器的连接

 

3）CFileFind类：

包括CFileFind类及其派生类CFtpFileFind、CGopherFileFind类。CFileFind类直接继承于CObject类，这些类实现对本地和远程系统上的文件的搜索和定位工作：

CFileFind         //对文件检索提供支持

CFtpFileFind  //为在FTP服务器上进行的文件检索操作提供支持

CGopherFileFind   //为在Gopher服务器上进行的文件检索操作提供支持

 

4）CInternetFile类和CGopherLocator类：

CInternetFile类包括CInternetFile类及其派生类CHttpFile、CGopherFile，这些类实现对远程系统上的文件的存取操作。

CInternetFile           //允许对使用Internet协议的远程系统中的文件进行操作

CGopherFile            //为在Gopher服务器上进行文件检索和读取操作提供支持

CHttpFile                 //提供对HTTP服务器上的文件进行操作的支持

在从Gopher服务器中获取信息之前，必须先获得该服务器的定位器，CGopherLocator类的主要功能就是从Gopher服务器中得到定位并确定定位器的类型。

 

WinInet有以下三个全局函数：

1）AfxParseURL：

AfxParseURL全局函数用于解析一个URL字符串，并返回服务类型：

BOOL AFXAPI AfxParseURL(

   LPCTSTR pstrURL,  //指向要解析的URL字符串的指针

   DWORD& dwServiceType, //指定Internet的服务类型，如AFX_INET_SERVICE_FTP

                            //AFX_INET_SERVICE_HTTP、AFX_INET_SERVICE_HTTPS…

   CString& strServer, //解析出来的主机字符串

   CString& strObject, //解析出来的URL内容字符串

   INTERNET_PORT& nPort //端口号(由Server或Object段指定的)

);

如果一个URL解析成功则返回非0值；如果为空URL或者不包含已知的服务类型则返回0值。

 

例如用AfxParseURL解析URL：service://server/dir/dir/object.ext:port，执行成功后得到的值：

strServer == “server”

strObject         ==“/dir/dir/object.ext”

nPort                 == #port

dwServiceType == #service

 

2）AfxGetInternetHandleType：

AfxGetInternetHandleType函数用于获取指定的Internet句柄的网络服务类型，这些返回网络服务类型在AFXINET.H中定义：

DWORD AFXAPI AfxGetInternetHandleType(

 HINTERNET hQuery  //Internet查询的句柄

);

如果Handle为空或服务类型无法识别，则返回AFX_INET_SERVICE_UNK。

成功则返回相应的服务类型，如INTERNET_HANDLE_TYPE_INTERNET、INTERNET_HANDLE_TYPE_CONNECT_HTTP…

 

3）AfxThrowInternetException：

AfxThrowInternetException函数用于抛出一个Internet异常：

void AFXAPI AfxThrowInternetException(

   DWORD dwContext, //引起异常的操作的上下文标识

   DWORD dwError = 0  //引起异常的错误

);

 

编写支持Internet的应用程序的一般步骤：

1）创建一个CInternetSession对象

由于Internet会话是通过CInternetConnection类的对象实现的，因此首先要创建一个CInternetSession对象，建立一个Internet会话；

2）建立与服务器的连接

客户应用程序要与服务器协同工作，在创建了CInternetSession对象后，就需要建立到服务器的连接，根据协议的不同，可选：GetFtpConnetction、GetHttpConnection、GetGopherConnection。

3）查询或设置Internet选项

在连接时，有时还要查询或设置Internet选项，这个工作可以通过QueryOption或SetOption函数来完成。

4）向用户反馈当前数据处理的进程信息

有时客户的应用程序在进行某些操作时，要耗费较长时间，因此需要向用户反馈当前的状态，这个工作由EnableStatusCallback函数来完成，此时还要重载OnStatusCallBack函数来实现回调函数的功能。

5）创建CInternetFile实例

调用CInternetSession类的成员函数OpenURL来建立与服务器的连接，函数返回一个CInternetFile指针。

6）文件读写操作

调用CInternetFile::Read或CInternetFile::Write函数对所得到的服务器文件进行读写操作。

7）异常处理

为提高应用程序的可靠性和容错性，必须对可能出现的问题进行处理，这种处理通常是调用CInternetException类的对象对目前可知的异常进行处理。

8）结束

调用CInternetSession::Close结束会话并销毁CInternetSession对象。