CSDN博客

img aawolf

Smartphone 2002中使用Web Service

发表于2003/8/8 8:40:00  2609人阅读

Smartphone 2002中使用Web Service

Chung Webster

Microsoft UK, Developer Services

January 2003

Applies to:
     Microsoft Smartphone 2002 Software
     Microsoft ASP.NET
     Microsoft MapPoint .NET

摘要:学习如何创建一个连接提供地理信息的ASP.NET Web serviceSmartphone客户端程序。注意示例代码只是用来示范如何使用,并不被保证和支持。

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有一套类库可以帮助我们连接(consumeWeb services,从分析WSDL文档到自动创建一个代理类进行编程调用。这使得大部分Web services的编程调用显得很微不足道;然而Compact Framework是不能被Smartphone使用的,因此我们需要看一下其他的选择了。

COM可以使用Soap工具包,但同样不能用于Smartphone;但是,我们可以用它来帮助追踪我们的调用。

在没有这些技术的情况下,我们仍然可以编程调用一个Web Service,为此我们需要看一下Web Service的格式和传输。在.NET 1.0 Web services中使用两种信息标准,SOAPWSDL.

Web Services基础

没有一个基于APISOAP帮助我们连接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)。

Figure 1. Web Service generated documentation from ASP.NET.

如果你不能这样访问,另一个办法是使用一个支持WSDL的客户端调用Web service,并分析SOAP包。SOAP工具包支持一种utility, Trace Utility (MsSoapT3.exe).这个工具也在调试Web service时经常使用。

Figure 2. Trace Utility, from Soap Toolkit 3.0

Smartphone Web Services

在上面的请求中,我们可以看到,构造一个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();

为了发送这个SOAP请求到Web service,我将使用WinInet API。一般来说,WinInet被用于HTTPFTP通信。这是一个提供Internet访问、不需要WinSock编程的高级API。幸运的是,Web service使用SOAP调用是基于HTTP基础上的。

为了容易地发送我们的SOAP请求,我创建了一个SoapConnector类,允许我们post SOAP请求,并得到响应。一旦连接到Web service,客户端可以执行多重调用,并使用accessors来接受SOAP响应。

#include "Soap.h"
 
SoapWriter *pSoap = new SoapWriter();
//Create the SOAP request here
 
SoapConnector *pCon = new SoapConnector();
pCon->Init();
 
//Connect to the server and Web service
pCon->Connect(L"http://chungw02:8080/mapmobile/map.asmx");
 
//Invoke with the Soap Message and SoapAction
pCon->Invoke(pSoap, L"http://mapmobile/GetLatLong");
 
//Extract out the response
int iLen = 0;
pCon->GetSoapLength(&iLen);
TCHAR *pResponse = new TCHAR[iLen+1];
 
pCon->GetSoap(&pResponse);

XML可以被客户端接收,然后下载到DOM分析器中,并返回处理后的值。在这个例子里,我创建了一个封装msxml IXMLDOMDocument接口的类;在这里需要的COM将被介绍。

#include "Soap.h"
 
//Read SOAP Response
pSoapReader = new SoapReader();
pSoapReader->Init();
 
//Load the SOAP response by passing in a SoapConnector or Xml string
pSoapReader->LoadXml(pCon);

一旦被加载,DOM可以通过m_pDom对象被访问,来选择节点值或者运行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;
 
//using previous created pSoapReader
 
try {
   //Select node
   hr = pSoapReader ->m_pDom->selectSingleNode(XPath, &pNode);
 
   if (FAILED(hr))
      __leave;
 
   if (pNode == NULL)
      __leave;
 
   //Get child node
   hr = pNode->get_childNodes(&pNodeList);
   if (FAILED(hr))
      __leave;
 
   //Get text node
   hr = pNodeList->get_item(0, &pTextNode);
   if (FAILED(hr))
      __leave;
 
   //Get value of text node
   VariantInit(&vNodeVal);
 
   hr = pTextNode->get_nodeValue(&vNodeVal);
   if (FAILED(hr)) {
      VariantClear(&vNodeVal);
      __leave;
   }
 
//Assign the value to lpNodeValue
   lpNodeValue = TCHAR[SysStringLen(vNodeVal.bstrVal) + 1];
   _tcscpy(lpNodeValue, vNodeVal.bstrVal);
 
   VariantClear(&vNodeVal);
 
   //Do something with lpNodeValue
}
 
__finally {
   if (pNode != NULL)
      pNode->Release();
   if (pNodeList != NULL)
      pNodeList->Release();
   if (pTextNode != NULL)
      pTextNode->Release();
 
   if (lpNodeValue !=NULL)
      delete[] lpNodeValue;   
}

作为选择,一个帮助方法,SelectSingleTextNode提供解析出的文本节点。分派TCHAR长度以适合文字节点的值。

//Note these are allocated by the helper method SelectSingleTextNode
TCHAR *latitude = NULL;
TCHAR *longitude = NULL;
 
//using previous created pSoapReader
pSoapReader->SelectSingleTextNode(L"/soap:Envelope/soap:Body/GetLatLongResponse/latitude", &latitude);
pSoapReader->SelectSingleTextNode(L"/soap:Envelope/soap:Body/GetLatLongResponse/longitude", &longitude);
 
//Do something with return values
//
 
//Cleanup
if (latitude != NULL)
delete[] latitude;
if (longitude != NULL)
delete[] longitude;

我们调用的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 serviceMapMobile,用来调用和识别MapPoint .NET。对于Smartphone 2002,没有认证提供者,因此如果我想直接和MapPoint .NET对话,我不得不手工实现认证头。封装类的另外的原因是可以改变地理信息的提供者,而不会影响到最终用户,例如移植MapPoint NET 2.0 3.0

因为已经有文章描述如何使用MapPoint .NET和其SDK,我不准备包括详细的细节。更多的信息,包括评估帐号的安装,请访问MapPoint .NET.查看serviceWSDL,请访问http://staging.mappoint.net/standard-30/default.htm

Figure 3. MapMobile Architecture

我们的包装service提供两个简单的Web service method,使客户端可以定位并显示一幅地图。第一次调用返回地址的经纬度,第二次调用返回一个包含GIF图片的byte array

[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 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并接收一幅地图保存到文件系统中。这可以让用户看到最后一幅下载的地图。

Figure 4. SmartMap User Interface

我们的客户端应用程序包括一个splash screen(我们的main window class)和三个对话框(输入屏幕,Web service调用状态和地图显示)。最初,splash window被显示,紧跟着是Find Location对话框。该设备的电话号码也被提取和保存,为了在SOAP头中使用。该调用在模拟器中不工作,因此,如果该调用失败,我们设置一个1234567890的号码作为测试号码。

TCHAR *g_PhoneNumber = new TCHAR[40];
SMS_ADDRESS pAddr;
 
//Get the phone number
SmsGetPhoneNumber(&pAddr);
 
_tcscpy(g_PhoneNumber, pAddr.ptsAddress);

当用户选择Search菜单选项,应用程序构造一个正确的SOAP调用给MapMobile Web service.这包括包含设备电话号码的SOAP头。

SoapWriter *pSoap = new SoapWriter();
sw->StartEnvelope();
 
//Construct the header
sw->StartHeader();
sw->StartHeaderElement(L"MapMobileHeader", L"http://mapmobile");
sw->WriteHeaderElementString(L"PhoneNumber", g_PhoneNumber);
sw->EndHeaderElement(L"MapMobileHeader");
sw->EndHeader();
 
//Soap Body
sw->StartBody();
//Construct the SOAP body here..
sw->EndBody();
 
sw->EndEnvelope(); 
sw->FinalizeSoap();

一旦这些完成后,SoapConnector可以被加载到SoapReader中,解析base64 encoded数据。

TCHAR *map64;
//This allocates memory into the target variable
hrSearch = pSoapReader->SelectSingleTextNode(L"/soap:Envelope/soap:Body/GetMapResponse/GetMapResult", &map64);

我们将始终检查我们的HRESULTs,如果SoapReader失败,然后检查响应是否包含SOAP错误。

0 0

相关博文

我的热门文章

img
取 消
img