安卓网络编程——WebService

序

先偷一张图，出处：http://www.runoob.com/w3cnote/android-tutorial-webservice.html

还找了一篇关于webservice接口和http接口（API接口）的区别的文章

https://www.cnblogs.com/leeego-123/p/10404631.html

---

WebService实际上解决了两个问题：

1. 与服务器数据交互的问题
2. 不同的语言间的相互调用的问题 

下面进入正题

---

WebService

概述

正如前文所提到的，WebService是一种基干SOAP协议的远程调用标准，通过webservice可以将不同操作系统平台、不同语言、不同技术整合到一块。

Android系统中并没有内置WebService，所以需要依赖第三方库，比较常用的WebService有Ksoap2（一个高效且轻量级的SOAP开发包）

老项目地址：http://code.google.com/p/ksoap2-android/downloads/list

已经搬去Github：https://github.com/simpligility/ksoap2-android

项目主页：http://simpligility.github.io/ksoap2-android/index.html

目前最新版本3.6.4

将下载的ksoap2-xxx- dependencies.jar包复制到工程的lib目录中（右键选择jar包...add as....)

---

调用WebService的步骤

（这部分非原创，但是烂大街了，也不好深究出处 233）

按顺序为：

指定webservice的命名空间和调用的方法名

SoapObject request = new SoapObject(http://service,"getName");

• SoapObject类的第一个参数表示WebService的命名空间，可以从WSDL文档中找到WebService的命名空间。
• 第二个参数表示要调用的WebService方法名。 

设置调用方法的参数值

如果没有参数，可以省略，设置方法的参数值的代码如下：

Request.addProperty("param1","value");
Request.addProperty("param2","value");

• 要注意的是，addProperty方法的第1个参数虽然表示调用方法的参数名，但该参数值并不一定与服务端的WebService类中的方法参数名一致，只要设置参数的顺序一致即可。

生成调用Webservice方法的SOAP请求信息

该信息由SoapSerializationEnvelope对象描述，代码为：

SoapSerializationEnvelope envelope new  SoapSerializationEnvelope(SoapEnvelope.VER11);
Envelope.bodyOut = request;

• 创建SoapSerializationEnvelope对象时需要通过SoapSerializationEnvelope类的构造方法设置SOAP协议的版本号。
• 该版本号需要根据服务端WebService的版本号设置。
• 在创建SoapSerializationEnvelope对象后，不要忘了设置SOAPSoapSerializationEnvelope类的bodyOut属性，该属性的值就是在第一步创建的SoapObject对象。

创建HttpTransportsSE对象

通过HttpTransportsSE类的构造方法可以指定WebService的WSDL文档的URL：

HttpTransportSE ht = new HttpTransportSE("http://192.168.18.17:80/axis2/service/SearchNewsService?wsdl");

使用call方法调用WebService方法

ht.call(null，envelope);

• Call方法的第一个参数一般为null
• 第2个参数就是在第3步创建的SoapSerializationEnvelope对象。

使用getResponse方法获得WebService方法的返回结果

SoapObject soapObject = (SoapObject) envelope.getResponse();

---

 查看手机归属地案例

第一步，依旧还是添加一下网络权限。

 <uses-permission android:name="android.permission.INTERNET"/>

然后布局的话，随便建一个按钮添加点击事件就好。

 下面放代码：

完整代码

package com.example.a4_17android_async_http;

import android.os.Environment;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.view.View;

import com.loopj.android.http.AsyncHttpClient;
import com.loopj.android.http.AsyncHttpResponseHandler;
import com.loopj.android.http.FileAsyncHttpResponseHandler;
import com.loopj.android.http.JsonHttpResponseHandler;
import com.loopj.android.http.RequestParams;

import org.json.JSONException;
import org.json.JSONObject;

import java.io.File;
import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.io.UnsupportedEncodingException;

import cz.msebera.android.httpclient.Header;
import cz.msebera.android.httpclient.entity.StringEntity;

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }

    //发送一个简单的GET请求
    public void sendGet(View view) {
        //发送请求客户端
        AsyncHttpClient client = new AsyncHttpClient();
        //调用其get方法，参数1 URL
        client.get("https://blog.csdn.net", new AsyncHttpResponseHandler() {
            @Override
            public void onSuccess(int statusCode, Header[] headers, byte[] responseBody) {
                //200 OK
                String info = new String(responseBody);
                System.out.println(info);
            }

            @Override
            public void onFailure(int statusCode, Header[] headers, byte[] responseBody, Throwable error) {
                System.out.println("error:" + new String(responseBody));
            }
        });
    }

    //发送一个带参数的请求
    public void sendParams(View view) {
        AsyncHttpClient client = new AsyncHttpClient();
        RequestParams params = new RequestParams();
        params.put("username", "admin");
        params.put("password", "admin");
        client.post(this, "http://10.0.2.2:8080/contact/android", params, new AsyncHttpResponseHandler() {
            @Override
            public void onSuccess(int statusCode, Header[] headers, byte[] responseBody) {
                System.out.println(new String(responseBody));
            }

            @Override
            public void onFailure(int statusCode, Header[] headers, byte[] responseBody, Throwable error) {
                System.out.println(new String(responseBody));
            }
        });
    }


    //上传文件
    public void upload(View view) {
        AsyncHttpClient client = new AsyncHttpClient();
        RequestParams params = new RequestParams();
        params.put("description", "描述");
        try {
            //拿到相对应的目录
            String path = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PICTURES) + "/test.jpg";
            //设置文件
            params.put("myfile", new File(path), "image/jpeg");
        } catch (FileNotFoundException e) {
            e.printStackTrace();
        }
        client.post(this, "http://10.0.2.2:8080/contact/upload", params, new AsyncHttpResponseHandler() {
            @Override
            public void onSuccess(int statusCode, Header[] headers, byte[] responseBody) {
                System.out.println("成功");
                //System.out.println(new String(responseBody));
            }

            @Override
            public void onFailure(int statusCode, Header[] headers, byte[] responseBody, Throwable error) {
                System.out.println("失败");
                //System.out.println(new String(responseBody));
            }
        });
    }

    //下载二进制数据
    public void download(View view) {
        AsyncHttpClient client = new AsyncHttpClient();
        client.get("https://ss2.baidu.com/6ONYsjip0QIZ8tyhnq/it/u=2276456453,1005174699&fm=58&bpow=7416&bpoh=4320", new FileAsyncHttpResponseHandler(this) {
            @Override
            public void onFailure(int statusCode, Header[] headers, Throwable throwable, File file) {
                //错误处理
                System.out.println("下载失败");
            }

            @Override
            public void onSuccess(int statusCode, Header[] headers, File file) {
                //成功，第三个参数表示缓存目录，会先下载到缓存目录
                System.out.println(file.getAbsolutePath());
                String path = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PICTURES) + "/这里随便给个文件名.jpg";
                try {
                    //输入输出流
                    InputStream in = new FileInputStream(file);
                    OutputStream out = new FileOutputStream(path);
                    byte[] bytes = new byte[100];
                    int len = -1;
                    while ((len = in.read(bytes)) != -1) {
                        out.write(bytes, 0, len);
                        out.flush();
                    }
                    out.close();
                    in.close();
                } catch (FileNotFoundException e) {
                    e.printStackTrace();
                } catch (IOException e) {
                    e.printStackTrace();
                }
                System.out.println("下载完成");
            }
        });
    }

    //JSON请求
    public void json(View view) {
        AsyncHttpClient client = new AsyncHttpClient();
        String url = "http://10.0.2.2:8080/contact/upload";
        JSONObject jsonObject = new JSONObject();
        try {
            jsonObject.put("username", "admin");
            jsonObject.put("password", "admin");
            StringEntity entity = new StringEntity(jsonObject.toString());
            client.post(this, url, entity, "application/json", new JsonHttpResponseHandler() {
                @Override
                public void onSuccess(int statusCode, Header[] headers, JSONObject response) {
                    super.onSuccess(statusCode, headers, response);
                    System.out.println(response.toString());
                }
            });
        } catch (JSONException e) {
            e.printStackTrace();
        } catch (UnsupportedEncodingException e) {
            e.printStackTrace();
        }
    }


}

测试效果：

界面没啥特别的，点击按钮。控制台输出?图内容。