【Android学习笔记】调用Webservice

一、准备工作：

1、下载ksoap2(后面说明作用) 到官网http://code.google.com/p/ksoap2-android/可下载最新jar。

2、新建Android项目，找到AndroidManifest.xml，在<manifest></manifest>之间加入<uses-permission android:name="android.permission.INTERNET" />语句。（由于Android本身线程安全机制的存在，不加入此语句会抛相应网络异常）。

3、将ksoap2 jar包导入项目，方式一：直接复制并粘贴进Android项目中的libs文件夹中。方式二：右键项目，选择Properties->Java Build Path->Libraries->Add External JARs 添加对应jar包。

准备工作完成。

二、编写WebService类(有的人可能会问，能不能在MainActivity直接写相关方法，建议最好不要，因为会很麻烦，后面详细说明)

1、定义命名空间、Webservice地址、方法名、方法对应Action等参数：

例：

//命名空间

private static final String NAMESPACE = "http://tempuri.org/";

//WebService地址

private static final String URL = "http://wcf.scaucs.net/MainService.svc";

//需要调用的方法名

private static final String METHOD = "UserLogin";

//方法对应的Action

private static final String ACTION = "http://tempuri.org/IMainService/UserLogin";

2、实例化SoapObject对象并设置方法相关参数：(此时SoapObject相关操作由ksoap2 jar包提供，也就是说没该jar包此处便无法完成)

例：

//1.实例化SoapObject对象

SoapObject request = new SoapObject(NAMESPACE, METHOD);

//2.如果方法需要参数，设置参数 （ UserLogin(strUserName,strPassWordMd5)方法参数）

request.addProperty("strUserName", "201131000423");

request.addProperty("strPassWordMd5", "9775A1BCFFDA8D65C279D2E18E1C7AF0");

3、设置Soap的请求信息，参数部分为Soap协议的版本号(此版本号对应调用服务端版本号，设置错误会抛异常)

例:

//3.设置Soap的请求信息,参数部分为Soap协议的版本号

SoapSerializationEnvelope envelope = new SoapSerializationEnvelope(SoapEnvelope.VER11);

envelope.dotNet = true;

envelope.bodyOut=request;

envelope.setOutputSoapObject(request);

4、构建Http传输对象：

例：

//4.构建传输对象

HttpTransportSE transport = new HttpTransportSE(URL);

transport.debug = true; //设置可否调试

5、访问WebService,第一个参数为调用方法的Aciton,第二个参数为Envelope对象,并取得返回对象

例：

//5.访问WebService,第一个参数为调用方法的Aciton,第二个参数为Envelope对象

try {

transport.call(ACTION, envelope);

//解析返回的数据（返回数据的方式有两种，1：envelope.bodyIn 2：envelop.getResponse）

String result = envelope.getResponse().toString();

//注意这里envelope返回的数据是SoapObject类型，要经过进一步的解析才能得到想要的数据。（附录详解）

} catch (IOException e) {

e.printStackTrace();

} catch (XmlPullParserException e) {

e.printStackTrace();

}

return result;

上述代码完整版本：

public String login(String number) {

String result = "";

//1.实例化SoapObject对象

SoapObject request = new SoapObject(NAMESPACE, METHOD);

//2.如果方法需要参数，设置参数

request.addProperty("strUserName", number);

request.addProperty("strPassWordMd5", "9775A1BCFFDA8D65C279D2E18E1C7AF0");

//3.设置Soap的请求信息,参数部分为Soap协议的版本号

SoapSerializationEnvelope envelope = new SoapSerializationEnvelope(SoapEnvelope.VER11);

envelope.dotNet = true;

envelope.bodyOut=request;

envelope.setOutputSoapObject(request);

//4.构建传输对象

HttpTransportSE transport = new HttpTransportSE(URL);

transport.debug = true;

//5.访问WebService,第一个参数为调用方法的Aciton,第二个参数为Envelope对象

try {

transport.call(ACTION, envelope);

//6.解析返回的数据

result = envelope.getResponse().toString();

} catch (IOException e) {

e.printStackTrace();

} catch (XmlPullParserException e) {

e.printStackTrace();

}

return result;

}

到这里为止调用WebService方法的代码就已经写完了，但是前面已经提过，由于Android的线程安全问题，我们是无法在MainActivity主类中调用WebService的方法的，因此要借用副线程和消息机制来调用。

三、编写辅助副线程WebThread类，和MainActivity类中相应代码

简要解释下以下两个类中的调用原理，详细请看代码：

1、前面所说,由于Android线程安全问题，MainActivity中直接调用WebService的login方法是会抛异常的。

2、所以我们通过消息收发的机制解决此问题，并间接调用WebService

3、在MainActivity按下Button－>启动WebThread线程并调用WebService login方法->调用完毕WebThread发送消息0至MainActivity消息收发器handler->当收到消息为0时取login返回值并显示在TextView上。

WebThread类例：

public class WebThread implements Runnable{

public String str_login="";

//判断是否成功的标识符

public boolean inSucess=false;

private String input;

public WebThread(){

}

@Override

public void run() {

// TODO Auto-generated method stub

//创建WebService实例

WebService ws = new WebService();

//UserLogin返回值赋给str_login

str_login=ws.login();

//上述操作完成后向MainActivity的handler发送一条0消息

MainActivity.handler.sendEmptyMessage(0);

}

}

MainActivity类例：

public class MainActivity extends Activity {

//消息收发器Handler

public static Handler handler;

WebThread wt;

Button bt;

TextView text;

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(R.layout.activity_main);

//取layout中activity_main.xml布局文件中id为button的按钮并赋给Button bt

bt = (Button)findViewById(R.id.button);

//同Button bt，详细内容可查看layout->activity_main.xml和gen->R.java

text = (TextView)findViewById(R.id.text);

//按下bt按钮启动副线程WebThread

bt.setOnClickListener(new OnClickListener() {

@Override

public void onClick(View arg0) {

//实例化WebThread wt

wt =new WebThread();

//启动WebThread wt

new Thread(wt).start();

}

});

//实例化消息收发器handler并设置其收消息响应代码

handler = new Handler(){

public void handleMessage(android.os.Message msg) {

//当收到内容为0的消息时

if(msg.what==0){

//text设置为WebService中login方法返回值

text.setText(wt.str_login);

}

}

};

}