本文结合一个简单示例讲解了怎样把Axis和Ant结合起来进行Web服务的开发。帮助读者从简单的java源代码或者从一个服务描述文件（wsdl）开始，用Ant工具进行构建，设置，并把服务部署到Axis。

首先假定您熟悉 AXIS 处理系统和Ant工具。文中示例所需要的软件如下：

l         Apache Axis 1.1

l         Apache Ant 1.5.3

l         Jarkat Tomcat 4.1.24

在开始前，假定上述软件已经安装和配置好了。

Axis和Ant简介

Axis 框架是来自 Apache Group 的、基于 java 的、最新的 SOAP 规范（SOAP 1.2）和 SOAP with Attachments 规范（来自 Apache Group ）的开放源代码实现。其本质上是一个SOAP引擎－－一个构建诸如客户端、服务器、网关等SOAP处理器的框架。是Apache SOAP的后继项目。但是，Axis使用SAX（基于事件）解析器获得了比Apache SOAP早期版本(使用DOM解析)非常明显的速度优势。另外，它还具有很强的灵活性和稳定性，支持Web服务描述语言1.1版。

Apache Ant是Apache软件基金会jakarta项目中的一个子项目，是一个基于Java的构建工具，类似于make，但它没有make那么复杂繁琐。Ant由一些内置任务（task）和可选择的任务组成，还可以配置第三方提供的任务。它的构建配置文件基于XML的，所以容易书写和维护，而且结构清晰。Ant还可以集成到一些开发环境中（例如visual age,jbuilder,Elipse)。

Axis对Ant的支持

Axis为支持Ant构建，提供了一个axis-ant.jar文件。该文件包含三个可选任务(task)的定义和实现：axis-wsdl2java，axis-java2wsdl和axis-admin。任务axis-wsdl2java与Axis提供的工具WSDL2Java具有同样的功能，根据web服务描述文件生成对应的Java源程序，它的属性设置与WSDL2Java的命令参数设置类似。而任务axis-java2wsdl则相反，它与Java2WSDL工具一样，是根据已有的类文件来生成Web服务描述文件。最后一个任务axis-admin是用于web服务的部署和取消部署的，对应于Axis的AminClient工具。

为了使Ant能够正确使用上述三个任务（task），还需要做一些配置。注意：Apache Ant的版本必须是1.5.1或更高版本。

1．设置系统的环境变量CLASSPATH包含Axis提供的axis-ant.jar文件，或者在Ant的配置文件（通常是build.xml）中设置路径包含它。例如，

    <path id="axis.classpath">

      <fileset dir="${axis.home}/lib">

               <include name="**/*.jar" />

      </fileset>

    </path>

2．然后使用<taskdef>声明导入axis-ant.jar文件中的属性文件所定义的任务（task）列表。

    <taskdef resource="axis-tasks.properties"

  classpathref="axis.classpath" />

     3．设置在构建过程中可能要需要的java包，例如，Axis所有的jar包，wsdl4j.jar，junit.jar等等。

实例开发

下面就用一个实例来讲解怎样把Ant和Axis结合来开发Web服务。为了注重本文的目的，我们开发一个比较简单的Web服务，它接受客户端传入的字符串数组，如果传入的参数为null，则抛出一个自定义的异常，否则把每个字符串连接起来返回给客户端。

首先定义一个Web服务接口Hello，如下所示：

  package com.bidlink.hello;

  public interface Hello{

     public String echo(String[] content ) throws                       

               java.rmi.RemoteException,com.bidlink.hello.MyException;

  }

  自定义异常MyException包含一个时间值，以记录异常出现的时间，如下：

  package com.bidlink.hello;

public class MyException extends org.apache.axis.AxisFault implements java.io.Serializable{

    private java.util.Calendar occurTime;

    public MyException() {

    }

    public MyException(

           java.util.Calendar occurTime) {

        super();

        this.occurTime = occurTime;

    }

    public java.util.Calendar getOccurTime() {

        return occurTime;

    }

    public void setOccurTime(java.util.Calendar occurTime) {

        this.occurTime = occurTime;

    }           

}

1．axis-java2wsdl：从类文件生成服务描述文件

编译上面定义的两个文件Hell.java和MyException.java。接着编写Ant的配置文件build.xml（文件详细信息请查看示例源代码），使用axis-java2wsdl任务根据类Hello来生成Web服务描述文件hello.wsdl。任务具体配置如下：

    <axis-java2wsdl classname="com.bidlink.hello.Hello"

                        location="http://localhost:8080/axis/services/Hello"

                        namespace="http://hello.bidlink.com"

                        output="hello.wsdl"

                        style="RPC"

                        extraclasses="com.bidlink.hello.MyException">

         <classpath>

             <pathelement path="${dist}"/>

         </classpath>

        </axis-java2wsdl>

其中，<pathelement path="${dist}"/>指出Hello.class和MyException.class文件的位置。

运行命令ant java2wsdl，构建出Web服务描述文件hello.wsdl。

2．axis-wsdkl2java：从服务描述文件生成服务源程序

下面讲解怎样根据刚刚得到的hello.wsdl文件生成服务所需要的java源程序。在这里需要用到任务axis-wsdl2java。任务属性设置如下：

     <axis-wsdl2java all="true"

                     url="hello.wsdl"

                     deployscope="Request"

                     output="${gensrc}"

                     serverside="true"

                     skeletondeploy="false"

                     testcase="true"

                     noimports="false"

                     typemappingversion="1.2">

        </axis-wsdl2java>

      运行ant wsdl2java，根据axis-wsdl2java任务的属性配置生成相应的java源程序，本例所生成的文件包括：服务端服务接口文件Hello.java及其实现HelloSoapBindingImpl.java，以及客户端的HelloService.java，HelloServiceLocator.java，HelloServiceLocator.java和客户端存根文件HelloSoapBindingStub.java。又因为属性testcase="true"，所以还生成了测试文件HelloServiceTestCase.java。当然，自定义异常MyException也是重新生成的。

3．axis-admin：向Axis部署Hello服务

服务源程序生成后，需要根据服务的功能修改HelloSoapBindingImpl.java文件，以真正实现该Web服务。修改如下：

  /**

 * HelloSoapBindingImpl.java

 *

 * This file was auto-generated from WSDL

 * by the Apache Axis WSDL2Java emitter.

 */

package com.bidlink.hello;

public class HelloSoapBindingImpl implements com.bidlink.hello.Hello{

    public java.lang.String echo(java.lang.String[] in0) throws java.rmi.RemoteException, com.bidlink.hello.MyException {

        if(in0 == null)

           throw new MyException(java.util.Calendar.getInstance());

        String retStr = "";

        for(int i=0; i< in0.length; i++)

           retStr += in0[i];

        return retStr;

    }

}

编译所有的生成的源程序，最后使用axis-admin任务向Axis部署Hello Web服务。

    <axis-admin

           port="${target.port}"

               hostname="${target.server}"

            failonerror="true"

            servletpath="${target.appname}/services/AdminService"

            debug="true"

            xmlfile="deploy.wsdd"/>

       运行ant deploy，部署Hello服务。

    测试

现在可以测试所部署的Web服务hello。可以通过浏览器，也可以利用刚才生成的测试文件HelloServiceTestCase.java来进行该项工作。如果利用测试文件HelloServiceTestCase.java，那么还需要对它进行稍作修改。具体来说，就是添加一个main函数，然后修改所生成的测试方法。

参考资料

1．阅读Apache Axis开发指导文档

2．查看Apache Ant文档手册http://ant.apache.org/manual/index.html

    下面是配置和使用soapmonitor模块的步骤：   

第1步：部署Applet和Servlet

    由于axis2默认情况下已经自带了soapmonitor模块，因此，soapmonitor模块并不需要单独安装。但applet所涉及到的相应的.class文件需要安装一下。在<Tomcat安装目录>\webapps\axis2\WEB-INF\lib目录中找到soapmonitor-1.4.1.jar文件，将该文件解压。虽然applet并不需要soapmonitor-1.4.1.jar文件中所有的.class文件，但为了方便，读者也可以直接将解压目录中的org目录复制到<Tomcat安装目录>\webapps\axis2目录中，Applet所需的.class文件需要放在这个目录。然后再将org目录复制到<Tomcat安装目录>\webapps\axis2\WEB-INF\classes目录中，soapmonitor模块中的Servlet所对应的.class文件需要放在这个目录。

第2步：配置Servlet

    打开<Tomcat安装目录>\webapps\axis2\WEB-INF\web.xml文件，在其中加入如下的内容：

第3步：在services.xml文件中引用soapmonitor模块

    由于soapmonitor模块已经在axis2.xml进行配置了，因此，在本例中不需要再对axis2.xml文件进行配置了。   

第4步：使用soapmonitor模块

    在浏览器中将出现soapmonitor所带的Applet的界面，当访问MyService的getGreeting方法时，在Tomcat控制台与Applet中都显示了相应的SOAP请求和响应消息。如图1和图2分别是调用了两次getGreeting方法后输出的SOAP请求和响应消息。

图1

图2

    如果读者想让logging和soapmonitor模块监视部署在Axis2中的所有WebService，可以在axis2.xml文件中使用<module>元素来引用这两个模块，代码如下：

package service;
public class MyService
{
    public String getName()
    {
        try
        {            
            System.out.println("getName方法正在执行");
            //  延迟5秒
            Thread.sleep(5000);
        }
        catch (Exception e)
        {        
        }
        return "火星";
    }
}

    为了模拟需要一定时间才返回的WebService方法，在getName方法中使用了sleep方法来延迟5秒。
    下面是MyService类的配置代码：

    从上面的配置代码可以看出，MyService的配置方式与前几章的WebService的配置方式完全一样，也就是说，MyService只是一个普通的WebService。
    下面是异步调用MyService的Java客户端代码：

    从上面的代码可以看出，invokeNonBlocking方法有三个参数，前两个参数分别指定了要调用的方法及方法参数的相关信息，而最后一个参数并不是方法返回值的类型信息，而是一个实现org.apache.axis2.client.async.AxisCallback接口的类的对象实例。在本例中隐式实现了AxisCallback接口。在AxisCallback接口中有四个方法需要实现，其中当被异步调用的方法返回时onMessage方法被调用。当运行上面的程序后，将输出如下的信息：

    虽然上面的例子可以实现异步调用，但比较麻烦。为了更方便地实现异步调用，可以使用wsdl2java命令的-a参数生成可异步调用的Stub类。下面的命令可生成同步和异步调用的客户端代码（两个类），其中-s表示生成同步调用代码，-a表示生成异步调用代码。

    在执行上面的命令后，将生成两个类：MyServiceStub和MyServiceCallbackHandler类，其中MyServiceStub类负责同步和异步调用WebService，MyServiceCallbackHandler类是一个抽象类，也是一个回调类，当使用异步方式调用WebService方法时，如果方法返回，则MyServiceCallbackHandler类的receiveResultgetName方法被调用。下面是使用MyServiceStub类异步访问WebService的代码：

   执行上面的程序后，将输出如下的信息：   

    其中async是引用MyService的服务名。要注意的是，在C#中不能在同一个WebService实例的getName方法未返回之前，再次调用该实例的getName方法，否则将抛出异常。如下面的代码会抛出一个异常：

    但不同的WebService实例的方法可以在方法未返回时调用，如下面的代码是可以正常工作的：

1. 编写实现Module接口的类。Axis2模块在进行初始化、销毁等动作时会调用该类中相应的方法）。

2. 编写实现Handler接口的类。该类是Axis2模块的业务处理类。

3. 编写module.xml文件。该文件放在META-INF目录中，用于配置Axis2模块。

4. 在axis2.xml文件中配置Axis2模块。

5. 在services.xml文件中配置Axis2模块。每一个Axis2模块都需要使用<module>元素引用才能使用。

6. 发布Axis2模块。需要使用jar命令将Axis2模块压缩成.mar包（文件扩展名必须是.mar），然后将.mar文件放在

<Tomcat安装目录>\webapps\axis2\WEB-INF\modules目录中。   
    先来编写一个WebService类，代码如下：

    下面我们来编写一个记录请求和响应SOAP消息的Axis2模块。当客户端调用WebService方法时，该Axis2模块会将请求和响应SOAP消息输出到Tomcat控制台上。

第1步：编写LoggingModule类

    LoggingModule类实现了Module接口，代码如下：

    在本例中LoggingModule类并没实现实际的功能，但该类必须存在。当Tomcat启动时会装载该Axis2模块，同时会调用LoggingModule类的init方法，并在Tomcat控制台中输出“init”。

第2步：编写LogHandler类

    LogHandler类实现了Handler接口，代码如下：

    LogHandler类的核心方法是invoke，当使用该Axis2模块的WebService的方法被调用时，LogHandler类的invoke方法被调用。   

第3步：编写module.xml文件   

第4步：在axis2.xml文件中配置Axis2模块

    打开axis2.xml文件，分别在如下四个<phaseOrder>元素中加入<phase name="loggingPhase"/>：

<phaseOrder type="InFlow">
     
    <phase name="soapmonitorPhase"/>
    <phase name="loggingPhase"/>
</phaseOrder>
<phaseOrder type="OutFlow">
     
    <phase name="Security"/>
    <phase name="loggingPhase"/>
</phaseOrder>
<phaseOrder type="InFaultFlow">
     
    <phase name="soapmonitorPhase"/>
    <phase name="loggingPhase"/>
</phaseOrder>
<phaseOrder type="OutFaultFlow">
     
    <phase name="Security"/>
    <phase name="loggingPhase"/>
</phaseOrder>

第5步：在services.xml文件中引用logging模块

    services.xml文件的内容如下：

第6步：发布logging模块

    到现在为止，我们应用可以建立两个发行包：logging.mar和service.aar。其中logging.mar文件是Axis2模块的发行包，该包的目录结构如下：

logging.mar

    module\LoggingModule.class

    module\LogHandler.class

    META-INF\module.xml

    service.aar文件是本例编写的WebService发行包，该包的目录结构如下：

service.aar

    service\MyService.class

    META-INF\services.xml

    将logging.mar文件放在<Tomcat安装目录>\webapps\axis2\WEB-INF\modules目录中，将service.aar文件放在<Tomcat安装目录>\webapps\axis2\WEB-INF\services目录中。要注意的是，如果modules目录中包含了modules.list文件，Axis2会只装载在该文件中引用的Axis2模块，因此，必须在该文件中引用logging模块，该文件的内容如下：

addressing-1.4.1.mar

soapmonitor-1.4.1.mar

ping-1.4.1.mar

mex-1.4.1.mar

axis2-scripting-1.4.1.mar

logging.mar

    如果modules目录中不包含modules.list文件，则Axis2会装载modules文件中的所有Axis2模块。

    现在启动Tomcat，使用如下的C#代码调用MyService的getGreeting方法则会在Tomcat控制台中输出相应的请求和响应SOAP消息。

    在执行上面的代码后，在Tomcat控制台中输出的信息如下图所示。

    其中Person也是一个JavaBean，代码如下：

    将上面两个Java源文件编译后，放到<Tomcat安装目录>\webapps\axis2\WEB-INF\classes目录中。

    在<Tomcat安装目录>\webapps\axis2\WEB-INF\web.xml文件中加入下面的内容：

    在<Tomcat安装目录>\webapps\axis2\WEB-INF目录中建立一个applicationContext.xml文件，该文件是Spring框架用于装配JavaBean的配置文件，内容如下：

    在applicationContext.xml文件中装配了service.SpringService类，并被始化了name和job属性。在配置完SpringService类后，就可以直接在程序中FileSystemXmlApplicationContext类或其他类似功能的类读取applicationContext.xml文件中的内容，并获得SpringService类的对象实例。但现在我们并不这样做，而是将SpringService类发布成WebService。

    在<Tomcat安装目录>\webapps\axis2\WEB-INF\lib目录中有一个axis2-spring-1.4.1.jar文件，该文件用于将被装配JavaBean的发布成WebService。在D盘建立一个axi2-spring-ws目录，并在该目录中建立一个META-INF子目录。在META-INF目录中建立一个services.xml文件，内容如下：

    在Windows控制台进入axi2-spring-ws目录，并使用jar命令将axi2-spring-ws目录中的内容打包成axi2-spring-ws.aar，然后将该文件复制到<Tomcat安装目录>\webapps\axis2\WEB-INF\services目录中，启动Tomcat后，就可以访问该WebService了，访问方式与前面几篇文章的访问方式相同。获得wsdl内容的URL如下：

http://localhost:8080/axis2/services/springService?wsdl

    在将Spring中的装配JavaBean发布成WebService需要注意以下几点：

    1. 由JavaBean编译生成的.class文件需要放在WEB-INF\classes目录中，或打成.jar包后放在WEB-INF\lib目录中，而WEB-INF\services目录中的.aar包中不需要包含.class文件，而只需要包含一个META-INF目录，并在该目录中包含一个services.xml文件即可。

    2. services.xml的配置方法与前几篇文章的配置方法类似，只是并不需要使用ServiceClass参数指定要发布成WebService的Java类，而是要指定在applicationContext.xml文件中的装配JavaBean的名称（SpringBeanName参数）。

    3. 在services.xml文件中需要通过ServiceObjectSupplier参数指定SpringServletContextObjectSupplier类来获得Spring的ApplicationContext对象。

读者可以想象，这对于一个完整的应用程序，无法保留状态，就意味着只依靠WebService很难完成全部的工作。例如，一个完整的应用系统都需要进行登录，这在Web应用中使用Session来保存用户登录状态，而如果用WebService的方法来进行登录处理，无法保存登录状态是非常令人尴尬的。当然，这也可以通过其他的方法来解决，如在服务端使用static变量来保存用户状态，并发送一个id到客户端，通过在服务端和客户端传递这个id来取得相应的用户状态。这非常类似于Web应用中通过Session和Cookie来管理用户状态。但这就需要由开发人员做很多工作，不过幸好Axis2为我们提供了WebService状态管理的功能。

使用Axis2来管理WebService的状态基本上对于开发人员是透明的。在WebService类需要使用org.apache.axis2.context.MessageContext和org.apache.axis2.context.ServiceContext类来保存与获得保存在服务端的状态信息，这有些象使用HttpSession接口的getAttribute和setAttribute方法获得与设置Session域属性。

除此之外，还需要修改services.xml文件的内容，为<service>元素加一个scope属性，该属性有四个可取的值：Application, SOAPSession, TransportSession, Request，不过要注意一下，虽然Axis2的官方文档将这四个值的单词首字母和缩写字母都写成了大写，但经笔者测试，必须全部小写才有效，也就是这四个值应为：application、soapsession、transportsession、request，其中request为scope属性的默认值。读者可以选择使用transportsession和application分别实现同一个WebService类和跨WebService类的会话管理。

在客户端需要使用setManageSession(true)打开Session管理功能。

综上所述，实现同一个WebService的Session管理需要如下三步：

1. 使用MessageContext和ServiceContext获得与设置key-value对。

2. 为要进行Session管理的WebService类所对应的<service>元素添加一个scope属性，并将该属性值设为transportsession。

3. 在客户端使用setManageSession(true)打开Session管理功能。

下面是一个在同一个WebService类中管理Session的例子。

先建立一个WebService类，代码如下：

在LoginService类中有两个方法：login和getLoginMsg，如果login方法登录成功，会将“成功登录”字符串保存在ServiceContext对象中。如果在login方法返回true后调用getLoginMsg方法，就会返回“成功登录”。

下面是LoginService类的配置代码（services.xml）：

使用如下的命令生成客户端使用的stub类：

在stub\src\client目录中生成了一个LoginServiceStub.java类，在该类中找到如下的构造句方法：

public  LoginServiceStub(org.apache.axis2.context.ConfigurationContext configurationContext,
        java.lang.String targetEndpoint,  boolean  useSeparateListener)
         throws  org.apache.axis2.AxisFault 
{
     
    _serviceClient.getOptions().setSoapVersionURI(
                                 org.apache.axiom.soap.SOAP12Constants.SOAP_ENVELOPE_NAMESPACE_URI);
}

下面的客户端代码使用LoginServiceStub对象访问了刚才建立的WebService：

运行上面的代码后，会输出“成功登录”信息。

实现跨服务的Session管理需要如下三步：

1. 使用MessageContext和ServiceGroupContext获得与设置key-value对。

2. 为要进行Session管理的WebService类所对应的<service>元素添加一个scope属性，并将该属性值设为application。

3. 在客户端使用setManageSession(true)打开Session管理功能。

从上面的步骤可以看出，实现跨服务会话管理与实现同一个服务的会话管理在前两步上存在着差异，而第3步是完全一样的。下面是一个跨服务的会话管理的实例。在这个例子中有两个WebService类：LoginService和SearchService，代码如下：

LoginService.java

SearchService.java

services.xml文件中的配置代码如下：

第3步与《WebService大讲堂之Axis2(5)：会话（Session）管理》一文中介绍的方法类似。

下面是使用两个stub类的对象实例访问上面实现的两个WebService的客户端代码：

在执行上面的代码后，将输出如下的信息：

读者可以将scope属性值改成transportsession，看看会输出什么！

    实际上，Axis2的会话管理也是通过Cookie实现的，与Web应用中的Session管理类似。如果读者使用C#访问支持会话（在同一个服务中的会话管理）的WebService，需要指定一个CookieContainer对象，代码如下：

如果读者使用delphi（本文使用的是delphi2009，其他的delphi版本请读者自行测试）调用支持会话的WebService时有一些差别。经笔者测试，使用delphi调用WebService，将scope属性值设为transportsession和application都可以实现跨服务的会话管理，这一点和Java与C#不同，Java和C#必须将scope属性值设为application才支持跨服务会话管理。在delphi中不需要象C#指定一个CookieContainer或其他类似的对象，而只需要象访问普通的WebService一样访问支持会话的WebService即可。

上面代码在services.xml文件的配置代码如下：

    如果使用wsdl2java命令生成调用Java客户端代码，则需要创建DataHandler类的对象实例，代码如下：

wsdl2java命令会为每一个方法生成一个封装方法参数的类，类名为方法名（第一个字符大写），如uploadWithByte方法生成的类名为UploadWithByte。如果要设置file参数的值，可以使用UploadWithByte类的setFile方法，代码如下：

最后是调用uploadWithByte方法，代码如下（FileServiceStub为wsdl2java生成的stub类名）：

如果使用C#调用FileService，则file参数类型均为byte[]，代码如下：

其中picUpdateImage为c#中加载图像文件的picturebox控件。

String[] strArray = new String[]{ "自行车,飞机,火箭","中国,美国,德国", "超人,蜘蛛侠,钢铁侠" } ;

    上面的代码可以看作是一个3*3的二维数组。

    在传递类的对象实例时，除了直接将数组类型声明成相应的类或接口，也可以将对象实例进行序列化，也就是说，将一个对象实例转换成字节数组进行传递，然后接收方再进行反序列化，还原这个对象实例。

    下面的示例代码演示了如何传递数组与类（接口）类型的数据，并演示如何使用字节数组上传图像。本示例的客户端代码使用Java和C#编写。要完成这个例子需要如下几步：

一、实现服务端代码

    ComplexTypeService是一个WebService类，该类的代码如下：

二、实现DataForm类

    DataForm是要返回的对象实例所对应的类，该类的实现代码如下：

三、发布WebService

    由于本示例的WebService类使用了一个Java类（DataForm类），因此，在发布WebService之前，需要先将DataForm.class文件复制到<Tomcat安装目录>\webapps\axis2\WEB-INF\classes\data目录中，然后将ComplexTypeService.class文件复制到<Tomcat安装目录>\webapps\axis2\WEB-INF\pojo目录中，最后启动Tomcat（如果Tomcat已经启动，由于增加了一个DataForm类，因此，需要重新启动Tomcat）。

四、使用Java编写调用WebService的客户端代码

    在客户端仍然使用了RPC的调用方式，代码如下：

    运行上面的程序，将输出如下的内容：

五、使用C#编写调用WebService的客户端代码

    在Visual Studio中使用WebService就简单得多。假设引用WebService时的引用名为complexType，则下面的代码调用了uploadImageWithByte方法来上传图像文件。在Visual Studio引用WebService时，uploadImageWithByte方法多了两个out参数，在使用时要注意。

    在获得二维数组时，可以将数据加载到DataGridView或其他类似的控件中，代码如下：

    向DataGridView控件添加数据后的效果如图1所示。

图1 

    对于其他的WebService方法的调用都非常简单，读者可以自己做这个实验。

    要注意的是，由于.net和java序列化和反序列化的差异，通过序列化的方式传递对象实例只使用于客户端与服务端为同一种语言或技术的情况，如客户端和服务端都使用Java来编写。

这个类有两个方法，这两个方法都需要发布成Web Service方法。这种方式和直接放在pojo目录中的POJO类不同。要想将MyService类发布成Web Service，需要一个services.xml文件，这个文件需要放在META-INF目录中，该文件的内容如下：

其中<service>元素用于发布Web Service，一个<service>元素只能发布一个WebService类，name属性表示WebService名，如下面的URL可以获得这个WebService的WSDL内容：

其中name属性名就是上面URL中"?"和"/"之间的部分。

<description>元素表示当前Web Service的描述，<parameter>元素用于设置WebService的参数，在这里用于设置WebService对应的类名。在这里最值得注意的是<messageReceivers>元素，该元素用于设置处理WebService方法的处理器。例如，getGreeting方法有一个返回值，因此，需要使用可处理输入输出的RPCMessageReceiver类，而update方法没有返回值，因此，需要使用只能处理输入的RPCInOnlyMessageReceiver类。

使用这种方式发布WebService，必须打包成.aar文件，..aar文件实际上就是改变了扩展名的.jar文件。在现在建立了两个文件：MyService.java和services.xml。将MyService.java编译，生成MyService.class。services.xml和MyService.class文件的位置如下：

D:\ws\service\MyService.class

D:\ws\META-INF\services.xml

    在windows控制台中进入ws目录，并输入如下的命令生成.aar文件（实际上，.jar文件也可以发布webservice，但axis2官方文档中建议使用.aar文件发布webservice）：

jar cvf ws.aar .

    最后将ws.aar文件复制到<Tomcat安装目录>\webapps\axis2\WEB-INF\services目录中，启动Tomcat后，就可以调用这个WebService了。调用的方法和《WebService大讲堂之Axis2（1）：用POJO实现0配置的WebService》所讲的方法类似。

另外services.xml文件中也可以直接指定WebService类的方法，如可以用下面的配置代码来发布WebService：

上面的配置代码前面的部分和以前的services.xml文件的内容相同，但后面使用了<operation>元素来指定每一个WebService方法，并单独指定了处理每一个方法的处理器。对于客户端来说，调用使用这两个services.xml文件发布的WebService并没有太大我区别，只是使用第二个services.xml文件发布WebServices后，在使用wsdl2java命令或使用C#、delphi等生成客户端的stub时，update方法的String类型被封装在了update类中，在传递update方法的参数时需要建立update类的对象实例。而使用第一个services.xml文件发布的WebService在生成stub时直接可以为update方法传递String类型的参数。从这一点可以看出，这两种方法生成的WSDL有一定的区别。但实际上，如果客户端程序使用第一个services.xml文件发布的WebService生成stub类时（这时update方法的参数是String），在服务端又改为第二个services.xml文件来发布WebService，这时客户端并不需要再重新生成stub类，而可以直接调用update方法。也就是说，服务端使用什么样的方式发布WebService，对客户端并没有影响。

如果想发布多个WebService，可以使用<serviceGroup>元素，如再建立一个MyService1类，代码如下：

在services.xml文件中可以使用如下的配置代码来配置MyService和MyService1类：

一、Axis2的下载和安装

    读者可以从如下的网址下载Axis2的最新版本：

    http://ws.apache.org/axis2/

    在本文使用了目前Axis2的最新版本1.4.1。读者可以下载如下两个zip包：

    axis2-1.4.1-bin.zip

    axis2-1.4.1-war.zip

    其中axis2-1.4.1-bin.zip文件中包含了Axis2中所有的jar文件, axis2-1.4.1-war.zip文件用于将WebService发布到Web容器中。

    将axis2-1.4.1-war.zip文件解压到相应的目录，将目录中的axis2.war文件放到<Tomcat安装目录>\webapps目录中（本文使用的Tomcat的版本是6.x），并启动Tomcat。

    在浏览器地址栏中输入如下的URL：

    http://localhost:8080/axis2/

    如果在浏览器中显示出如图1所示的页面，则表示Axis2安装成功。

图1

  对于用Java实现的服务程序给人的印象就是需要进行大量的配置，不过这一点在Axis2中将被终结。在Axis2中不需要进行任何的配置，就可以直接将一个简单的POJO发布成WebService。其中POJO中所有的public方法将被发布成WebService方法。

    下面我们来实现一个简单的POJO，代码如下：

    在SimpleService类中有两个方法，由于这两个方法都是public方法，因此，它们都将作为WebService方法被发布。

    编译SimpleService类后，将SimpleService.class文件放到<Tomcat安装目录>\webapps\axis2\WEB-INF\pojo目录中（如果没有pojo目录，则建立该目录）。现在我们已经成功将SimpleService类发布成了WebService。在浏览器地址栏中输入如下的URL：

http://localhost:8080/axis2/services/listServices

    这时当前页面将显示所有在Axis2中发布的WebService，如图2所示。

图2

http://localhost:8080/axis2/services/SimpleService/getGreeting?name=bill

http://localhost:8080/axis2/services/SimpleService/getPrice

    图3和图4分别显示了getGreeting和getPrice方法的测试结果。

图3  getGreeting方法的测试结果

图4  getPrice方法的测试结果

    在编写、发布和测试0配置的WebService时应注意如下几点：

    1. POJO类不能使用package关键字声明包。

    2. Axis2在默认情况下可以热发布WebService，也就是说，将WebService的.class文件复制到pojo目录中时，Tomcat不需要重新启动就可以自动发布WebService。如果想取消Axis2的热发布功能，可以打开<Tomcat安装目录>\webapps\axis2\WEB-INF\conf\axis2.xml，找到如下的配置代码：

    将true改为false即可。要注意的是，Axis2在默认情况下虽然是热发布，但并不是热更新，也就是说，一旦成功发布了WebService，再想更新该WebService，就必须重启Tomcat。这对于开发人员调试WebService非常不方便，因此，在开发WebService时，可以将Axis2设为热更新。在axis2.xml文件中找到<parameter name="hotupdate">false</parameter>，将false改为true即可。

    3. 在浏览器中测试WebService时，如果WebService方法有参数，需要使用URL的请求参数来指定该WebService方法参数的值，请求参数名与方法参数名要一致，例如，要测试getGreeting方法，请求参数名应为name，如上面的URL所示。

    4. 发布WebService的pojo目录只是默认的，如果读者想在其他的目录发布WebService，可以打开axis2.xml文件，并在<axisconfig>元素中添加如下的子元素：

    上面的配置允许在<Tomcat安装目录>\webapps\axis2\WEB-INF\my目录中发布WebService。例如，将本例中的SimpleService.class复制到my目录中也可以成功发布（但要删除pojo目录中的SimpleService.class，否则WebService会重名）。

三、用Java实现调用WebService的客户端程序

    WebService是为程序服务的，只在浏览器中访问WebService是没有意义的。因此，在本节使用Java实现了一个控制台程序来调用上一节发布的WebService。调用WebService的客户端代码如下：

    在编写客户端代码时应注意如下几点：

    1. 客户端代码需要引用很多Axis2的jar包，如果读者不太清楚要引用哪个jar包，可以在Eclipse的工程中引用Axis2发行包的lib目录中的所有jar包。

    2. 在本例中使用了RPCServiceClient类的invokeBlocking方法调用了WebService中的方法。invokeBlocking方法有三个参数，其中第一个参数的类型是QName对象，表示要调用的方法名；第二个参数表示要调用的WebService方法的参数值，参数类型为Object[]；第三个参数表示WebService方法的返回值类型的Class对象，参数类型为Class[]。当方法没有参数时，invokeBlocking方法的第二个参数值不能是null，而要使用new Object[]{}。

    3. 如果被调用的WebService方法没有返回值，应使用RPCServiceClient类的invokeRobust方法，该方法只有两个参数，它们的含义与invokeBlocking方法的前两个参数的含义相同。

    4. 在创建QName对象时，QName类的构造方法的第一个参数表示WSDL文件的命名空间名，也就是<wsdl:definitions>元素的targetNamespace属性值，下面是SimpleService类生成的WSDL文件的代码片段：

<?xml version="1.0" encoding="UTF-8"?>
<wsdl:definitions xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:ns1="http://org.apache.axis2/xsd"
xmlns:ns="http://ws.apache.org/axis2" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"
xmlns:http="http://schemas.xmlsoap.org/wsdl/http/" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/"
targetNamespace="http://ws.apache.org/axis2">
    <wsdl:types>
         
    </wsdl:types>
     
</wsdl:definitions>

四、用wsdl2java简化客户端的编写

    也许有很多读者会说“有没有搞错啊，只调用两个WebService方法用要写这么多代码，太麻烦了”。

    不过幸好Axis2提供了一个wsdl2java.bat命令可以根据WSDL文件自动产生调用WebService的代码。wsdl2java.bat命令可以在<Axis2安装目录>"bin目录中找到。在使用wsdl2java.bat命令之前需要设置AXIS2_HOME环境变量，该变量值是<Axis2安装目录>。

    在Windows控制台输出如下的命令行来生成调用WebService的代码：

%AXIS2_HOME%\bin\wsdl2java -uri http://localhost:8080/axis2/services/SimpleService?wsdl -p client -s -o stub

    其中-url参数指定了wsdl文件的路径，可以是本地路径，也可以是网络路径。-p参数指定了生成的Java类的包名，-o参数指定了生成的一系列文件保存的根目录。在执行完上面的命令后，读者就会发现在当前目录下多了个stub目录，在."stub"src"client目录可以找到一个SimpleServiceStub.java文件，该文件复杂调用WebService，读者可以在程序中直接使用这个类，代码如下：

    上面的代码大大简化了调用WebService的步骤，并使代码更加简洁。但要注意的是，wsdl2java.bat命令生成的Stub类将WebService方法的参数都封装在了相应的类中，类名为方法名，例如，getGreeting方法的参数都封装在了GetGreeting类中，要想调用getGreeting方法，必须先创建GetGreeting类的对象实例。

五、使用C#调用WebService

    从理论上说，WebService可以被任何支持SOAP协议的语言调用。在Visual Studio中使用C#调用WebService是在所有语言中最容易实现的（VB.net的调用方法类似，也同样很简单）。

    新建一个Visual Studio工程，并在引用Web服务的对话框中输入如下的URL，并输入Web引用名为“WebService”：

    http://localhost:8080/axis2/services/SimpleService?wsdl

    然后引用Web服务的对话框就会显示该WebService中的所有的方法，如图5所示。

图5

    在完成上面的工作后，只需要如下三行C#代码就可以调用getGreeting和getPrice方法，并显示这两个方法的返回值：

    在.net解析WSDL文件时直接将getGreeting方法的参数映射为String类型，因此，可以直接进行传值。
    从上面的调用过程可以看出，添加Web引用的过程就相当于在Java中调用wsdl2java.bat自动生成stub类的过程。只是在调用stub类时与C#有一定的区别，但从总体上来说，都大大简化了调用WebService的过程。

The WebServiceWrapperComponent class allows you to send the result of a web service call to another endpoint. The web service call is performed within WebServiceWrapperComponent, providing the following advantages:

• You can set any type of router on inbound and outbound.
• Unlike the chaining router, it can send more than one HTTP request at a time
• The URL for the web service call can be changed at run-time by sending the URL with the message

Configuring the Web Service Wrapper

To use the web service wrapper, you specify the <wrapper-component> configuration element. The following table describes the attributes you can set for this element. These attributes are described in more detail in the examples that follow.

The web service wrapper is generic and can be used with any type of web service stack supported by Mule, including Axis and CXF. The examples below show synchronous use cases, but the web service wrapper can also support an asynchronous use case like the loan broker example.

Example Configuration Using the CXF Transport

Consider the following example. The web service wrapper is configured as a Mule component, accepting messages from a VM endpoint. A call must be made to a web service on the URL cxf:http://localhost:65081/services/TestUMO?method=onReceive and the result must be sent to the outbound endpoint vm://testout.

The inbound and outbound endpoints are configured in the usual way. The address is set as an attribute on the component, specifying the web service URL that you want to call.

								<cxf:connector name="cxf" defaultFrontend="simple" />
								<model name="Sample">
								<service name="WebServiceSample">
								<inbound>
								<vm:inbound-endpoint path="testin" />
								</inbound>
								<cxf:wrapper-component address="http://localhost:65081/services/TestUMO?method=onReceive"/>
								<outbound>
								<pass-through-router>
								<outbound-endpoint address="vm://testout"/>
								</pass-through-router>
								</outbound>
								</service>
						

Example Configuration Using the addressFromMessage Property

The "address" property is ideal to use when the web service URL for the web service is known at configuration time. However, if this URL is either not known or else needs to be changed at run-time, the "address" property can be omitted and the "adddressFromMessage" property can be set to true. The following example shows this configuration:

								<service name = "WebServiceSample2">
								<inbound>
								<vm:inbound-endpoint path = "testin2"/>
								</inbound>
								<cxf:wrapper-component addressFromMessage = "true"/>
								</service>
						

The URL must be set on the message with the property name "ws.service.url".

Configuring SOAP Methods

CXF endpoints are fairly easy to configure, whereas Axis needs some further configuration to set SOAP methods. You can set a SOAP method using the <soap-method> element as shown below:

								<service name = "WebServiceSample3">
								<inbound>
								<vm:inbound-endpoint path = "queue.in" connector-ref = "VMQueue"/>
								</inbound>
								<axis:wrapper-component address = "http://localhost:62088/axis/Calculator?method=add" style = "WRAPPED" use = "LITERAL">
								<axis:soap-method method = "qname{add:http://muleumo.org/Calc}">
								<axis:soap-parameter parameter = "Number1" type = "int" mode = "IN"/>
								<axis:soap-parameter parameter = "Number2" type = "int" mode = "IN"/>
								<axis:soap-return type = "int"/>
								</axis:soap-method>
								</axis:wrapper-component>
								<outbound>
								<pass-through-router>
								<vm:outbound-endpoint path = "queue.out" connector-ref = "VMQueue"/>
								</pass-through-router>
								</outbound>
								</service>