【Android学习笔记】调用Webservice

一、准备工作:
1、下载ksoap2(后面说明作用)到官网http://code.google.com/p/ksoap2-android/可下载最新jar。
2、新建Android项目,找到AndroidManifest.xml,在之间加入语句。(由于Android本身线程安全机制的存在,不加入此语句会抛相应网络异常)。
3、将ksoap2 jar包导入项目,方式一:直接复制并粘贴进Android项目中的libs文件夹中。方式二:右键项目,选择Properties->JavaBuild 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);
}
}
};
}







【【Android学习笔记】调用Webservice】

    推荐阅读