Android开发之WebService介绍

  经常有网友问：“在Android平台如何调用WebService”？经过沟通我发现，甚至有些朋友连什么是WebSerivce都不知道就在问怎么使用，更别说和WebService有关的SOAP、WSDL这类“火星”名词了。所以，我就想在讲解Android平台如何调用WebSerivce之前，先来介绍下WebService，看看它到底有多神秘。
      记得我的硕士论文题目中就包含“Web Service”这个词，当时还是花了大量时间去研究Web Service在系统集成、企业应用整合方面的应用；在工作中，接触的几个项目全都用到了Web Service；现在在工作之余抽点时间学习Android，又是Web Service。看来Web Service真是无处不在，有编程语言的地方，总能找到它的身影（提示：如果你以前没接触过WebService，这里需要知道WebService并不是Android的专利，10几年前就已经出现了）。

      根据W3C的定义，Web Services(Web服务)是一个用于支持网络间不同机器互操作的软件系统，它是一种自包含、自描述和模块化的应用程序，它可以在网络中被描述、发布和调用，可以将它看作是基于网络的、分布式的模块化组件。
      Web Services是建立在通用协议的基础之上，如HTTP、SOAP、UDDI、WSDL等，这些协议在操作系统、编程语言和对象模型的选择上没有任何倾向，因此有着很强的生命力。
      Web Services的优势在于提供了不同应用程序平台之间的互操作，它使得基于组件的开发和Web相结合的效果达到最佳。它是基于HTTP协议的，调用请求和回应消息都可以穿过防火墙，不需要更改防火墙的设置，这样就避免了使用特殊端口进行通信时无法穿越防火墙的问题。

      简单的理解：通常我们所说的WebService都是远程的某个服务器对外公开了某种服务，或者理解为对外公开了某个功能或者方法，而我们可以通过编程来调用该服务以获得我们需要的信息。例如：www.webxml.com.cn对外公开了手机号码归属地查询服务，我们只需要在调用该服务时传入一个手机号段（号码），就能立即获取该号段的归属地信息。
      更通俗的理解：通过使用WebService，我们能够像调用本地方法一样去调用远程服务器上的方法。我们并不需要关心远程的那个方法是Java写的，还是PHP或C#写的；我们并不需要关心远程的方法是基于Unix平台，还是Windows平台，也就是说WebService与平台和语言无关。

      说到WebSerivce，就必须要知道SOAP和WSDL，它们到底和WebSerice有着怎么的关系？上面已经提到，Web Services是建立在HTTP、SOAP、WSDL等通用协议的基础之上。
      SOAP(Simple Object Access Protocol，简单对象访问协议)是一种轻量级的、简单的、基于XML的协议，被设计用于在分布式环境中交换格式化和固化信息的简单协议。也就是说，要进行通信，进行数据访问传输，就必须依赖于一定的协议，而SOAP正是WebService通信中所依赖的一种协议。目前经常使用的SOAP协议有两个版本：SOAP 1.1 和 SOAP 1.2。
      WSDL(Web Services Description Language，即Web服务描述语言)是一种用来描述Web服务的XML语言，它描述了Web服务的功能、接口、参数、返回值等，便于用户绑定和调用服务。它以一种和具体语言无关的方式定义了给定Web服务调用和应答的相关操作和消息。
      WSDL是我们能够实实在在看到的东西，它是一份xml文档，用于描述某个WebSerivce的方方面面。例如，上面曾提到www.webxml.com.cn网站提供了手机号码归属地查询的WebSerivce，我们怎么来使用这个WebSerivce呢？它是基于哪个版本的SOAP协议？调用它需要传入什么参数？它会返回什么值？是一个字符串还是xml文档？这一系列的问题都能在WSDL中找到答案。上面这个服务的WSDL地址是：http://webservice.webxml.com.cn/WebServices/MobileCodeWS.asmx?wsdl，在浏览器上访问它，你将会看到如下所示的xml文档：
      

<?xml version="1.0" encoding="utf-8" ?>
<wsdl:definitions xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
    xmlns:tm="http://microsoft.com/wsdl/mime/textMatching/"
    xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
    xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/"
    xmlns:tns="http://WebXml.com.cn/"
    xmlns:s="http://www.w3.org/2001/XMLSchema"
    xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/"
    xmlns:http="http://schemas.xmlsoap.org/wsdl/http/"
    targetNamespace="http://WebXml.com.cn/"
    xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
    <wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
        <a href="http://www.webxml.com.cn/" mce_href="http://www.webxml.com.cn/" target="_blank">WebXml.com.cn</a>
        <strong>国内手机号码归属地查询WEB服务</strong>，提供最新的国内手机号码段归属地数据，每月更新。<br />
        使用本站 WEB 服务请注明或链接本站：<a href="http://www.webxml.com.cn/" mce_href="http://www.webxml.com.cn/" target="_blank">http://www.webxml.com.cn/
        </a>感谢大家的支持！<br />
    </wsdl:documentation>
    <wsdl:types>
        <s:schema elementFormDefault="qualified" targetNamespace="http://WebXml.com.cn/">
            <s:element name="getMobileCodeInfo">
                <s:complexType>
                    <s:sequence>
                        <s:element minOccurs="0" maxOccurs="1" name="mobileCode" type="s:string" />
                        <s:element minOccurs="0" maxOccurs="1" name="userID" type="s:string" />
                    </s:sequence>
                </s:complexType>
            </s:element>
            <s:element name="getMobileCodeInfoResponse">
                <s:complexType>
                    <s:sequence>
                        <s:element minOccurs="0" maxOccurs="1" name="getMobileCodeInfoResult" type="s:string" />
                    </s:sequence>
                </s:complexType>
            </s:element>
            ... ...
        </s:schema>
    </wsdl:types>
    ... ...
</wsdl:definitions>

  
      看到WSDL后，我们能从中得到哪些信息呢？
           1）从第08行可以看出，该WebSerivce所基于的SOAP协议版本是SOAP1.2；
           2）从第10行可以看出，该WebSerivce的命名空间(NameSpace)是http://WebXml.com.cn/；
           3）从第20行可以看出，我们查询手机号码归属地时要调用的方法名称为：getMobileCodeInfo；
           4）从第23-24行可以看出，我们调用getMobileCodeInfo方法时需要传入两个参数：mobileCode和userId；
           5）从第31行可以看出，调用getMobileCodeInfo方法后，将返回一个名为getMobileCodeInfoResult的结果字符串。
      到这里，我们已经初步认识了WebSerivce，以及SOAP和WSDL。这些知识具备后，就可以开始WebService相关的开发工作了。下一篇文章将讲解如何在Android平台编程调用上面的这个WebSerivce，并取得返回结果。