android调用web service(cxf)实例

Google为ndroid平台开发Web Service提供了支持,提供了Ksoap2-android相关架包

1.下载该夹包可以直接登录http://code.google.com/p/ksoap2-android/,现在该站点已经提供了直接的下载,只要点击下载链接就可以下载了;

我现在的是ksoap2-android-assembly-2.6.5-jar-with-dependencies.jar

2.好了,现在我们就可以进行新建项目来进行测试了,首先我们先建立java服务端,这里的一些前期准备我就不说了(比如与spring的整合等示例),

如果有不清楚的可以去看博客  http://www.cnblogs.com/shenliang123/archive/2012/04/16/2451580.html

由于这里重点是android客户端,java服务器端就直接给代码了

Interface:(这里提供了两个方法,一个传递的是简单字符串,另一个传递的是符合对象+集合)

package xidian.sl.service.webService;

import javax.jws.WebParam;
import javax.jws.WebService;
import javax.jws.soap.SOAPBinding;
import javax.jws.soap.SOAPBinding.Style;

import xidian.sl.service.impl.webService.StudentList;

@WebService
@SOAPBinding(style = Style.RPC)
public interface TestService {
    public String getUser(@WebParam(name = "name")String name);
    public StudentList getStuList();
}    

implement:

package xidian.sl.service.impl.webService;

import java.util.ArrayList;
import java.util.List;

import javax.jws.WebService;

import xidian.sl.entity.Students;
import xidian.sl.service.webService.TestService;

@WebService(endpointInterface = "xidian.sl.service.webService.TestService")
public class TestServiceImpl implements TestService {

    @Override
    public String getUser(String name) {
        System.out.println("客户端传递的名字为 = "+name);
        return name;
    }

    @Override
    public StudentList getStuList() {
        System.out.println("该方法被调用");
        List<Students> stuList = new ArrayList<Students>();
        //第一个学生
        Students stu1 = new Students();
        stu1.setStuName("沈浪");
        stu1.setStuNum("1006010054");
        stu1.setStuSex("男");
        stuList.add(stu1);
        //第二个学生
        Students stu2 = new Students();
        stu2.setStuName("香香");
        stu2.setStuNum("1006010043");
        stu2.setStuSex("女");
        stuList.add(stu2);
        //将List集合封装成一个对象才能在webService中进行传递
        StudentList studentList = new StudentList();
        studentList.setStuList(stuList);
        return studentList;
    }

}

list的封装对象

package xidian.sl.service.impl.webService;

import java.util.List;

import xidian.sl.entity.Students;

public class StudentList {
    private List<Students> stuList;

    public List<Students> getStuList() {
        return stuList;
    }

    public void setStuList(List<Students> stuList) {
        this.stuList = stuList;
    }
    
}    

然后在srping的整合配置文件中进行如下配置即可(默认web.xml中已经进行配置)

<?xml version="1.0" encoding="UTF-8"?>
        <beans xmlns="http://www.springframework.org/schema/beans"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xmlns:jaxws="http://cxf.apache.org/jaxws"
        xsi:schemaLocation="
                http://www.springframework.org/schema/beans 
                http://www.springframework.org/schema/beans/spring-beans.xsd
                http://www.springframework.org/schema/context
                http://www.springframework.org/schema/context/spring-context.xsd
                http://cxf.apache.org/jaxws 
                http://cxf.apache.org/schemas/jaxws.xsd">
        
                <import resource="classpath:META-INF/cxf/cxf.xml" />  <!-- 这些xml文件在cxf-2.5.0.jar的META-INF目录下-->
                <!--<import resource="classpath:META-INF/cxf/cxf-extension-soap.xml" />
                        警告提示已经废弃了cxf-extension-soap.xml文件-->
                <import resource="classpath:META-INF/cxf/cxf-servlet.xml" />

                
                <!-- 这里配置服务接口,后面描述
                
                    id:指在spring配置的bean的ID.

                    Implementor:指明具体的实现类.

                    Address:指明这个web service的相对地址
                 -->

                      <!-- 测试 -->
                      <bean id="testServiceImpl" class="xidian.sl.service.impl.webService.TestServiceImpl" >
                      </bean>
                    <jaxws:endpoint id="testService" 
                            implementor="#testServiceImpl"
                            address="/test" />
                      
                  <!-- 开启tomcat服务器 ,访问http://localhost:8080/WebExam/services/test?wsdl 
                      http://localhost:8080/WebExam是本项目的访问地址

                    services是由于web.xml配置所得,test是由于Spring配置文件中的address属性所得
                  
                  -->
                  
        </beans>

        

3.到此服务器端的已经建立完全,我们可以测试下:开启tomcat,然后在浏览器中输入http://localhost:8090/WebExam/services/test?wsdl可以查看wsdl


现在我们就可以开始建立android客户端了

新建一个项目后导入ksoap2-android-assembly-2.6.5-jar-with-dependencies.jar,这里要特别注意:导入包的方式不要选择项目右键---->build path---->

add external archives...,如果使用这种方式表面上好像是导入了包,但还是没有办法引用到,然后启动项目后一直会报

我们还是选择和开发web一样的方式,就是在项目下新建lib或者libs文件夹,然后将jar直接复制到该文件夹中,IDE会帮助直接引入的

这样就正确无误了,不再会报类无法引用到了

android中通过webservice调用服务器端其实还是很简单的,只要按部就班的按照下面步骤进行即可:

(1)创建HttpTransportSE对象,该对象用于调用WebService操作

HttpTransportSE ht = new HttpTransportSE(SERVICE_URL);

(2)创建SoapSerializationEnvelope对象

 SoapSerializationEnvelope envelope = new SoapSerializationEnvelope(SoapEnvelope.VER11);

(3)创建SoapObject对象,创建该对象时需要传入所要调用的Web Service的命名空间和WebService方法名

SoapObject request = new SoapObject(SERVICE_NS, methodName);

(4)如果有参数传给Web Service服务器端,调用SoapObject对象的addProperty(String name, Object value)方法来设置参数,该方法的name参数指定参数名

  注意:参数名不一定要与服务端的方法中的参数名相同,只要对应顺序相同即可;value参数指定参数值

request.addProperty("name", "1006010054");

(5)调用SoapSerializationEnvelope的setOutputSoapObject()方法,或者直接对bodyOut属性赋值,将前两步创建的SoapObject对象设为SoapSerializationEnvelope

  的传出SOAP消息体

 envelope.bodyOut = request;

(6)调用对象的call()方法,并以SoapSerializationEnvelope作为参数调用远程的web service

ht.call(null, envelope);

(7)掉用完成后,访问SoapSerializationEnvelope对象的bodyIn属性,该属性返回一个SoapObject对象,该对象就代表Web service的返回消息,解析该对象,即可获得

  调用web service的返回值

SoapObject result = (SoapObject) envelope.bodyIn;
                String name = result.getProperty(0).toString();

下面给书具体的实例:
mian.xml很简单就是两个编辑框:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    android:orientation="vertical" >

    <TextView
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:text="@string/hello" />

    <EditText
        android:id="@+id/editText1"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:ems="10" >

        <requestFocus />
    </EditText>

    <EditText
        android:id="@+id/editText2"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:ems="10" />

</LinearLayout>

Activity:(该Activity调用了服务器端返回普通字符串的方法)

package xidian.sl.android.webservice;

import org.ksoap2.SoapEnvelope;
import org.ksoap2.serialization.SoapObject;
import org.ksoap2.serialization.SoapSerializationEnvelope;
import org.ksoap2.transport.HttpTransportSE;

import android.app.Activity;
import android.os.Bundle;
import android.widget.EditText;

public class WebServiceSimpleDemo extends Activity{
    final static String SERVICE_NS = "http://webService.service.sl.xidian/";
    final static String SERVICE_URL = "http://192.168.1.103:8090/WebExam/services/test";
    private EditText txt1;
    private EditText txt2;
    /** Called when the activity is first created. */
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        txt1 = (EditText) findViewById(R.id.editText1);
        txt2 = (EditText) findViewById(R.id.editText2);
        //调用的方法
        String methodName = "getUser";
        //创建httpTransportSE传输对象
        HttpTransportSE ht = new HttpTransportSE(SERVICE_URL);
        ht.debug = true;
        //使用soap1.1协议创建Envelop对象
        SoapSerializationEnvelope envelope = new SoapSerializationEnvelope(SoapEnvelope.VER11);
        //实例化SoapObject对象
        SoapObject request = new SoapObject(SERVICE_NS, methodName);
        /**
         * 设置参数,参数名不一定需要跟调用的服务器端的参数名相同,只需要对应的顺序相同即可
         * */
        request.addProperty("name", "1006010054");
        //将SoapObject对象设置为SoapSerializationEnvelope对象的传出SOAP消息
        envelope.bodyOut = request;
        try{
            //调用webService
            ht.call(null, envelope);
            //txt1.setText("看看"+envelope.getResponse());
            if(envelope.getResponse() != null){
                txt2.setText("有返回");
                SoapObject result = (SoapObject) envelope.bodyIn;
                String name = result.getProperty(0).toString();
                txt1.setText("返回值 = "+name);
            }else{
                txt2.setText("无返回");
            }
        }catch (Exception e) {
            e.printStackTrace();
        }
    }
}

在AndroidManifest.xml进行Activity的注册和并添加访问网络的权限

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="xidian.sl.android.webservice"
    android:versionCode="1"
    android:versionName="1.0" >

    <uses-sdk android:minSdkVersion="10" />

    <application
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name" >
        <activity
            android:name=".WebServiceSimpleDemo"
            android:label="@string/app_name" >
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
    <!-- 声明该应用自身所拥有的权限 -->
    <uses-permission android:name="android.permission.INTERNET" />
</manifest>

运行后的结果如图所示:

下面我们来试着调用回传符合对象的方法:

activity:

package xidian.sl.android.webservice;

import org.ksoap2.SoapEnvelope;
import org.ksoap2.serialization.SoapObject;
import org.ksoap2.serialization.SoapSerializationEnvelope;
import org.ksoap2.transport.HttpTransportSE;

import android.app.Activity;
import android.os.Bundle;
import android.widget.EditText;

public class WebServiceComplexDemo extends Activity{
    final static String SERVICE_NS = "http://webService.service.sl.xidian/";
    final static String SERVICE_URL = "http://192.168.1.103:8090/WebExam/services/test";
    private EditText txt1;
    private EditText txt2;
    /** Called when the activity is first created. */
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        txt1 = (EditText) findViewById(R.id.editText1);
        txt2 = (EditText) findViewById(R.id.editText2);
        //调用的方法
        String methodName = "getStuList";
        //创建httpTransportSE传输对象
        HttpTransportSE ht = new HttpTransportSE(SERVICE_URL);
        ht.debug = true;
        //使用soap1.1协议创建Envelop对象
        SoapSerializationEnvelope envelope = new SoapSerializationEnvelope(SoapEnvelope.VER11);
        //实例化SoapObject对象
        SoapObject request = new SoapObject(SERVICE_NS, methodName);
        /**
         * 设置参数,参数名不一定需要跟调用的服务器端的参数名相同,只需要对应的顺序相同即可
         * */
        //request.addProperty("name", "1006010054");
        //将SoapObject对象设置为SoapSerializationEnvelope对象的传出SOAP消息
        envelope.bodyOut = request;
        try{
            //调用webService
            ht.call(null, envelope);
            txt2.setText("回传的值 :"+envelope.getResponse());
            if(envelope.getResponse() != null){
                SoapObject result = (SoapObject) envelope.bodyIn;
                SoapObject soapChilds = (SoapObject)result.getProperty(0); 
                StringBuffer sb = new StringBuffer();
                for(int   i=0; i <soapChilds.getPropertyCount(); i++){ 
                    SoapObject soapChildsChilds = (SoapObject)soapChilds.getProperty(i); 
                    sb.append("姓名["+i+"] = "+soapChildsChilds.getProperty(0).toString()+"\n");
                    sb.append("学号["+i+"] = "+soapChildsChilds.getProperty(1).toString()+"\n");
                    sb.append("性别["+i+"] = "+soapChildsChilds.getProperty(2).toString()+"\n"+"\n");
            }
                txt1.setText(sb.toString());
            }else{
                txt1.setText("无返回");
            }
        }catch (Exception e) {
            e.printStackTrace();
        }
    }
}

区别就是对于返回值的处理上,使用几次getPropert()方法,这里主要看返回值的层次,看下面的结果应该就能明白了,根据括号的层次来进行确定

 

 

 

 

 

 

 

 

posted on 2012-07-05 23:25  发表是最好的记忆  阅读(28767)  评论(7编辑  收藏  举报