Smartphone 2002中使用Web Service

类别:VC语言 点击:0 评论:0 推荐:
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 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)。

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被用于HTTP和FTP通信。这是一个提供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 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。

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错误。

本文地址:http://com.8s8s.com/it/it1524.htm