结合Axis和Ant开发Web服务

类别:Java 点击:0 评论:0 推荐:

本文结合一个简单示例讲解了怎样把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

3.http://nagoya.apache.org/wiki/apachewiki.cgi?AxisProjectPages/AxisAntTasks得到更多关于Axis-Ant任务的信息。

本文地址:http://com.8s8s.com/it/it17131.htm