这里我们的WebService使用xFire开发。
首先开发服务器端,为了方便我们使用MyEclipse开发WebService
定义文件操作的接口IFileServices.java
package com.iflytek.services; public interface IFileServices { /** * 文件的保存 * * @param fileName * 文件名称 * @param content * 文件的内容 * @throws Exception */ public void save(String fileName, String content) throws Exception; /** * 文件的读取 * * @param fileName * 文件名称 * @return * @throws Exception */ public String load(String fileName) throws Exception; }
实现类FileServicesImpl.java
package com.iflytek.services.impl; import java.io.File; import java.io.FileInputStream; import java.io.FileOutputStream; import java.io.PrintStream; import java.util.Scanner; import com.iflytek.services.IFileServices; public class FileServicesImpl implements IFileServices { public String load(String fileName) throws Exception { File file = new File("D:" + File.separator + "xdwang" + File.separator + fileName); if (!file.exists()) { // 文件不存在 return null; } StringBuffer buf = new StringBuffer(); Scanner scan = new Scanner(new FileInputStream(file)); scan.useDelimiter("\n"); while (scan.hasNext()) { buf.append(scan.next()); } scan.close(); return buf.toString(); } public void save(String fileName, String content) throws Exception { File file = new File("D:" + File.separator + "xdwang" + File.separator + fileName); if (!file.getParentFile().exists()) { file.getParentFile().mkdirs(); } PrintStream out = new PrintStream(new FileOutputStream(file)); out.print(content); out.close(); } }
配置services.xml
<?xml version="1.0" encoding="UTF-8"?> <beans xmlns="http://xfire.codehaus.org/config/1.0"> <service> <name>iflytek</name> <serviceClass> com.iflytek.services.IFileServices </serviceClass> <implementationClass> com.iflytek.services.impl.FileServicesImpl </implementationClass> <style>wrapped</style> <use>literal</use> <scope>application</scope> </service> </beans>
?
这时,在浏览器上输入:
http://IP:8080/AndroidWebServiceProject/services/iflytek?wsdl ,即可打开,为此一个 Web Service 程序的服务器端就开发完成了,下面我们进行 Android 客户端程序的开发。
Android 程序要调用 Web Service 程序,并不像调用 JSP/Servlet 或 Socket 程序那样直接使用系统提供的类完成,因为 Android 中并没有提供直接与 WebService 互调用的操作类库,所以必须依靠第三方提供的类库才可以完成,比较常用的就是 ksoap 类库,可以到 http://code.google.com/p/ksoap2-android/ 上进行下载。
下载过后,将其配置到 Android 项目的 Java Build Path 中即可,配置完成之后,即可在 Android 中编写程序调用 WebService 程序,具体步骤如下:
1、 通过 org.ksoap2.serialization.SoapObject 类来指定要调用的 WebService 程序所需要的命名控件,而 SoapObject 类的常用方法如下:
No. |
方法 |
描述 |
1 |
Public SoapObject(String namespace,String name) |
实例化 SoapObject 类对象 |
2 |
Public String getName() |
取得要调用的方法名称 |
3 |
Public String getNameSpace() |
取得 Soap 对象的命名空间 |
4 |
Public Object getProperty(java.lang.String name) |
取得指定名称的属性 |
5 |
Public SoapObject addProperty(String name,Object value) |
设置调用 WebService 方法时所需要的参数 |
2、 取得 SoapObject 的实例化对象之后,即可通过 SoapObject 类的 addProperty() 方法设置调用 save() 方法时所需要的参数,而设置的顺序要与 Web Service 程序端的 save() 方法的参数顺序符合,在调用 addProperty() 方法时,不一定非要和服务器端上的方法名称、参数名称一样,因为程序在执行时也只是根据设置参数的顺序来决定,而不是根据名称。
3、 生成调用 WebService 程序的 SOAP 请求信息,此时可以利用 org.ksoap2.serialization.SoapSerializationEnvelope 类完成,此类的常用方法如下:
No. |
方法、常量、属性 |
类型 |
描述 |
1 |
Public static final int VER11 |
常量 |
使用 SOAP 11 版本操作 |
2 |
Public Object bodyIn |
属性 |
封装输入的 SoapObject 对象 |
3 |
Public Object bodyOut |
属性 |
封装输出的 SoapObject 对象 |
4 |
Public Boolean dotNet |
属性 |
是否为 .NET 连接,此处设置为 false ,如果设置为 true ,则服务器端无法接受请求参数 |
5 |
Public SoapSerializationEnvelope(int version) |
构造 |
实例化 SoapSerializationEnvelope 类对象 |
6 |
Public void setOutputSoapObject(Object soapObject) |
普通 |
设置要输出的 SoapObject 对象 |
4、 创建 org.ksoap2.transport.HttpTransportSE 类对象,并且利用此对象调用 WebService 端的操作方法,此类的常用操作如下:
No. |
方法、属性 |
描述 |
1 |
Public Boolean debug |
是否调试,如果设置为 true ,则表示调试 |
2 |
Public HttpTransportSE(String url) |
实例化 HttpTransportSE 类的对象 |
3 |
public void call(String soapAction, SoapEnvelope envelope) throws IOException, XmlPullParserException |
调用 WebService 端的操作方法 |
5、 接受 WebService 的返回值
Android 客户端代码
WebServiceActivity.java
package com.iflytek.demo; import java.io.IOException; import org.ksoap2.SoapEnvelope; import org.ksoap2.serialization.SoapObject; import org.ksoap2.serialization.SoapSerializationEnvelope; import org.ksoap2.transport.HttpTransportSE; import org.xmlpull.v1.XmlPullParserException; import android.app.Activity; import android.os.AsyncTask; import android.os.Bundle; import android.view.View; import android.view.View.OnClickListener; import android.widget.Button; import android.widget.TextView; import android.widget.Toast; public class WebServiceActivity extends Activity { private Button saveBtn = null; private Button loadBtn = null; private TextView showTxt = null; /** * 需要调用WebService的命名空间 */ private static final String NAMESPACE = "http://IP/"; /** * 服务的地址,不需要*.wsdl */ private static String URL = "http://IP:8080/AndroidWebServiceProject/services/iflytek"; /** * 需要调用的保存方法 */ private static final String SAVE_METHOD_NAME = "save"; /** * 需要调用的读取方法 */ private static final String LOAD_METHOD_NAME = "load"; private static String SOAP_ACTION = "http://IP:8080/AndroidWebServiceProject/services/"; /** Called when the activity is first created. */ @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); this.saveBtn = (Button) super.findViewById(R.id.save); this.loadBtn = (Button) super.findViewById(R.id.load); this.showTxt = (TextView) super.findViewById(R.id.show); this.saveBtn.setOnClickListener(new SaveOnClickListenerImpl()); this.loadBtn.setOnClickListener(new LoadOnClickListenerImpl()); } private class SaveOnClickListenerImpl implements OnClickListener { @Override public void onClick(View v) { final AsyncTask<Void, Void, String> task = new AsyncTask<Void, Void, String>() { @Override protected void onPostExecute(String result) { Toast.makeText(WebServiceActivity.this, "数据保存成功", Toast.LENGTH_SHORT).show(); } @Override protected void onPreExecute() { super.onPreExecute(); } @Override protected String doInBackground(Void... arg0) { SoapObject soapObject = new SoapObject(NAMESPACE, SAVE_METHOD_NAME); soapObject.addProperty("fileName", "xdwang.txt");// 设置参数 soapObject.addProperty("content", "Hello, xdwang "); SoapSerializationEnvelope envelope = new SoapSerializationEnvelope( SoapEnvelope.VER11);// 给出版本号 envelope.bodyOut = soapObject;// 输出对象 envelope.dotNet = false;// 不是.NET服务器 envelope.setOutputSoapObject(soapObject);// 输出SoapObjet HttpTransportSE trans = new HttpTransportSE(URL);// 指定地址 trans.debug = true; // 使用调试功能 try { trans.call(SOAP_ACTION, envelope);// 调用方法 } catch (IOException e) { e.printStackTrace(); } catch (XmlPullParserException e) { e.printStackTrace(); } return null; } }; task.execute(); } } private class LoadOnClickListenerImpl implements OnClickListener { @Override public void onClick(View v) { final AsyncTask<Void, Void, String> task = new AsyncTask<Void, Void, String>() { @Override protected void onPostExecute(String result) { WebServiceActivity.this.showTxt .setText("Web Service返回的数据是:" + result); } @Override protected void onPreExecute() { super.onPreExecute(); } @Override protected String doInBackground(Void... arg0) { SoapObject soapObject = new SoapObject(NAMESPACE, LOAD_METHOD_NAME); soapObject.addProperty("fileName", "xdwang.txt");// 设置参数 SoapSerializationEnvelope envelope = new SoapSerializationEnvelope( SoapEnvelope.VER11);// 给出版本号 envelope.bodyOut = soapObject;// 输出对象 envelope.dotNet = false;// 不是.NET服务器 envelope.setOutputSoapObject(soapObject);// 输出SoapObjet HttpTransportSE trans = new HttpTransportSE(URL);// 指定地址 trans.debug = true; // 使用调试功能 try { trans.call(SOAP_ACTION, envelope);// 调用方法 } catch (IOException e) { e.printStackTrace(); } catch (XmlPullParserException e) { e.printStackTrace(); } SoapObject result = (SoapObject) envelope.bodyIn;// 接收返回值 return result.getProperty(0).toString(); } }; task.execute(); } } }
main.xml
<?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:orientation="vertical" android:layout_width="fill_parent" android:layout_height="fill_parent"> <Button android:id="@+id/save" android:layout_width="fill_parent" android:layout_height="wrap_content" android:text="通过WebService保存文件" /> <Button android:id="@+id/load" android:layout_width="fill_parent" android:layout_height="wrap_content" android:text="通过WebService读取文件" /> <TextView android:id="@+id/show" android:layout_width="fill_parent" android:layout_height="wrap_content" android:text="显示文件读取内容" /> </LinearLayout>
AndroidManifest.xml
<uses-permission android:name="android.permission.INTERNET" />
?
?
?
?
?