向Web Service进军－－Axis Tomcat模拟一个银行存取款服务

向Web Service进军－－Axis Tomcat模拟一个银行存取款服务

下载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-INF\lib中的所有的文件copy到Tomcat的common\lib目录中。(以后凡是要在axis的lib中添加jar文件，都要copy一份到Tomcat的common\lib目录下)。

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

AXIS_HOME
%TOMCAT_HOME%\webapps\axis(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-INF\lib中，别忘了Tomcat自己的common\lib也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下面的webapps\axis目录下即可。但是JWS的web服务发布是一个很简单的Web服务发布方式，在页面中你不能使用包，而且由于代码是在运行期被编译的，所以在部署之后，你也很难找到错误所在。

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

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

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

Tomcat 5.0\webapps\axis\WEB-INF\classes\samples\userguide\example2

里面是不是看到一个CalcClient.class的文件啊？这个文件就是对应的axis提供的calculate的客户端的例子。在dos方式，到Tomcat 5.0\webapps\axis\WEB-INF\classes\目录下：

java samples.userguide.example2.CalcClient add 3 4

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

Calculator对应的源代码在下载的axis.zip里面的samples\userguide\example2里面。

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下的webapps\axis\WEB-INF\com\duckur\下面。

下面发布：

在Tomcat下的webapps\axis\WEB-INF\com\duckur\目录下新建一个deploy.wsdd文件描述服务的名称、入口等信息：

wsdd文件的显示有问题下载吧

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

“我们是通过一个标签告诉RPC服务应该调用的类，而另外一个标签则告诉引擎，它可以调用这个类中的任何的Public方法。你也可以指定通过使用名字空间或者一些可以调用的方法列表，来指明那些方法可以被调用。”

当然也可以用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;

import javax.xml.rpc.ParameterMode;

import javax.xml.namespace.QName;

public class LxClient

extends JFrame {

JTextField jTextField1 = new JTextField();

JLabel jLabel3 = new JLabel();

JLabel jLabel1 = new JLabel();

JButton jButton1 = new JButton();

JButton jButton2 = new JButton();

JButton jButton3 = new JButton();

JLabel jLabel2 = new JLabel();

JTextField jTextField2 = new JTextField();

public LxClient() {

try {

jbInit();

}

catch (Exception e) {

e.printStackTrace();

}

}

public static void main(String args[]){

LxClient myframe=new LxClient();

myframe.setSize(400,200);

myframe.setVisible(true);

}

private void jbInit() throws Exception {

this.getContentPane().setLayout(null);

jTextField1.setText("");

jTextField1.setBounds(new Rectangle(131, 51, 80, 24));

jLabel3.setText("A0317286 李迅");

jLabel3.setBounds(new Rectangle(102, 15, 108, 17));

jLabel1.setText("填入金额：");

jLabel1.setBounds(new Rectangle(64, 54, 55, 21));

jButton1.setBounds(new Rectangle(50, 96, 58, 23));

jButton1.setText("存款");

jButton1.addActionListener(new LxClient_jButton1_actionAdapter(this));

jButton2.setBounds(new Rectangle(126, 96, 63, 23));

jButton2.setText("取款");

jButton2.addActionListener(new LxClient_jButton2_actionAdapter(this));

jButton3.setBounds(new Rectangle(205, 94, 81, 24));

jButton3.setText("查看金额");

jButton3.addActionListener(new LxClient_jButton3_actionAdapter(this));

jLabel2.setText("当前的金额：");

jLabel2.setBounds(new Rectangle(59, 136, 74, 21));

jTextField2.setEditable(false);

jTextField2.setText("");

jTextField2.setBounds(new Rectangle(127, 133, 85, 25));

this.getContentPane().add(jTextField1, null);

this.getContentPane().add(jLabel3, null);

this.getContentPane().add(jLabel1, null);

this.getContentPane().add(jButton2, null);

this.getContentPane().add(jButton1, null);

this.getContentPane().add(jButton3, null);

this.getContentPane().add(jLabel2, null);

this.getContentPane().add(jTextField2, null);

}

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

调用WebService* /

存款*/

void jButton1_actionPerformed(ActionEvent e) {

try {

String endpoint = "http://localhost:8080/axis/services/LxAccount";

String method = "deposit";

Integer i = Integer.valueOf(jTextField1.getText());

Service service = new Service();

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

call.setTargetEndpointAddress(new java.net.URL(endpoint));

call.setOperationName(method);

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

//更新数据

jTextField2.setText(myFund.toString());

jLabel1.updateUI();

}

catch (Exception ex) {

System.err.println(ex.toString());

}

}

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

取款*/

void jButton2_actionPerformed(ActionEvent e) {

try {

String endpoint = "http://localhost:8080/axis/services/LxAccount";

String method = "withdraw";

Integer i = Integer.valueOf(jTextField1.getText());

Service service = new Service();

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

call.setTargetEndpointAddress(new java.net.URL(endpoint));

call.setOperationName(method);

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

//更新数据

jTextField2.setText(myFund.toString());

jLabel1.updateUI();

}

catch (Exception ex) {

System.err.println(ex.toString());

}

}

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

显示当前金额*/

void jButton3_actionPerformed(ActionEvent e) {

try {

String endpoint = "http://localhost:8080/axis/services/LxAccount";

String method = "getAccount";

Service service = new Service();

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

call.setTargetEndpointAddress(new java.net.URL(endpoint));

call.setOperationName(method);

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

//更新数据

jTextField2.setText(myFund.toString());

jLabel1.updateUI();

}

catch (Exception ex) {

System.err.println(ex.toString());

}

}

}

class LxClient_jButton1_actionAdapter

implements java.awt.event.ActionListener {

LxClient adaptee;

LxClient_jButton1_actionAdapter(LxClient adaptee) {

this.adaptee = adaptee;

}

public void actionPerformed(ActionEvent e) {

adaptee.jButton1_actionPerformed(e);

}

}

class LxClient_jButton2_actionAdapter

implements java.awt.event.ActionListener {

LxClient adaptee;

LxClient_jButton2_actionAdapter(LxClient adaptee) {

this.adaptee = adaptee;

}

public void actionPerformed(ActionEvent e) {

adaptee.jButton2_actionPerformed(e);

}

}

class LxClient_jButton3_actionAdapter

implements java.awt.event.ActionListener {

LxClient adaptee;

LxClient_jButton3_actionAdapter(LxClient adaptee) {

this.adaptee = adaptee;

}

public void actionPerformed(ActionEvent e) {

adaptee.jButton3_actionPerformed(e);

}

}