序
先偷一张图,出处:http://www.runoob.com/w3cnote/android-tutorial-webservice.html
还找了一篇关于webservice接口和http接口(API接口)的区别的文章
WebService实际上解决了两个问题:
- 与服务器数据交互的问题
- 不同的语言间的相互调用的问题
下面进入正题
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();
}
}
}
测试效果:
界面没啥特别的,点击按钮。控制台输出👉图内容。