Android开发之WebService

做android开发这么久还没接触过webservice,菜菜菜,刚好项目接触过webservice，做个总结吧。
根据W3C的定义，Web Services(Web服务)是一个用于支持网络间不同机器互操作的软件系统，它是一种自包含、自描述和模块化的应用程序，它可以在网络中被描述、发布和调用，可以将它看作是基于网络的、分布式的模块化组件。

优势
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服务调用和应答的相关操作和消息。

<?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的结果字符串。
 
Ksoap2-android简介
  在Android平台调用Web Service需要依赖于第三方类库ksoap2，它是一个SOAP Web service客户端开发包，主要用于资源受限制的Java环境如Applets或J2ME应用程序（CLDC/ CDC/MIDP）。认真读完对ksoap2的介绍你会发现并没有提及它应用于Android平台开发，没错，在Android平台中我们并不会直接使用ksoap2，而是使用ksoap2 android。KSoap2 Android 是Android平台上一个高效、轻量级的SOAP开发包，等同于Android平台上的KSoap2的移植版本。

Ksoap2-android jar包下载
      ksoap2 android当前的最新版本为3.5.0，名为ksoap2-android-assembly-3.5.0-jar-with-dependencies.jar，它的下载地址是：http://code.google.com/p/ksoap2-android/.
Android调用webservice
public class MainActivity extends BaseActivity implements View.OnClickListener{
    private TextView tv_text;
    private  SoapObject object;
    private Handler  handler=new Handler() {
        @Override
        public void handleMessage(Message msg) {
            super.handleMessage(msg);
            Toast.makeText(getApplicationContext(),msg.obj.toString(), Toast.LENGTH_SHORT).show();
        }
    };
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        tv_text= (TextView) findViewById(R.id.testview);
        tv_text.setOnClickListener(this);
    }

    @Override
    public void onClick(View v) {
        switch (v.getId()){
            case R.id.testview:
                Login();
            break;
        }
    }
    private void Login() {
        new Thread() {
            @Override
            public void run() {
                super.run();
                //命名空间
                String nameSpace = "http://biz.com/";
                //调用的方法名称
                String methodName = "loginUser";
                //EndPoint
                String endPoint = "http://121.40.148.112/MybidService/services/UserBiz";
                //SOAP Action
                String soapAction = "http://biz.com/loginUser";
                //将指定的WebService的命名空间和调用的方法名
                SoapObject rpc = new SoapObject(nameSpace, methodName);
                //设置需调用WebService接口需要的参数
                rpc.addProperty("loginName", "1");
                rpc.addProperty("pwd", "1");
                //生成调用WebService方法的SOAP请求信息，并指定SOAP的版本
                SoapSerializationEnvelope envelope = new SoapSerializationEnvelope(SoapEnvelope.VER11);
                envelope.bodyOut = rpc;
                // 设置是否调用的是dotNet开发的WebService
                envelope.dotNet = true;
                // 等价于envelope.bodyOut = rpc;
                envelope.setOutputSoapObject(rpc);
                HttpTransportSE transport = new HttpTransportSE(endPoint);
                transport.debug = true;
                // 调用WebService
                try {
                    transport.call(soapAction, envelope);
                    if (envelope.getResponse() != null) {
                        object = (SoapObject) envelope.bodyIn;
                        Message message = handler.obtainMessage();
                        message.obj = object;
                        handler.sendMessage(message);
                    }
                } catch (Exception e) {
                    e.printStackTrace();
                }
            }
        }.start();
    }
}          
            

网络权限

<!-- 访问网络的权限 -->
    <uses-permission android:name="android.permission.INTERNET" /> 

参考博客：
http://blog.csdn.net/long704480904/article/details/8636734
http://my.oschina.net/u/1474779/blog/286389
http://my.oschina.net/crossbell/blog/277809