复杂对象类型的WebService高级部分

从客户端除了传递字符串以外还可以传递复杂对象(对象必须序列化了)，List,Map,数组和文件。

(1)定义一个对象实现了serializable 接口
package cn.com.chenlly.ssh.webservice.axis;

import java.io.Serializable;
import java.util.ArrayList;
import java.util.List;

public class Address implements Serializable { //复杂类型的类要序列化
 
 private Integer identifier;
 
 private String address;
 
 private String city;
 
 private String province;
 
 private String country;
 
 private String []array;   //javabean里的复杂类型
 
 private List<Integer> list;(基本类型)
 
 private boolean isExst;
 
 
 //constructor
 public Address(){
 
  list = new ArrayList<Integer>();
 
  list.add(1);
 
  list.add(2);
 
  list.add(3);
 }
 public Integer getIdentifier() {
  return identifier;
 }

public void setIdentifier(Integer identifier) {
  this.identifier = identifier;
 }

public String getAddress() {
  return address;
 }

public void setAddress(String address) {
  this.address = address;
 }

public String getCity() {
  return city;
 }

public void setCity(String city) {
  this.city = city;
 }

public String getProvince() {
  return province;
 }

public void setProvince(String province) {
  this.province = province;
 }

public String getCountry() {
  return country;
 }

public void setCountry(String country) {
  this.country = country;
 }

public String[] getArray() {
  return array;
 }

public void setArray(String[] array) {
  this.array = array;
 }

public List<Integer> getList() {
  return list;
 }

public void setList(List<Integer> list) {
  this.list = list;
 }

public boolean isExst() {
  return isExst;
 }

public void setExst(boolean isExst) {
  this.isExst = isExst;
 }
}

(2)定义server-config.wsdd文件

<deployment xmlns="http://xml.apache.org/axis/wsdd/"
 xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">
 <handler name="URLMapper"     //定义了两个handler（非必须），类似于过滤器
  type="java:org.apache.axis.handlers.http.URLMapper" />
 <handler name="wsTestHandler"
  type="java:cn.com.chenlly.ssh.webservice.axis.WSTestServiceHandle">
  <parameter name="status" value="success" />
 </handler>
 <!-- 自定义服务 -->
 <service name="ws" provider="java:RPC">
  <parameter name="className"
   value="cn.com.chenlly.ssh.webservice.axis.WSTestServiceImpl" />
  <parameter name="allowedMethods" value="*" />
  <parameter name="scope" value="request" />
 
  <responseFlow>
   <handler type="wsTestHandler" />    //响应时使用上面的handler

</responseFlow>
  <requestFlow>//请求时使用上面的handler
   <handler type="wsTestHandler" />

</requestFlow>
 
  <beanMapping qname="myNSD:Address"   //复杂类型javabean（用于传送的序列化对象）
   xmlns:myNSD="urn:AddressManager"
   languageSpecificType="java:cn.com.chenlly.ssh.webservice.axis.Address">
  </beanMapping>
 </service>

<transport name="http">
  <requestFlow>
   <handler type="URLMapper" />
  </requestFlow>
 </transport>
</deployment>

//主要是<beanMapping>标签中名字空间和qname写法
第一个你自定义的命名空间和第二个节点本地部分会组成一个新的QName。

生成的WSDL有如下一段
- <schema targetNamespace="urn:AddressManager" xmlns="http://www.w3.org/2001/XMLSchema">
  <import namespace="http://192.168.1.98:8082/SSHProject/services/ws" />
  <import namespace="http://xml.apache.org/xml-soap" />
  <import namespace="http://schemas.xmlsoap.org/soap/encoding/" />
- <complexType name="Address">
- <sequence>
  <element name="address" nillable="true" type="soapenc:string" />
  <element name="array" nillable="true" type="impl:ArrayOf_soapenc_string" />
  <element name="city" nillable="true" type="soapenc:string" />
  <element name="country" nillable="true" type="soapenc:string" />
  <element name="exst" type="xsd:boolean" />
  <element name="identifier" nillable="true" type="soapenc:int" />
  <element name="list" nillable="true" type="impl:ArrayOf_xsd_anyType" />
  <element name="province" nillable="true" type="soapenc:string" />
  </sequence>
  </complexType>
  </schema>
这个新的schema就是把对象序列化以后生成了xml流文件。

(3) webService 服务方法
public Address dealAddress(Address address) {
   System.out.println("service exst:"+address.isExst());
   //客户端对象传递过来设置标志为true
   address.setExst(true);
   return address;
}

(4) 客户端
package cn.com.chenlly.ssh.webservice.axis;

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

import javax.xml.namespace.QName;
import javax.xml.rpc.ParameterMode;

import org.apache.axis.client.Call;
import org.apache.axis.client.Service;
import org.apache.axis.encoding.ser.BeanDeserializerFactory;
import org.apache.axis.encoding.ser.BeanSerializerFactory;

public class WSTestServiceClient {
 public static void main(String[] args) {
  Service service = new Service();
  try {
   Call call = (Call) service.createCall();
   String url = "http://192.168.1.98:8082/SSHProject/services/ws?wsdl";
   call.setTargetEndpointAddress(new java.net.URL(url));
                        //定义对象
   Address address = new Address();
   address.setIdentifier(1);
   address.setProvince("湖南");
   address.setCity("长沙");
   address.setExst(false);

QName qn = new QName("urn:AddressManager", "Address");//第一个参数名字空间URI，第二个参数本地部分，注意这两部分在server-config.wsdd文件中标签beanMapping配置
   call.registerTypeMapping(Address.class, qn,
     new BeanSerializerFactory(Address.class, qn),//序列化
     new BeanDeserializerFactory(Address.class, qn));
 
   call.setOperationName(new QName(url,"dealAddress"));
 
   call.addParameter("arg0", qn, ParameterMode.IN);//定义一个参数类型，如果是String类型的参数可以不需要这句话
   call.setReturnClass(Address.class);//指定返回类型
 
   Address result = (Address) call.invoke(new Object[]{address});//这里传递给service的是一个对象
   System.out.println(result.isExst());
  } catch (Exception e) {
   e.printStackTrace();
  }
 }
}
//在服务器端打印的isExst()方法是false;然后设置address的exst为true;最后又传送到客户端打印的result结果为true

<beanMapping/> 需要说明的是:

1 如果服务中不需要传递对象,是不需要<beanMapping/>对的.而且這里面的对象必须要是符合javaBean模式的对象,最起码要符合get/set方法對.

2 qname xmlns:xx languageSpecificType分別用于指定参数对象的命名空间.用于在客戶端调用.

二、开发service
服务器端的service为普通的java类：com.hnisi.axis.BookOrder

public class BookOrder {
public String getName(String name) {
System.out.println("start execute ...");
return "book name: " + name;
}

public Book setPrice(Book book){
book.setPrice(10);
return book;
}
}

com.hnisi.axis.Book为简单的值对象，包含两个属性name,price。

三、发布service（将会错误）
1、手工修改server-config.wsdd文件（在已有server-config.wsdd文件的情况下）
添加service：

<service name="BookOrder" provider="java:RPC">
<parameter name="allowedMethods" value="*"/>
<parameter name="className" value="com.hnisi.axis.BookOrder"/>
</service>

原因：

由于SOAP中值的类型就是XML Schema中的基本类型，默认只支持简单类型和数组。所以在进行对象传递的过程中，需要进行序列化和反序列化。

Axis为提供了大量的序列化/反序列化器，能够基本满足大部分应用：
1、基本类型，如int、double等，转换成基本对象类型java.lang.Integer、java.lang.Double。
2、常用集合对象的转换
java.util.List ==> java.lang.Object[]
java.util.Vector  ==> java.util.Vector
3、普通JavaBean（简单值对象）的序列化和反序列化
首先，在web service部署端，修改server-config.wsdd文件，在具体的service配置，增加如下代码：
<beanMapping languageSpecificType="java:com.hnisi.axis.Book" qname="ns1:Book"
         xmlns:ns1="urn:BeanService"/>
languageSpecificType属性指定JavaBean类文件位置,qname属性指定JavaBean类的名字。当然，一个service可以绑定多个bean对象。

其次，在客户端，完成对象的注册。
对于调用方法一中，需要新增如下代码以完成注册：
QName qn = new QName("urn:BeanService","Book");
call.registerTypeMapping(Book.class, qn,
new BeanSerializerFactory(Book.class, qn),
                    new BeanDeserializerFactory(Book.class, qn));
而对于调用方法二，重新根据wsdl生成java代码，已完成必要的对象注册过程，CallService中可以直接传递Book对象了。

1）axis1.2内在支持的几种对象类型。
          这几种内在支持的对象包括：
          java基本类型 : int, float,,,,
          基本类型包装类 : Integer, Float, Long...
          还有String, Date, Calendar, BigDecimal, BigInteger, List, Map.
     凡是这些内在支持的对象， 不管他们作为某个Service的input 还是 output, 我们在服务端的axis1.2的WEB-INF/server-config.wsdd的该Service的定义中都不需要加入 <beanMapping>或者是<typeMapping>的声明。

2）简单的javabean对象类型。所有的field都是上面提到的基本类型

由于MyBean是一个自定义的JavaBean对象， 所以在server-config.wsdd中就必须加上<beanMapping ...../>的声明， 让axis知道怎么把request中xml数据deserialize为MyBean对象，又如何把MyBean对象serialize为xml数据作为response.用wtp自动为JavaInputService生成的wsdl中， MyBean是作为一个complexType在wsdl中定义的。

3）复杂一点的JavaBean对象。
        比如JavaBean对象中的一些field又是自定义的JavaBean,  这种情况下， wsdl中生成的complextype会有多个(webservice接口最好不用定义多层的结构)，而在wsdd定义的<beanMapping .../>也会有多个， axis1.2支持起来都是易如反掌。

4）java中的数组

在webservice中把List, Map作为service的input, output的做法都是不可行的。至少在jdk1.4的版本中是这样的。

要注意的是，数组参数在server-config.wsdd中需要配置<arrayMapping.../>

似乎List, Map的问题用数组就可以解决了。事实上就是如此。但是还得注意的是：
　　 javabean里边也不能含有List?. 如果MyBean跟其它某个对象是1：n的关系，那么也只能写成数组的形式，而不能是List的形式

例子：

<service name="StudentInfoService" provider="java:RPC">

<parameter name="className" value="com.kevinGQ.service.axis.service.GetStudentService"/>

<parameter name="allowedMethods" value="*"/>

<beanMapping qname="myNS:Student" xmlns:myNS="urn:StudentInfoService" languageSpecificType="java:com.kevinGQ.service.axis.model.Student"/>

</service>

片断中StudentInfoService是这个web service的名字，在客户端编码的时候需要用到。

<parameter name="className" value="com.kevinGQ.service.axis.service.GetStudentService"/>

中说明了这个服务提供的类，包括package的完整类名。

<parameter name="allowedMethods" value="*"/>中说明这个服务中可供给外部调用的方法有哪些，*表示全部函数，现在也可以把*改成getAStudent.

<beanMapping qname="myNS:Student" xmlns:myNS="urn:StudentInfoService" languageSpecificType="java:com.kevinGQ.service.axis.model.Student"/>中说明对于这个JavaBean的传输需要如何对它进行serializing和de-serializing，说明的目的在于绑定JavaBean的对象类别。注意标签中说明的名字空间。这个标签其实是如下标签的一个简写：

Java代码 

1         <typeMapping qname="myNs:Student" xmlns:ns="urn:StudentInfoService"

2                      languageSpecificType="java: com.kevinGQ.service.axis.model.Student "

3                      serializer="org.apache.axis.encoding.ser.BeanSerializerFactory "

4                      deserializer=" org.apache.axis.encoding.ser.BeanDeserializerFactory "

5                      encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>

特别说明：

A、 如果你调用的方法有返回值，一定要设置返回值的类型。call.setReturnClass

B、 如果你调用的方法有参数，一定要设置参数的类型call.addParameter

C、 记得添加wsdl4j.jar，序列化转换的时候需要用到，否则会出现找不到类型异常

如：

call.addParameter("i", XMLType.XSD_INT, ParameterMode.IN);
 call.setReturnClass(User[].class);