下载Apache Axis用来实现SOAP(简单对象访问协议)。http://ws.apache.org/axis/

目前最稳定的版本是1.1

 

SOAP是用于在分散的或者分布式的环境中交换信息的一个轻量级协议。SOAP基于XML,由三部分组成:一个必须的SOAP封装,一个可选的SOAP头和一个必须的SOAP体。

通常情况下,SOAP = HTTP + RPC + XML。 即:SOAP以HTTP作为底层通信协议,以RPC作为交互方式,以XML作为数据传送的格式。

 

Web Service开发所需要掌握的技能:

JAVA,线程,同步,Classloader,错误排除,知道NPE(NullPointerException)和其他一些常见的错误,并能够处理,Servlet,如何发布Web 应用到应用服务器(Tomcat等)

TCP/IP,socket API,XML...多得吓人啊!要学习啊:(

 

1 安装配置Axis

 

~~安装Tomcat 4.X以上版本(4.X后的版本都带XML的解析器)

~~解压Axis1.1.zip包,找到webapps目录下的axis文件夹,拷贝axis文件夹到Tomcat中的webapps文件夹下。

~~将Tomcat中的axis目录下的WEB-INFlib中的所有的文件copy到Tomcat的commonlib目录中。(以后凡是要在axis的lib中添加jar文件,都要copy一份到Tomcat的commonlib目录下)。

~~我的电脑->属性->高级->环境变量->系统变量中添加:

AXIS_HOME
%TOMCAT_HOME%webappsaxis(TOMCAT的目录)

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

修改CLASSPATH ,在末尾加上:
%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

 

注意检查CLASSPATH是否正确:(有些软件会在用户变量区设置一个classpath,会有影响,如:XMLSPY)

在DOS方式下

输命令:Echo %CLASSPATH%

 

 

 

 

~~检查配置:

 

启动Tomcat,访问http://localhost:8080/axis/

 

 

验证axis的是否工作:http://localhost:8080/axis/happyaxis.jsp如果正常显示表示正常。

 

上图中 倒数第3行字“The core axis libra….”,要保证core axis libraries are present,如果有任何core library is missing,就到其提供的相应的链接上找到对应的jar文件,并copy到tomcat目录里面的axis文件夹WEB-INFlib中,别忘了 Tomcat自己的commonlib也copy一份。

直到所有的core library are present.

 

好啦基本上都配置好了。现在我们开始做一个有点模样的web Service的例子啦。一步一步来:)

 

目标:模拟一个银行存取款系统,存取款的具体实现作为服务来提供

Axis提供了两种服务发布方式,一种是即时发布(Instant Deployment),一种是定制发布(Custom Deployment)。

1. 使用即时发布 Java Web Service(JWS)

  “对即时发布的支持是Axis的特色之一,使用即时发布使用户只需有提供服务的Java类的源代码,即可将其迅速发布成Web服务。每当用户调用这类服务的时候,Axis会自动进行编译,即使服务器重启了也不必对其做任何处理,使用非常简单快捷。”

使用即时发布首先需要一个实现服务功能的Java源文件,将其扩展名改为.jws(Java Web Service的缩写),然后将该文件放到Tomcat下面的webappsaxis目录下即可。但是JWS的web服务发布是一个很简单的Web服务发布方式,在页面中你不能使用包,而且由于代码是在运行期被编译的,所以在部署之后,你也很难找到错误所在。

就是不好罗,但是我们还是来看一个例子:大家在Tomcat的webappsaxis下找到Calculate.jws文件,然后打开看看。不用编译的。

发布吧:http://localhost:8080/axis/Distance.jws?wsdl 如果你看到下面的WSDL描述表示你已经发布成功啦:

 

 

怎么使用这个服务呢?大家到

Tomcat 5.0webappsaxisWEB-INFclassessamplesuserguideexample2

里面是不是看到一个CalcClient.class的文件啊?这个文件就是对应的axis提供的calculate的客户端的例子。在dos方式,到Tomcat 5.0webappsaxisWEB-INFclasses目录下:

java samples.userguide.example2.CalcClient add 3 4

是不是得到7了啊?如果出现NoDefClass的错误的话就用echo检查各个环境变量吧。一般都错在这里。

Calculator对应的源代码在下载的axis.zip里面的samplesuserguideexample2里面。

 

2. 使用定制发布 Web Service Deployment Descriptor(WSDD)

 “即时发布是一项令人激动的技术,它使Web服务的开发变得如此简单;然而即时发布并不总是最好的选择,比如有些应用系统是第三方提供的,我们没有购买源代码,只有.class文件,但我们又希望将这个应用系统的一些功能对外发布成Web服务,使其能够在更大范围内产生作用,这个时候即时发布技术就无能为力了。此外,即时发布技术并不灵活,无法进行更多的服务配置,这使得它并不能满足一些特定系统的需求。”

      好啦 到我们啦,我先不说定制发布有什么好,大家先往下看,自然会有体会的:)

首先给出我们的模拟银行存取款的java文件:

Account.java

 

package com.duckur;

 

public class? Account

{

          /*************************************************************

          /*从随机数中获取帐户(一次性有效)*/

          public static int fund = (int)(java.lang.Math.random()*10000);

          //模拟,大家可以从文件中读取数据,或者从数据库中取出这个fund值

           /*************************************************************

            /*检查输入的有效性*/

           public boolean checkInput(int money)//只能取整数

           {

            if(money > fund)

            {

                  return false;

             }

             else

             {

                 return true;

               }

            }

 

           /*************************************************************

           /*存款*/

           public int deposit(int money)

          {

                fund? = fund + money;

                return fund;

           }

 

          /******************

*******************************************

          /*取款*/

          public int withdraw(int money)

          {

                    if(checkInput(money))

                     {

                              fund = fund - money;

                     }

                     return fund;

           }

 

          /*************************************************************

           /*获取当前的帐户值*/

           public int getAccount()

           {

                     return fund;

          }

 

}

 

    然后编译,通过后生成的class文件应该放在Tomcat下的webappsaxisWEB-INFcomduckur下面。

下面发布:

 在Tomcat下的webappsaxisWEB-INFcomduckur目录下新建一个deploy.wsdd文件描述服务的名称、入口等信息:

其中service项重的名称为该服务的名称即Account,java:RPC指明了一个JAVA RPC服务,做这个处理的类是org.apache.axis.providers.java.RPCProvider。

   “我们是通过一个

     当然也可以用Axis提供的一个客户端管理工具——AdminClient来完成服务的定制发布。这里不说:)

 

然后在DOS下到该目录下,

java org.apache.axis.client.AdminClient deploy.wsdd

如果出现:

Processing file deploy.wsdd
Doneprocessing

这表明Capacity服务定制发布完成。

好现在你就可以通过http://localhost:8080/axis/services/Account?wsdl来查看WSDL描述了。

 

Web Service发布好了现在调用它吧.

这里说一个最基本的调用需要用的类和方法:

(取出当前的金额)

...

//新建一个服务对象

Service service = new Service();??

//调用服务对象的createCall()方法返回一个命令

Call call = (Call) service.createCall();??

// Sets the address of the target service endpoint.

call.setTargetEndpointAddress(new java.net.URL("http://localhost:8080/axis/services/LxAccount"));

//?Sets the name of the operation to be invoked using this Call instance

call.setOperationName(“getAccount”);

//Convenience method to invoke a //method with a default (empty) namespace

Integer myFund = (Integer) call.invoke(new Object[] {});

...

 

详细函数可以参考开发API在下载的axis.zip中的docs里面。

下面是详细的代码:

编译后执行就可以。

 

LxClient.java

 

import javax.swing.*;

import java.awt.*;

import java.awt.event.*;

 

import org.apache.axis.client.Call;

import org.apache.axis.client.Service;

import org.apache.axis.encoding.XMLType;

import org.apache.axis.utils.Options;