Smartphone 2002中使用Web Service<?xml:namespace prefix = o ns = "urn:schemas-microsoft-com:office:office" />
Chung Webster
Microsoft UK, Developer Services
January 2003
Applies to:
Microsoft Smartphone 2002 Software
Microsoft ASP.NET
Microsoft MapPoint .NET
摘要:学习如何创建一个连接提供地理信息的ASP.NET Web service的Smartphone客户端程序。注意示例代码只是用来示范如何使用,并不被保证和支持。
Download the Microsoft Software Development Kit for Smartphone 2002.
Download the Smartphone 2002 and Web Services source code.
Contents
Introduction
Web Services Basics
Smartphone Web Services
MapMobile & MapPoint .NET Web Service
The SmartMap Client
Summary
About the Author
Introduction
介绍
Orange SPV——第一种被正式推出的运行Smartphone 2002的移动电话——已经开始在市面上出售了,因此现在是开始开发Smartphone应用程序的时候了。在这篇文章中,我们将创建一个Smartphone客户端,用来连接一个提供地理信息的ASP.NET Web service。这篇文章假定读者具有Web services, ASP.NET 和 Win32编程的基础知识。
.NET framework有一套类库可以帮助我们连接(consume)Web services,从分析WSDL文档到自动创建一个代理类进行编程调用。这使得大部分Web services的编程调用显得很微不足道;然而Compact Framework是不能被Smartphone使用的,因此我们需要看一下其他的选择了。
COM可以使用Soap工具包,但同样不能用于Smartphone;但是,我们可以用它来帮助追踪我们的调用。
在没有这些技术的情况下,我们仍然可以编程调用一个Web Service,为此我们需要看一下Web Service的格式和传输。在.NET 1.0 Web services中使用两种信息标准,SOAP和WSDL.
Web Services基础
没有一个基于API的SOAP帮助我们连接Web services,我们不得不直接处理SOAP消息,它们的格式在WSDL文档中被指定。注意使用WSDL的一个好处是计划信息在类型元素中。
对于Smartphone来说,我们必须构造自己的SOAP消息,使他们能够被Web service正确接受。这些消息通过HTTP POST被发送到服务器,我们的客户端等待SOAP响应。这个过程包括分析、检查SOAP错误,并返回处理过的值。这看来需要付出巨大的努力。无论如何,在实际中这和SOAP工具包提供的底层API是十分相似的。
从纯粹的WSDL中手动构造一个SOAP消息是件复杂的任务,比如显示map.wsdl这需要查找正确的操作元素,寻找输入消息,并映射正确的类型。如果Web service使用ASP.NET,简单的方法是查看产生的asmx页,选择Webmethod,并查看SOAP请求的例子(见图1)。
<?xml:namespace prefix = v ns = "urn:schemas-microsoft-com:vml" /><shapetype id="_x0000_t75" stroked="f" filled="f" path="m@4@5l@4@11@9@11@9@5xe" o:preferrelative="t" o:spt="75" coordsize="21600,21600"><stroke joinstyle="miter"></stroke><formulas><f eqn="if lineDrawn pixelLineWidth 0"></f><f eqn="sum @0 1 0"></f><f eqn="sum 0 0 @1"></f><f eqn="prod @2 1 2"></f><f eqn="prod @3 21600 pixelWidth"></f><f eqn="prod @3 21600 pixelHeight"></f><f eqn="sum @0 0 1"></f><f eqn="prod @6 1 2"></f><f eqn="prod @7 21600 pixelWidth"></f><f eqn="sum @8 21600 0"></f><f eqn="prod @7 21600 pixelHeight"></f><f eqn="sum @10 21600 0"></f></formulas><path o:connecttype="rect" gradientshapeok="t" o:extrusionok="f"></path><lock aspectratio="t" v:ext="edit"></lock></shapetype><shape id="_x0000_i1025" style="WIDTH: 337.5pt; HEIGHT: 315pt" alt="" type="#_x0000_t75"><img o:href="http://msdn.microsoft.com/library/en-us/dnsmtphn/html/sphoneweb_fig1.gif" src="/Develop/ArticleImages/20/20289/CSDN_Dev_Image_2003-8-61602420.gif"><font face="宋体"></font></shape>
Figure 1. Web Service generated documentation from ASP.NET.
如果你不能这样访问,另一个办法是使用一个支持WSDL的客户端调用Web service,并分析SOAP包。SOAP工具包支持一种utility, Trace Utility (MsSoapT3.exe).这个工具也在调试Web service时经常使用。
<shape id="_x0000_i1026" style="WIDTH: 337.5pt; HEIGHT: 282.75pt" alt="" type="#_x0000_t75"><img o:href="http://msdn.microsoft.com/library/en-us/dnsmtphn/html/sphoneweb_fig2.gif" src="/Develop/ArticleImages/20/20289/CSDN_Dev_Image_2003-8-61602422.gif"><font face="宋体"></font></shape>
Figure 2. Trace Utility, from Soap Toolkit 3.0
Smartphone Web Services
在上面的请求中,我们可以看到,构造一个SOAP消息是很容易的。在这个例子中,我创建了一个类SoapWriter,提供底层函数用来写一个SOAP消息。
为了发送这个SOAP请求到Web service,我将使用WinInet API。一般来说,WinInet被用于HTTP和FTP通信。这是一个提供Internet访问、不需要WinSock编程的高级API。幸运的是,Web service使用SOAP调用是基于HTTP基础上的。
为了容易地发送我们的SOAP请求,我创建了一个SoapConnector类,允许我们post SOAP请求,并得到响应。一旦连接到Web service,客户端可以执行多重调用,并使用accessors来接受SOAP响应。
XML可以被客户端接收,然后下载到DOM分析器中,并返回处理后的值。在这个例子里,我创建了一个封装msxml 中IXMLDOMDocument接口的类;在这里需要的COM将被介绍。
一旦被加载,DOM可以通过m_pDom对象被访问,来选择节点值或者运行Xpath查询。
作为选择,一个帮助方法,SelectSingleTextNode提供解析出的文本节点。分派TCHAR长度以适合文字节点的值。
我们调用的Web service将返回文字节点中包含数据的SOAP消息,因此SelectSingleTextNode方法提供一个有用的机制从Web service调用中解析出数据。SoapReader类可以被扩展用来包括其他的帮助方法,如果你经常需要从不同的节点轴解析不同的数据、EG, 比如属性数据或者评估一个nodeset。
迄今为止,SoapWriter, SoapConnector, 和 SoapReader用来提供从Web service上构造、调用和阅读请求的功能函数。为了使用这些类实现一个客户端,我们需要理解SOAP消息的格式。下面,我们将看到如何创建一个Web service和创建一个Smartphone客户端。
MapMobile & MapPoint .NET Web Service
这个DEMO程序从一个Web service中接收地图信息,并显示到Smartphone中。地理信息查找和地图信息由MapPoint.NET提供——一个商业Web service。由于Smartphone的最终用户不一定有自己的MapPoint .NET帐号,我创建了一个封装Web service,MapMobile,用来调用和识别MapPoint .NET。对于Smartphone 2002,没有认证提供者,因此如果我想直接和MapPoint .NET对话,我不得不手工实现认证头。封装类的另外的原因是可以改变地理信息的提供者,而不会影响到最终用户,例如移植MapPoint NET 2.0 到 3.0。
因为已经有文章描述如何使用MapPoint .NET和其SDK,我不准备包括详细的细节。更多的信息,包括评估帐号的安装,请访问MapPoint .NET.查看service的WSDL,请访问http://staging.mappoint.net/standard-30/default.htm。
<shape id="_x0000_i1027" style="WIDTH: 337.5pt; HEIGHT: 118.5pt" alt="" type="#_x0000_t75"><img o:href="http://msdn.microsoft.com/library/en-us/dnsmtphn/html/sphoneweb_fig3.gif" src="/Develop/ArticleImages/20/20289/CSDN_Dev_Image_2003-8-61602424.gif"><font face="宋体"></font></shape>
Figure 3. MapMobile Architecture
我们的包装service提供两个简单的Web service method,使客户端可以定位并显示一幅地图。第一次调用返回地址的经纬度,第二次调用返回一个包含GIF图片的byte array。
为了防止无限调用MapMobile Web service,一个包含Smartphone电话号码的SOAP头被包括在所有调用中。在服务器端,该头将在对照有效号码列表进行检查。如果调用失败,一个SOAP错误将被返回到客户端。这个验证机制仅仅是个例子,很显然它不能禁止使用一个有效号码的欺骗调用。这里有许多依赖你的Web service安全选项可用,你可以不选择认证,使用数字签名,或者使用新的Global XML Web Services Architecture (GXA).
更多的关于未来调用安全Web service的信息,请访问Security in a Web Services World: A Proposed Architecture and Roadmap。
The SmartMap Client
该客户端程序提供一个输入屏幕,用于输入一个地址。然后它会调用MapMobile Web service并接收一幅地图保存到文件系统中。这可以让用户看到最后一幅下载的地图。
<shape id="_x0000_i1028" style="WIDTH: 267.75pt; HEIGHT: 334.5pt" alt="" type="#_x0000_t75"><img o:href="http://msdn.microsoft.com/library/en-us/dnsmtphn/html/sphoneweb_fig4all.gif" src="/Develop/ArticleImages/20/20289/CSDN_Dev_Image_2003-8-61602426.gif"><font face="宋体"></font></shape>
Figure 4. SmartMap User Interface
我们的客户端应用程序包括一个splash screen(我们的main window class)和三个对话框(输入屏幕,Web service调用状态和地图显示)。最初,splash window被显示,紧跟着是Find Location对话框。该设备的电话号码也被提取和保存,为了在SOAP头中使用。该调用在模拟器中不工作,因此,如果该调用失败,我们设置一个1234567890的号码作为测试号码。
当用户选择Search菜单选项,应用程序构造一个正确的SOAP调用给MapMobile Web service.这包括包含设备电话号码的SOAP头。
一旦这些完成后,SoapConnector可以被加载到SoapReader中,解析base64 encoded数据。
我们将始终检查我们的HRESULTs,如果SoapReader失败,然后检查响应是否包含SOAP错误。