用Axis开发基于Java的Web服务

   介绍一个比较简单实用的基于Java的SOAP引擎——Apache组织推出的Axis——的安装、配置和应用开发方法，希望对有兴趣做基于Java的Web Services应用开发的朋友有所帮助。

Axis简介

　　Axis是Apache组织推出的SOAP引擎，Axis项目是Apache组织著名的SOAP项目的后继项目，目前最新版本是采用Java开发的1.1版本，C++的版本正在开发之中。Axis v1.1软件包可以从http://ws.apache.org/axis/dist/1_1/下载得到。

Axis的安装

　　应用Axis开发Web Services，你需要有一个支持Servlet的服务器引擎，比如广为人知的Tomcat（Tomcat也是由Apache组织所提供的，目前的最新版本为4.1.24，下载地址为http://jakarta.apache.org/builds/jakarta-tomcat-4.0/release/v4.1.24/）。在此之前当然你机器必须已经装好了JDK1.3以上的版本，当安装好Tomcat之后，只需将下载的Axis软件包解压缩，将其中的“webapps”目录下的“axis”目录整个拷贝到Tomcat安装目录下的“webapps”目录下即可。

Axis的配置

　　Axis基于Java开发，可以部署于多种操作系统，使用前需要配置一系列的系统变量，在此假定你已经在本机上装好了Tomcat 4.0以上的版本，需要配置的系统变量如下表所示：

CATALINA_HOME
C:\Tomcat_4_1

（此处应为Tomcat的安装位置，注意路径名中不要有空格）

AXIS_HOME
%CATALINA_HOME%\webapps\axis

AXIS_LIB
%AXIS_HOME%\lib

AXISCLASSPATH
%AXIS_LIB%\axis.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%\xml-apis.jar;%AXIS_LIB%\xercesImpl.jar

注意：这里的包不全，包名也有错！包名应该是带版本号的！

　　如果你不愿做这么繁琐的类路径设置，可以直接将axis软件包中“lib”目录下的所有.jar文件加入到系统环境变量CLASSPATH中即可。

Axis的测试

　　安装配置完毕后，应测试一下是否Axis可以正确运行了。

　　启动Tomcat服务器，在浏览器中访问http://localhost:8080/axis/happyaxis.jsp，如果页面显示有错误，则需要回头检查一下相关配置是否正确，如果浏览页面能正确显示出系统组件、属性等参数配置信息，则表示安装成功，如下图

 

下面开始写一个有服务器端和客户端的demo：

 

1、   服务器端
1.1、创建一个Web工程WS_Test

1.2、把axis相关jar包考入工程的lib文件夹下（jar包见附件）
（注意lib文件夹应该在axis根目录下！从官网下的1.4的包，在应用中会报少包，我又加了四个）
1.3、配置web.xml，内容如下
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web
Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd">
<web-app> 
  <display-name>Apache-Axis</display-name>
    <listener> 
        <listener-class>org.apache.axis.transport.http.AxisHTTPSessionListener</listener-class> 
    </listener> 
  <servlet> 
    <servlet-name>AxisServlet</servlet-name> 
    <display-name>Apache-Axis Servlet</display-name> 
    <servlet-class> 
        org.apache.axis.transport.http.AxisServlet 
    </servlet-class> 
  </servlet> 
  <servlet> 
    <servlet-name>AdminServlet</servlet-name> 
    <display-name>Axis Admin Servlet</display-name> 
    <servlet-class> 
        org.apache.axis.transport.http.AdminServlet 
    </servlet-class> 
    <load-on-startup>100</load-on-startup> 
  </servlet> 
  <servlet> 
    <servlet-name>SOAPMonitorService</servlet-name> 
    <display-name>SOAPMonitorService</display-name> 
    <servlet-class> 
        org.apache.axis.monitor.SOAPMonitorService 
    </servlet-class> 
    <init-param> 
      <param-name>SOAPMonitorPort</param-name> 
      <param-value>5001</param-value> 
    </init-param> 
    <load-on-startup>100</load-on-startup> 
  </servlet> 
  <servlet-mapping> 
    <servlet-name>AxisServlet</servlet-name> 
    <url-pattern>/servlet/AxisServlet</url-pattern> 
  </servlet-mapping> 
  <servlet-mapping> 
    <servlet-name>AxisServlet</servlet-name> 
    <url-pattern>*.jws</url-pattern> 
  </servlet-mapping> 
<servlet-mapping> 
    <servlet-name>AxisServlet</servlet-name> 
    <url-pattern>/services/*</url-pattern> 
  </servlet-mapping> 
  <servlet-mapping> 
    <servlet-name>SOAPMonitorService</servlet-name> 
    <url-pattern>/SOAPMonitor</url-pattern> 
  </servlet-mapping>
<!-- uncomment this if you want the admin servlet -->
<!-- 
  <servlet-mapping> 
    <servlet-name>AdminServlet</servlet-name> 
    <url-pattern>/servlet/AdminServlet</url-pattern> 
  </servlet-mapping>
--> 
    <session-config> 
        <!-- Default to 5 minute session timeouts --> 
        <session-timeout>5</session-timeout> 
    </session-config> 
    <!-- currently the W3C havent settled on a media type for WSDL; 
    http://www.w3.org/TR/2003/WD-wsdl12-20030303/#ietf-draft 
    for now we go with the basic 'it's XML' response --> 
  <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>
  <welcome-file-list id="WelcomeFileList"> 
    <welcome-file>index.jsp</welcome-file> 
    <welcome-file>index.html</welcome-file> 
    <welcome-file>index.jws</welcome-file> 
  </welcome-file-list>
</web-app>





1.4、在src下创建对外提供调用的service类test_1.Ws_1.java

内容如下：

package test_1;



public class Ws_1 {

      

       public String function_1(String str_1){

             

              System.out.println(" *** service 被调用了 ***  接收参数："+str_1);

              String str =" scorpio  :  " + str_1+"  is ok ";  //接到客户端请求，然后处理

        //… …

              return str ;      //最后把结果返回客户端

             

       }



}

1.5、修改tomcat下的server.xml

本人server.xml文件路径为D:/apache-tomcat-5.5.26/conf/server.xml


在</Host>上一行增加或修改为
<Context path='/WS_Test' docBase='D:/workspace/WS_Test/WebRoot' debuge='0' reloadable='true'/>


其中：/WS_Test 为上下文的根，在这里用工程名命名（可随意）
D:/workspace/WS_Test/WebRoot 为工程web所在的路径


1.6、在WEB-INF下创建deploy.wsdd文件，内容如下

<deployment xmlns="http://xml.apache.org/axis/wsdd/" xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">

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

  <parameter name="className" value="test_1.Ws_1"/>

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

</service>

</deployment>



注：Say_Hello_Service，为service的名字
test_1.Ws_1，为Say_Hello_Service对应的类


1.7、在WEB-INF下创建deploy.bat文件，内容如下

set Axis_Lib=D:/workspace/WS_Test/WebRoot/WEB-INF/lib

set Java_Cmd=java -Djava.ext.dirs=%Axis_Lib%

set Axis_Servlet=http://localhost:7777/WS_Test/servlet/AxisServlet

%Java_Cmd% org.apache.axis.client.AdminClient -l%Axis_Servlet% deploy.wsdd

pause



其中D:/workspace/WS_Test/WebRoot/WEB-INF/lib对应改为自己的工程lib所在的路径

http://localhost:7777/WS_Test/servlet/AxisServlet中的7777改为 自己的端口号



注：这里特别注意，在tomcat中一定要配置工程上下文的根（我这里用的是工程名：WS_Test）


1.8、先启动tomcat，然后运行刚创建的deploy.bat
执行完毕后，WEB-INF下会多出一个server-config.wsdd文件
1.9、在浏览器地址栏里输入http://localhost:7777/WS_Test/servlet/AxisServlet（7777改成自己tomcat的端口号）

如有如下内容 则服务器端 编码完毕

•Say_Hello_Service (wsdl)
◦function_1






2、   客户端
2.1、建立一个java工程  WS_Test_client
2.2、工程下文件夹WS_Test_client下建立一个lib文件夹

把axis相关jar包考入工程的lib文件夹下（jar包见附件）

2.3、工程文件夹WS_Test_client下建立一个test_1_client文件夹

2.4、工程文件夹WS_Test_client下直接创建wsdl2java.bat文件
内容如下
set Axis_Lib=D:/workspace/WS_Test_client/lib
set Java_Cmd=java -Djava.ext.dirs=%Axis_Lib%
set Output_Path=D:/workspace/WS_Test_client/src
set Package=test_1_client
%Java_Cmd% org.apache.axis.wsdl.WSDL2Java –p%Package% -o%Output_Path%  http://localhost:7777/WS_Test/services/Say_Hello_Service?wsdl
Pause


其中 D:/workspace/WS_Test_client/lib 为客户端java工程lib路径
     D:/workspace/WS_Test_client/ test_1_client 存放生成文件路径
test_1_client   生成的类的包名


2.5 运行wsdl2java.bat文件
前提：服务器端服务已开启
运行完毕后 会多出
Say_Hello_ServiceSoapBindingStub.java
Ws_1.java
Ws_1Service.java
Ws_1ServiceLocator.java
等文件
2.6、创建调用服务器service的类test_1_client. Main.java


package test_1_client;



public class Main {



       /**

        * @param args

        */

       public static void main(String[] args) {

              // TODO Auto-generated method stub

             

              Ws_1ServiceLocator local = new Ws_1ServiceLocator();

              try{

                     Ws_1 ws = local.getSay_Hello_Service();

                     String str = ws.function_1("heihei"); //调用服务器端方法

                     System.out.println(str);

              }catch(Exception e){

                    

                     e.printStackTrace();

              }

              }



       }

   

2.7、运行test_1_client. Main.java 输出台输出服务器端返回结果即调用服务器端成功