zl程序教程

您现在的位置是:首页 >  其他

当前栏目

WinHTTP教程

教程 WinHTTP
2023-06-13 09:12:31 时间

大家好,又见面了,我是你们的朋友全栈君。

最近有些忙,也没更新BLOG,这几天在捣鼓一个小玩意要用到WinHTTP API,发现资料很少,而且大都是些MFC封装的例子,看得我是一个头几个大。就把自己关于WinHTTP的学习总结了一下,仅供参考,各人理解可能有区别。另外非常感谢前人在网络上提供的相关参考。

BTW:Google Chrome就是基于WinHTTP写的,如果想深入学习,可以阅读分析Chrome Code. 从此处获取Chrome的源代码等相关信息 SVN: http://src.chromium.org/svn/trunk/src/chrome/ VIEW: http://src.chromium.org/viewvc/

WinHTTP APIs是一组用来进行HTTP操作的函数,相比WinINet更加安全和健壮一些。

WinHTTP API List:

WinHttpAddRequestHeaders WinHttpCheckPlatform WinHttpCloseHandle WinHttpConnect WinHttpCrackUrl WinHttpCreateUrl WinHttpDetectAutoProxyConfigUrl WinHttpGetDefaultProxyConfiguration WinHttpGetIEProxyConfigForCurrentUser WinHttpGetProxyForUrl WinHttpOpen WinHttpOpenRequest WinHttpQueryAuthSchemes WinHttpQueryDataAvailable WinHttpQueryHeaders WinHttpQueryOption WinHttpReadData WinHttpReceiveResponse WinHttpSendRequest WinHttpSetCredentials WinHttpSetDefaultProxyConfiguration WinHttpSetOption WinHttpSetStatusCallback WinHttpSetTimeouts WinHttpTimeFromSystemTime WinHttpTimeToSystemTime WinHttpWriteData

WinHTTP API逻辑上分成三个独立的对象进行建模:会话对象、连接对象、请求对象。大致为:

初始化WinHTTP(获得会话对象,)–>创建连接(连接1,连接2,…N)–>发送请求(请求1,请求2,….N)

会话对象、连接对象、请求对象都由HINTERNET句柄表示,句柄的使用传递过程大致为:

WinHttpOpen–>return Session handle | WinHttpConnect–>return Connection handle | WinHttpOpenRequest–>return Request handle

各对象句柄可以使用WinHttpCloseHandle进行关闭。为了进一步加深了解WinHTTP APIs的调用过程和关系,我们来看下面的图:

(图来自MSDN)

会话对象 会话对象使用WinHttpOpen函数来进行创建。函数原形如下:

HINTERNET WinHttpOpen( __in LPCWSTR pwszUserAgent, __in DWORD dwAccessType, __in LPCWSTR pwszProxyName, __in LPCWSTR pwszProxyBypass __in DWORD dwFlags );

第一个参数指向一个应用程序自身名称及版本的字符串,使用在HTTP协议的User Agent中。如:Mozilla/4.0 第二个参数是WinHttp的访问类型要求。可能为下列值 WINHTTP_ACCESS_TYPE_NO_PROXY //不使用默认代理服务器 WINHTTP_ACCESS_TYPE_DEFAULT_PROXY //使用默认的代理服务器(储存在注册表中的WINHTTP代理设置,注意:与IE的代理设置不同,为独立的) WINHTTP_ACCESS_TYPE_NAMED_PROXY //使用指定的代理服务器设置 第三个参数指向一个代理服务器名称的字符串,如果前一个参数dwAccessType未设置为WINHTTP_ACCESS_TYPE_NAMED,这个参数就必须为WINHTTP_NO_PROXY_NMAE。 第四个参数指向一个HTTP服务器列表,其中的服务器不能通过前一个参数指定的代理服务器进行路由(这与IE代理服务器设置中的例外情况设置类似) 第五个参数定义了一个标记,当前只定义了一个标记 WINHTTP_FLAG_ASYNC //指示WinHTTP API将异步执行。

连接对象 连接对象使用WinHttpConnect函数来进行创建(注意前面提到的一个会话对象可以创建多个连接对象)。函数原形如下:

HINTERNET WinHttpConnect( __in HINTERNET hSession, __in LPCWSTR pswzServerName, __in INTERNET_PORT nServerPort __in reserved DWORD dwReserved );

第一个参数指定连接的所属会话句柄。 第二个参数指定连接的服务器名称或IP地址 第三个参数指定服务器的端口号,这个参数还可以指定为下列值 INTERNET_DEFAULT_HTTP_PORT //使用默认HTTP Service端口号80 INTERNET_DEFAULT_HTTPS_PORT //使用默认HTTPS安全连接端口号443 INTERNET_DEFAULT_PORT //常规HTTP请求使用80,HTTPS请求使用443(这是个便利的参数值) 第四个参数是保留的,必须为0

请求对象 请求对象使用WinHttpOpenRequest函数来进行创建(注意前面提到的一个连接对象可以创建多个请求对象)。从请求对象开始,就进入原本目的HTTP操作了。函数原形如下:

HINTERNET WinHttpOpenRequest( __in HINTERNET hConnect, __in LPCWSTR pwszVerb, __in LPCWSTR pwszObjectName, __in LPCWSTR pwszVersion, __in LPCWSTR pwszReferrer, __in LPCWSTR *ppwszAcceptTypes, __in DWORD dwFlags )

第一个参数指定请求所属的连接句柄 第二个参数指定HTTP协议动作(如:GET、POST和HEAD),如果此参数为NULL,函数会默认使用GET。 第三个参数指定正在请求的资源名称和相对路径 第四个参数指定使用的HTTP协议版本,如果此参数为NULL,函数会默认使用HTTP/1.1 第五个参数指定引用的URL,如果没有,可以设置为WINHTTP_NO_REFERER 第六个参数指定客户端(本应用程序)将接受的媒体类型(如:image/gif、text/*、*/*),一般可以指定为WIN_HTTP_DEFAULT_ACCEPT_TYPES。 第七个参数指定请求行为标记,如可以指定为WINHTTP_FLAG_SECURE标记发出HTTPS请求,一般可以为0。其他可指定值请参考MSDN,我就不罗列了。

至此介绍了三个WinHTTP API,经过这个过程就基本建立了一个HTTP网络连接。由此我们已经对WInHTTP有了基本概念性的认识。WinHTTP APIs(2)中将再介绍利用WinHTTP API进行更为复杂的操作和实际的应用例子

发布者:全栈程序员栈长,转载请注明出处:https://javaforall.cn/157465.html原文链接:https://javaforall.cn