在项目中集成Axis 1.x来开发Web Service

在项目中集成Axis 1.x来开发Web Service

文章来源：http://chenjumin.iteye.com/blog/240206

关键字: axis, web service
   本文以Axis 1.1版本为例，详细介绍如何在项目中集成Axis来开发Web Service。Axis 1.1只能在以下环境中运行：
          Tomcat 5.0.x及之前的版本
          JKD 1.4.x及之前的版本

    一、环境的搭建
        1、安装axis-1_1：拷贝axis-1_1到任意一个目录下即完成安装，如D:\axis-1_1。
        2、设置环境变量：
             AXIS_HOME：D:\axis-1_1
             AXIS_LIB：%AXIS_HOME%\lib
             AXISCLASSPATH：%AXIS_LIB%\axis.jar;%AXIS_LIB%\axis-ant.jar;%AXIS_LIB%\commons-discovery.jar;%AXIS_LIB%\commons-logging.jar;%AXIS_LIB%\jaxrpc.jar;%AXIS_LIB%\saaj.jar;%AXIS_LIB%\log4j-1.2.8.jar;%AXIS_LIB%\wsdl4j.jar;%AXIS_LIB%\xercesImpl.jar;%AXIS_LIB%\xml-apis.jar

    二、Axis框架的整合
        1、将D:\axis-1_1\lib下的所有jar文件拷贝到Web应用程序的WEB-INF\lib目录下。

        2、在web.xml文件中加入以下配置信息
Xml代码
<servlet> 
       <servlet-name>AxisServlet</servlet-name> 
       <servlet-class>org.apache.axis.transport.http.AxisServlet</servlet-class> 
</servlet> 
   
<servlet-mapping> 
       <servlet-name>AxisServlet</servlet-name> 
       <url-pattern>*.jws</url-pattern> 
</servlet-mapping> 
   
<mime-mapping> 
       <extension>wsdl</extension> 
       <mime-type>text/xml</mime-type> 
</mime-mapping> 
 
<mime-mapping> 
       <extension>xsd</extension> 
       <mime-type>text/xml</mime-type> 
</mime-mapping> 
     
         3、在Web应用程序的根目录下新建一个文件夹用于存放jws文件，这里假设文件夹名为axis。可以将一个java文件通过修改其扩展名得到jws文件（注意：java文件不能包含包路径）。所以，我们可以先在java环境下编写好表示WebService的java类，然后，修改java类的扩展名为jws，即可得到我们需要的jws文件。

         4、我们在src的根目录新建一个无包路径的java类，假设文件名为Webservice，该java类源代码如下：
Java代码
public class Webservice { 
       public String sayHello(String username){ 
              if(username==null || username.length()==0){ 
                     return "Hello Guest"; 
              }else{ 
                     return "Hello " + username; 
              } 
       } 
} 

       5、将Webservice.java文件拷贝到上面创建的文件夹axis中，并修改其扩展名为jws。

       6、启动应用服务器后，在IE浏览器中访问该jws文件。作者是用Tomcat5.5发布的，端口为8888，所以访问jws文件的URL类似如下：
             http://localhost:8888/MyWebApp/axis/Webservice.jws
 
             WSDL描述的URL就类似如下：
                   http://localhost:8888/MyWebApp/axis/Webservice.jws?wsdl
 
             如果以上两个URL都能正常访问，则表示Axis框架已经整合成功。

    三、生成Web service接口文件
         如果项目中需要调用Web service中的方法时，需要根据WSDL描述的URL来生成相应的接口文件。生成接口文件的步骤如下：
         1、在DOS中定位到axis-1_1\lib目录，然后执行以下指令：
              java -cp "%AXISCLASSPATH%" org.apache.axis.wsdl.WSDL2Java http://localhost:8888/MyWebApp/axis/Webservice.jws?wsdl -o -p
 
             。指令执行完毕后，将会在lib目录产生java接口文件。作者范例中产生以下四个文件：
                   Webservice.java
                   WebserviceService.java
                   WebserviceServiceLocator.java
                   WebserviceSoapBindingStub.java
       
         2、将这些接口文件纳入到项目中，接口文件的包路径根据具体情况作调整。

   四、调用Web service方法的范例代码：
Java代码
WebserviceServiceLocator locator = new WebserviceServiceLocator(); 
Webservice wsUtil = locator.getWebservice(new URL("http://localhost:8888/MyWebApp/axis/Webservice.jws?wsdl")); 
String ret = wsUtil.sayHello("Raymond.chen");