开发SmartPhone应用程序以及调用WebService

Orange SPV是第一款进入市场的运行Smartphone 2002的移动电话，现在我们可以开始开发Smartphone应用程序了。本文我们建立了一个可以使用ASP.NET Web服务的Smartphone客户端来提供地理信息。本文假定读者有Web服务、ASP.NET和Win32编程的基本知识。

.NET框架组件使我们有了一组类帮助使用Web服务，从分析WSDL文档到自动建立代理类再到程序依赖。这使大多数依靠Web服务的编程比较琐碎，可是对于Smartphone来说简单框架组件（Compact Framework）还不能使用，因此我们需要作其它的选择。

典型的COM能够使用Soap工具包，对Smartphone来说它也不能使用，但是我们将使用它来帮助跟踪调用。

我们可以依靠Web服务编程仍然不使用这些技术，为了实现它，我们需要查看Web服务的格式和传送。在.NET 1.0 Web服务中使用两种标准来通讯：SOAP和WSDL。

Web服务基础

如果没有基于SOAP的API帮助使用Web服务，我们就需要直接处理SOAP消息和WSDL文档指定的格式。请注意使用WSDL使用的好处之一是类型元素中的概要信息。这些信息指定了SOAP正文的格式，启动WSDL察觉客户端（例如.NET）来定义SOAP包可以进行串并转换的类。

对于Smartphone来说，我们必须构造自己的SOAP消息以确保它们可以被Web服务接受。这些消息通过HTTP POST发送到服务器，我们的客户端等待SOAP响应。这需要按次序分析、检查soap错误，返回提取的值。看起来这需要大量的工作，但是在实际中它与Soap 工具包提供的低层API相近。

手动地从纯WSDL构造SOAP消息是复杂的事务（如map.wsdl显示）。这需要定位正确的操作元素，找到输入消息，映射正确类型。如果Web服务用的是ASP.NET，简单的途径是查看产生的asmx页，选择Webmethod，并查看SOAP请求示例（图1）。



图1 从ASP.NET产生的Web服务文档

如果你不能访问这些信息，有另一个机制用于支持WSDL的客户端调用Web服务，并跟踪SOAP包。SOAP工具包提供了一个工具Trace Utility（MsSoapT3.exe），它对调试Web服务很有用。



图2 Trace Utility,来自Soap工具包3.0

Smartphone Web服务

在上面的请求中很容易看出怎样构造SOAP消息。在这个例子中，我建立了一个SoapWriter类提供写SOAP消息的低层功能。

#include "Soap.h" SoapWriter *pSoap = new SoapWriter(); pSoap->StartEnvelope(); pSoap->StartBody(); pSoap->StartElement(L"GetLatLong", L"http://mapmobile"); pSoap->WriteElementString(L"addressLine", L"new bond street"); pSoap->WriteElementString(L"city", L"bath"); pSoap->StartElement(L"postCode"); pSoap->EndElement(L"postCode"); pSoap->WriteElementString(L"country", L"UK"); pSoap->EndElement(L"GetLatLong"); pSoap->EndBody(); pSoap->EndEnvelope(); pSoap->FinalizeSoap();

为了向Web服务发送SOAP请求，我将使用WinInet API。WinInet一般用于HTTP和FTP通讯。它为Internet访问提供了高层次API而没有采用WinSock 编程。幸运的是Web服务使用SOAP调用，在我们的例子中使用HTTP调用。

为了使发送SOAP请求更加容易，我建立了SoapConnector类，它允许我们发送SOAP请求和载入响应信息。一旦连接到了Web服务，客户端就可能作多个调用，使用存取程序检索SOAP响应信息。

#include "Soap.h" SoapWriter *pSoap = new SoapWriter(); //在此处建立SOAP 请求 SoapConnector *pCon = new SoapConnector(); pCon->Init(); //连接到服务器和Web服务 pCon->Connect(L"http://chungw02:8080/mapmobile/map.asmx"); //同SOAP 消息和SoapAction 一起调用 pCon->Invoke(pSoap, L"http://mapmobile/GetLatLong"); //提取响应信息 int iLen = 0; pCon->GetSoapLength(&iLen); TCHAR *pResponse = new TCHAR[iLen+1]; pCon->GetSoap(&pResponse);

客户端接收到的XML文件接着被载入DOM分析器并返回提取的值。本例中，我建立了一个将msxml中的IXMLDOMDocument接口暴露的包装类，这需要COM存在。

#include "Soap.h" //读取SOAP 响应信息 pSoapReader = new SoapReader(); pSoapReader->Init(); //通过传递SoapConnector或者Xml字符串载入SOAP响应信息 pSoapReader->LoadXml(pCon);

一旦它被载入了，可以通过m_pDom成员访问DOM，选择节点值或运行XPath查询。

MSXML::IXMLDOMNode *pNode = NULL; MSXML::IXMLDOMNodeList *pNodeList = NULL; MSXML::IXMLDOMNode *pTextNode = NULL; TCHAR *lpNodeValue = NULL; TCHAR *XPath = new TCHAR[50]; _tcscpy(XPath, L"/soap:Envelope/soap:Body/Node"); VARIANT vNodeVal; HRESULT hr; //使用前面建立的pSoapReader try { //选择节点 hr = pSoapReader ->m_pDom->selectSingleNode(XPath, &pNode); if (FAILED(hr)) __leave; if (pNode == NULL) __leave; //获取子节点 hr = pNode->get_childNodes(&pNodeList); if (FAILED(hr)) __leave; //获取下一个节点 hr = pNodeList->get_item(0, &pTextNode); if (FAILED(hr)) __leave; //获取文本节点值 VariantInit(&vNodeVal); hr = pTextNode->get_nodeValue(&vNodeVal); if (FAILED(hr)) { VariantClear(&vNodeVal); __leave; } //将值指定给lpNodeValue lpNodeValue = TCHAR[SysStringLen(vNodeVal.bstrVal) + 1]; _tcscpy(lpNodeValue, vNodeVal.bstrVal); VariantClear(&vNodeVal); //使用lpNodeValue处理事务 } __finally { if (pNode != NULL) pNode->Release(); if (pNodeList != NULL) pNodeList->Release(); if (pTextNode != NULL) pTextNode->Release(); if (lpNodeValue !=NULL) delete[] lpNodeValue; }

作为选择，我提供了一个辅助方法SelectSingleTextNode来提取文本节点。它分配了TCHAR大小空间来适应文本节点的值。

//注意这些有辅助方法SelectSingleTextNode分配 TCHAR *latitude = NULL; TCHAR *longitude = NULL; //使用前面建立的pSoapReader pSoapReader->SelectSingleTextNode(L"/soap:Envelope/soap:Body/GetLatLongResponse /latitude", &latitude); pSoapReader->SelectSingleTextNode(L"/soap:Envelope/soap:Body/GetLatLongResponse /longitude", &longitude); //使用返回值处理事务 //清除 if (latitude != NULL) delete[] latitude; if (longitude != NULL) delete[] longitude;

即将调用的Web服务返回包含文本节点数据的SOAP消息，因此SelectSingleTextNode方法提供了从Web服务调用中提取数据的一个有用的机制。如果你经常需要提取数据的不同方式，例如属性数据和评估节点集合，SoapReader类可以扩充包含其它的辅助方法。
到此为止SoapWriter、SoapConnector和SoapReader提供了构造、调用和从Web服务读取响应信息的功能。为了用这些类实现客户端，我们需要了解SOAP消息的格式。下面将看到建立Web服务和Smartphone客户端。

MapMobile和MapPoint .NET Web服务

例程包含一个能从Web服务检索地图信息并在Smartphone上的显示的客户端。地理搜索和地图数据由MapPoint .NET提供，它是一个商用Web服务。尽管Smartphone终端用户并没有MapPoint .NET帐号，我建立了一个叫MapMobile的包装Web服务来依靠MapPoint .NET进行调用和认证。对于Smartphone 2002来说没有摘要（digest）认证提供者，因此如果我要直接与MapPoint .NET对话，需要手工实现认证头（header）。包装的其它原因是包含了改变地理数据提供者的能力，而不需要影响终端用户，例如从MapPoint .NET 2.0升级到3.0。



图3. MapMobile结构

我们的包装服务暴露了两个简单的Web服务方法，使客户端能够定位和显示地图。第一个调用返回地址的经度和纬度，第二个调用返回包含匹配的GIF图象的字节数组。

[WebMethod] [SoapHeader("_phoneNumber", Direction=SoapHeaderDirection.In)] public void GetLatLong(string addressLine, string city, string postCode, string country, out double latitude, out double longitude) [WebMethod] [SoapHeader("_phoneNumber", Direction=SoapHeaderDirection.In)] public byte[] GetMap(double latitude, double longitude, double zoom, int width, int height, string tag)

为了防止MapMobile Web服务的无限制调用，所有的调用都包含一个SOAP头，它包含了Smartphone的电话号码。在服务器端，检测头信息是否为有效的数字。如果失败了，SOAP故障将返回客户端。这种认证机制只供例子使用，不禁止有效号码的欺骗。由于提供了很多安全选项，它们依靠你的Web服务，你可以选择不认证，使用数字署名，或使用新全局XML Web服务结构（Global XML Web Services Architecture，GXA）。

SmartMap客户端

客户端应用程序提供了一个输入屏幕用于输入地址。接着调用MapMobile Web服务并检索存储在文件系统中的地图。这使用户可以查看下载的最新地图。



图4. SmartMap用户界面

我们的客户端应用程序包含一个启动屏幕（主窗体类）和三个对话框（输入屏幕、Web服务调用状态和地图显示）。起初启动屏幕显示，跟着显示Find Location对话框。设备电话号码也被提取和保存，用于soap头中。在仿真程序中这些调用不会工作，因此在我们的例子中，如果调用失败就将数字设为1234567890以供测试。

TCHAR *g_PhoneNumber = new TCHAR[40]; SMS_ADDRESS pAddr; //获取电话号码 SmsGetPhoneNumber(&pAddr); _tcscpy(g_PhoneNumber, pAddr.ptsAddress);

当用户选择Search菜单选项，应用程序为MapMobile Web服务构造正确的SOAP调用。这包括包含设备电话号码的SOAP头。

SoapWriter *pSoap = new SoapWriter(); sw->StartEnvelope(); //构造头 sw->StartHeader(); sw->StartHeaderElement(L"MapMobileHeader", L"http://mapmobile"); sw->WriteHeaderElementString(L"PhoneNumber", g_PhoneNumber); sw->EndHeaderElement(L"MapMobileHeader"); sw->EndHeader(); //Soap正文 sw->StartBody(); //此处构造SOAP正文 sw->EndBody(); sw->EndEnvelope(); sw->FinalizeSoap();

这完成后SoapConnector将被载入SoapReader中用于提取64位编码数据。

TCHAR *map64; //分配内存到目标变量 hrSearch = pSoapReader->SelectSingleTextNode(L"/soap:Envelope/soap:Body/GetMapResponse/GetMap Result", &map64);

我们需要不断检查HRESULT，如果SoapReader失败了，就检查响应信息是否包含Soap故障。

TCHAR &soapfault; hrSearch = pSoapReader->SelectSingleTextNode(L"/soap:Envelope/soap:Body/soap:Fault /faultstring", &soapfault); if (SUCCEEDED(hrSearch)) MessageBox(hDlg, soapfault, L"Soap Error", MB_OK | MB_ICONWARNING); else MessageBox(hDlg, L"Call failed", L"Error", MB_OK | MB_ICONWARNING);

图5. Soap故障传回客户端

如果所有调用成功完成，64位字符串将解码成为一个字符数组并作为SmartMap.gif保存。我们希望该文件在电话关闭也保存在My Documents文件夹中。但是固化存储器的文件结构可以被OEM的改变，因此调用SHGetSpecialFolderPath API来检索这些信息。

CHAR szMapFile[MAX_PATH]; SHGetSpecialFolderPath(hwnd, szMapFile, CSIDL_PERSONAL , FALSE); _tcscat(szMapFile, L"//SmartMap.gif"); //在Orange SPV上 szMapFile包含在 /IPSM/My Document/SmartMap.gif //在模拟器上为: /My Document/SmartMap.gif

最后建立map对话框，它包含一个图象控件（IDC_IMAGE）。



图6.选择其它数据

当该对话框载入后，保存的地图图象将从文件系统中读入并且STM_SETIMAGE传递到对话框句柄。该图象使用IMGDECMP.dll图象库载入，它时CE 3.0平台的一部分。

HBITMAP g_hbm = NULL; ReadPictureFile(hDlg, szMapFile, & g_hbm); SendDlgItemMessage(hDlg, IDC_IMAGE, STM_SETIMAGE, IMAGE_BITMAP, (LPARAM) g_hbm);

图7.选择其它数据

这时SmartMap客户端几乎已经完成。如果可能的话，用户需要能查看最新地图。为了实现功能，使用了一个弹出菜单，在Find Location对话框的Option按钮中。如果文件存在就会捕获一个WM_INITMENUPOPUP消息，由此弹出菜单被激活或者禁止。

//菜单弹出前调用 case WM_INITMENUPOPUP: { //查看是否文件存在和是否激活最新地图菜单 DWORD dwFile = GetFileAttributes(szMapFile); BOOL bEnabled = (dwFile == 0xFFFFFFFF ? FALSE : TRUE); EnableMenuItem((HMENU)wParam, ID_EXIT_LASTMAP, MF_BYCOMMAND | (bEnabled?MF_ENABLED:MF_GRAYED)); break; }

如果用户可以选择该菜单，接着map对话框将再次被建立，它从文件系统自动载入图象。

总结

我曾经查阅过Web服务、工具和技术所包含的内容来帮助查看SOAP包。使用提供的例程，我们看到了在Smartphone 2002上，在例子MapPoint .NET中使用Web服务的一条途径。通过建立Web服务察觉（service-aware）客户端，我们获得了工作于混合连接环境，连接和断开连接，合计和储存数据的移动设备上的新一代应用程序的好处，并提供了新的经验。