先参考 Axis2创建webservice服务的方式 之 ADB 方式(一)


2.5 wsdl2java生成的文件分析


由 http://jackyin5918.iteye.com/blog/1907992 这里知道:


在使用工具创建webservice服务文件框架后,要实现webservice服务,

就要修改生成的TestAdbSkeleton.java文件.因为这个文件仅仅是一个框架

里面的业务逻辑需要自己实现.

TestAdbSkeleton.java代码如下:

package test.adb.service;

/**
*  TestAdbSkeleton java skeleton for the axisService
*/
public class TestAdbSkeleton implements TestAdbSkeletonInterface
{

  public test.adb.theinterface.GetNameResponse getName(test.adb.theinterface.GetName getName0)
  {
    // TODO : fill this with the necessary business logic
    throw new java.lang.UnsupportedOperationException("Please implement " + this.getClass().getName() + "#getName");
  }

  public void setName(test.adb.theinterface.SetName setName2)
  {
    // TODO : fill this with the necessary business logic

  }
}

?
这个java类,跟之前的接口ITestAdb很类似,
只是 函数的返回值和参数变成了类似getName ,setName这种奇怪的类型.
这些类(getName ,setName)型是在wsdl中定义的type:

?

<wsdl:types>
    <xs:schema attributeFormDefault="qualified" elementFormDefault="qualified" targetNamespace="http://theinterface.adb.test">
            <xs:element name="setName">
                <xs:complexType>
                    <xs:sequence>
                        <xs:element minOccurs="0" name="args0" nillable="true" type="xs:string"/>
                    </xs:sequence>
                </xs:complexType>
            </xs:element>
            <xs:element name="getName">
                <xs:complexType>
                    <xs:sequence/>
                </xs:complexType>
            </xs:element>
            <xs:element name="getNameResponse">
                <xs:complexType>
                    <xs:sequence>
                        <xs:element minOccurs="0" name="return" nillable="true" type="xs:string"/>
                    </xs:sequence>
                </xs:complexType>
            </xs:element>
        </xs:schema>
  </wsdl:types>

?
因为webservice基于soap接口,在做数据交换时,使用xml传递数据.这样在调用webservice服务时,

? 函数的返回值和方法参数都要变成一种特殊的格式,即,使用xml表示.

? 比如,原来接口中 setName(Sring Name)方法 的参数 被定义成一种xml元素(setName)了,

? 参数被定义为子元素 了,但是参数名称变成了arg0了,而不是原来的name(因为是自动生成的wsdl文件).

? 当函数有返回值时,还会定义一种返回值类型,比如getNameResponse.

? 在生成代码的时候,wsdl2java工具,将这些定义的类型都生成对应的Java类,比如getName,setName类型.

? 定义好这种类型后,假如客户端请求服务,比如请求setName服务,那么客户端需要传递xml格式的参数,name,

? 然后,服务器端收到xml的参数信息,并将xml信息转换成对应的setName类型的类对象,然后将这个对象传递给

? TestAdbSkeleton类的setName方法,做了相关处理后,完成客户端请求.

? 当客户端请求的操作有返回值,比如getName,服务器端完成请求后,会返回结果,就是getNameResponse类型,

? 客户端收到这个getNameResponse,在根据这个getNameResponse类型在wsdl中的定义,转换成xml格式,

? 然后获取处理结果数据.


以算 setName这个类来分析:
SetName.java代码如下(部分):

public class SetName implements org.apache.axis2.databinding.ADBBean
{

  public static final javax.xml.namespace.QName MY_QNAME          
  = new javax.xml.namespace.QName("http://theinterface.adb.test", "setName", "ns1");

  /**
  * field for Args0
  */

  protected java.lang.String                    localArgs0;

  /*
   * This tracker boolean wil be used to detect whether the user called the set method for this attribute. It will be
   * used to determine whether to include this field in the serialized XML
   */
  protected boolean                             localArgs0Tracker = false;

  public boolean isArgs0Specified()
  {
    return localArgs0Tracker;
  }

  /**
  * Auto generated getter method
  * @return java.lang.String
  */
  public java.lang.String getArgs0()
  {
    return localArgs0;
  }

  /**
     * Auto generated setter method
     * @param par