在VC中调用 WebService
一、什么是 WebService ?
WebService 其实就是一个基于网络的应用程序,它向外部程序提供一定的调用接口。外部(远程)的程序,可以经由Web对其进行调用。
二、 WebService 的特性:
1.由于 WebService 经由web服务器发布,所以比DCOM而言,可以顺利穿过防火墙。这也是 WebService 的优点之一,可以说, WebService ,为分布 式应用的开发,提供了一个很好的平台。
2.对 WebService 的调用,是通过SOAP协议进行的。简单对象访问协议(SOAP)提供了标准的远程过程调用(RPC)方法来调用Web service。 而SOAP也是基于XML和XSD的,XML是SOAP的数据编码方式,因此,对 WebService 的调用也可以是跨平台的。、
三、怎样调用 WebService ?
Visual Studio.NET 内建提供了对 WebService 的调用。在VC.NET中,调用 WebService 只需要简单的几个步骤即可。只要找到 WebService 的发布 地址,将地址引入到VC工程中。这时,编译器会预先编译一次,自动生成和 WebService 相关的头文件(也可以叫Web代理文件) WebService .h。 在你的程序中,包含 WebService .h然后生成相关的对象,就可以对远程的 WebService 进行调用了。
为演示怎样调用 WebService ,我们用网上一个已经发布的 WebService ,名字叫TranslateService,其功能是对多种语言进行互相翻译。 这个 WebService 的地址如下: http://www.WebServicex.net/TranslateService.asmx
四、程序示例
1.基于控制台的托管程序示例
下面,我们先介绍VC.net中,基于控制台的托管程序,调用 WebService 的例子:
启动Visual Studio.NET 2003,新建一个Visual C++项目,类型选择为基于.NET的托管控制台应用。然后,引入 WebService 到工程,在解决方案 的项目名称上,单击右键,选择“添加Web引用”。如下图(图1):
图1 添加 WebService 引用到工程中
填入 WebService 的地址,然后点击”转到”按钮。 WebService 的相关细节,会被显示在下面。Web引用名,可以采用默认的名字,也可以自己设置 一个,在这里,我们起名叫TService。然后点击“添加引用”(图2),编译器自动生成TService.h以及 WebService .h。在 WebService .h里面已经包含了 TService.h。在工程的代码中,我们直接包含头文件 WebService .h即可。
图2 添加 WebService
TService.h是由编译器自动生成的,打开文件,我们可以看到,在命名空间TService中,编译器为我们自动封装了一个叫TranslateService的托管 类,以及一个名字叫Language的枚举类型。
Language类型在这个 WebService 中,用来描述翻译语言的类型,比如:
EnglishTOChinese(英语到中文)
ChineseTOEnglish(中文到英语)
EnglishTOGerman (英语到德语)
EnglishTOFrench (英语到法语)
等等……
在测试程序中,我们选择英语到中文的形式。
#include "stdafx.h" #include " WebService .h" //包含 WebService .h头文件到程序中 #using程序结果如下:(图3)using namespace System; using namespace TService; //使用TService的命名空间 int _tmain() { String *str=new String(S"Hello,world!"); String *strResult; TranslateService *pService=new TranslateService; //建立远程 WebService 对象 Language Lan=Language::EnglishTOChinese; //设置翻译类型 strResult=pService->Translate(Lan,str); //调用 WebService Console::WriteLine(str); Console::WriteLine(strResult); //输出结果 return 0; }
2.基于MFC的程序示例
在MFC程序中,一样可以调用 WebService ,我们可以建立一个简单的基于对话框的MFC程序,工程名字为TranslateMFC。由于需要使用托管类型,所以 在编译器设置里面,需要打开/clr开关。(图4)选择项目—TranslateMFC属性,打开项目的属性页,在常规,下面的使用托管扩展选项,将其选择为“是”。 这样,我们的项目就支持托管了C++扩展了。
图4 在工程属性打开clr开关
和上一个例子的方法一样,引用 WebService 到工程,创建 WebService 对象,然后调用 WebService 。不过在MFC中,我们如果直接用new来创建 WebService 对象的时候,编译器会报错(如下图)这是为什么呢?
图5 编译产生的C3828错误
为了跟踪内存的使用情况,在 MFC 调试版本中使用时 MFC 重定义 new 运算符。由于此重定义的缘故,会在 MFC 应用程序中创建托管类的实例,从而导致错误。在将现有 MFC 代码移植到公共语言运行库时通常会发生这种情况。对于发布版本不会发生该错误,这是因为 MFC 不重定义 new 运算符。在以下示例中,放置在 .cpp 文件中的托管代码创建 String 类的一个实例。这将导致在 MFC 应用程序调试版本中进行编译时发生C3828编译器错误。若要避免该错误,可在创建托管类型实例前,使用#undef 和 push_macro指令暂时取消定义 new 运算符。在最后一行托管代码的后面,使用pop_macro 还原先前的 new 运算符定义。示例代码如下:(图6)
由于此 WebService 支持30多中语言类型的转换,在这里,为示例简单,我只保留了几门语言的转换功能。其他的语言,只需要判断的时候,加入不同 Language枚举类型即可。
下面是程序运行的结果演示:
图7 MFC程序运行界面
图7 英文翻译为中文
图8 英文翻译为日文
图9 英文翻译为法文
五、结束语
通过以上的例子,我们看到了 WebService 为构建分布式应用,提供了强大的功能支持。
更多的有关 WebService 的问题,请访问http://www.microsoft.com/china/MSDN/library/WebServices获取更多的信息
补充:该程序的运行,需要.NET FrameWork的支持。