利用AXIS开发Webservice(二) —— WSDD的一些高级特性

时间过的真快，一不小心过了半年了，半年后我来更新第二篇webservice的博文。春困秋乏夏打盹，睡不醒的冬三月。最近又懒了。

 

第一篇介绍了AXIS的两种发布方式，和一些基本的应用。这一篇说一下一些高级应用。 开篇之前先把上篇的一个遗漏补充上，上篇只讲了怎么发布一个webservice，但是如何取消没有却没有提。其实取消一个已经发布的webservce也是非常简单的，我们就拿上篇的HelloWorld来做例子吧。 

 

发布webservice的时候我们有一个deploy.wsdd文件，当然在取消发布的时候就会有一个undeploy.wsdd文件。这个文件的内容也很简单，xml的代码如下。

<undeployment xmlns="http://xml.apache.org/axis/wsdd/">
 <service name="HelloWorld"/>
</undeployment>

编写完这个xml文件之后，把它同样copy到%TOMCAT_HOM\webapps\axis\WEB-INF目录下，然后CMD打开控制台，在控制台输入一个我们很熟悉的命令

    java -Djava.ext.dirs=lib org.apache.axis.client.AdminClient undeploy.wsdd

 

运行之后得到如下结果说明取消发布成功

Processing file undeploy.wsdd       
<Admin>Done processing</Admin>

 

说完取消发布之后就来说一下AXIS的一些高级特性，AXIS在编写deploy.wsdd这个文件时，每个<service>节点下面会有这样一个子节点。

 <parameter name="scope" value="value"/>

这个节点配置着你的service object也就是你webservice服务的那个object的圣明周期，在后面的value里可以有三个选项request, session, or application。熟悉Jsp、Servlet、或者EJB里的SessionBean的朋友应该能很快能明白这个三个配置选项的含义。

 

requst ：这个选项会让AXIS为每一个SOAP的请求产生一个服务对象，可以想像如果这个webservice的对象足够复杂，而且SOAP的请求过多，这个选项是非常耗费服务器性能的。

session ：如果选择了session，程序就会给每个调用这个webservice的客户端创造一个服务对象。

application ：这个选项最彪悍，程序只会在内存里new出来一个服务对象，然后为所有webservice客户端服务。很显然这个选项不能储存客户端的一些个性化数据。所以在功能性上很多时候不能满足要求。

 

接下来说一下Axis的Handler和Chain机制，Handler和Chain是Axis引擎提供的一个很强大的工具。假如现在客户有这样一个需求，需要记录某一个webservice被调用的次数，这个时候如果在service object里去实现这个功能不仅麻烦，而且侵入了原有的程序也会对增加原有程序的不稳定性。有了Handler我们就能见easy的解决这个问题。我们先来编写handler的代码。

package com.chnic.handler;

import org.apache.axis.AxisFault;
import org.apache.axis.MessageContext;
import org.apache.axis.handlers.BasicHandler;

public class HelloWorldHandler extends BasicHandler{

	private static final long serialVersionUID = 1L;
	public void invoke(MessageContext context) throws AxisFault {
		String status = (String) this.getOption("status");
		System.out.println("HelloWorldHandler's status is: " + status);
	}
} 

BasicHandler是一个抽象类，Axis提供了很多Handler的具体实现，BasicHandler只是其中最简单的一个。要实现一个自己的handler首先要从继承BasicHandler这个类开始并实现其中的invoke(MessageContext arg)这个方法。MessageContext可以看成是一个Axis的上下文，里面存储的是一些Axis和webservice的基本信息。想了解的朋友可以看一下Axis的API。编写完Handler代码之后我们连编写发布文件。

<deployment xmlns="http://xml.apache.org/axis/wsdd/" 
	xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">
	<handler name="Hello" type="java:com.chnic.handler.HelloWorldHandler">
  	   <parameter name="status" value="success"/>
	</handler>

 	<service name="HelloWorld" provider="java:RPC">
	 <requestFlow>
	   <handler type="Hello"/>
	 </requestFlow>
 		<parameter name="className" value="com.chnic.webservice.HelloWorld"/>
 		<parameter name="allowedMethods" value="*"/>
 		<parameter name="scope" value="session"/>
 	</service>
</deployment>

发布代码中有这样的一句，细心的朋友一定会发现。

<parameter name="status" value="success"/>

看完这句代码再对比一下Handler的实现代码中的一句，相信大多数人都能明白了。

String status = (String) this.getOption("status");

Handler通过getOption(String)这个方法拿到了配置文件中我配置的属性值。而我们上述所做的所有工作对于原来的Webserivce来说都是透明的，不会对侵入原有的程序当中。 一个Handler可以被多个service所使用通过<requestFlow>这个标签来引用到某一个service中，这里还要多提一句既然是一个requestFlow，这个当然可以加不只一个的Handler。接下来编写测试代码运行。在本地应用服务器上会打出如下语句：HelloWorldHandler's status is: success

说明测试成功，而且handler是配置在requestflow标签中所以这段代码会在service代码之前先执行。

 

介绍完了Handler再来介绍Chain。从Chain的字面意思就能猜到他实现的一连串Handler的功能。假如某个service需要不止一个Handler，或者要根据Client的情况来选择需要那些Handler。特别是后一个需求，我们无法用一个或者几个Handler来解决，这个时候我们就需要<Chain>来实现了。我们先再编写一个Handler，加上之前的那个Handler我们来组成一条锁链。

package com.chnic.handler;

import org.apache.axis.AxisFault;
import org.apache.axis.MessageContext;
import org.apache.axis.handlers.BasicHandler;

public class MyHandler extends BasicHandler {

	private static final long serialVersionUID = 1L;
	public void invoke(MessageContext context) throws AxisFault {
		System.out.println("This is MyHandler..");
	}
}

 之后我们编写Chain的代码

package com.chnic.chain;

import org.apache.axis.SimpleChain;
import com.chnic.handler.HelloWorldHandler;
import com.chnic.handler.MyHandler;

public class HelloWorldChain extends SimpleChain {

	private static final long serialVersionUID = 1L;
	public HelloWorldChain(){
		HelloWorldHandler hwh = new HelloWorldHandler();
		MyHandler mh = new MyHandler();
		this.addHandler(hwh);
		this.addHandler(mh);
	}
}

在Chain的构造函数中，把我要的两个Handler用addHandler()方法加载进去。之后我们来编写发布文件。<chain>和<handler>元素有些许不同在这里有必要多句嘴。

<chain>元素中的子元素只允许是<handler>或者<chain>。后者也就是允许在“锁链”里再嵌套“锁链”，在这里就拿嵌套<handler>来举例，他同样有两种方式来实现。第一种是直接包含<handler>:

 

<chain name="myChain">
  	<handler type="java:com.chnic.handler.MyHandler"/>
</chain>

第二种是引用别的<handler>

 

<handler name="myHandler" type="java:com.chnic.handler.MyHandler"/>
<chain name="myChain"/>
   <handler type="myHandler"/>
</chain>

因为我们这里的Handler并没有由BasicHandler来实现，而是由继承SimpleChain这个类来实现，严格意义上讲，SimpleChain也可以算是一个Handler，因为SimpleChain也是从BasicHandler继承而来，他同样实现了invoke()这个方法。下面回归正题，来看我们的发布代码。

<deployment xmlns="http://xml.apache.org/axis/wsdd/" 
	xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">
 	
	<chain name="myChain">
  		<handler type="java:com.chnic.chain.HelloWorldChain"/>
	</chain>
	
 	<service name="HelloWorld" provider="java:RPC">
	 <requestFlow>
	   <chain type="myChain"/>
	 </requestFlow>

 		<parameter name="className" value="com.chnic.webservice.HelloWorld"/>
 		<parameter name="allowedMethods" value="*"/>
 		<parameter name="scope" value="session"/>
 	</service>	
</deployment>

从新发布webservice之后，运行我们的测试代码。会发现在应用服务器的本地控制台上打出两句Handler要输出的语句，说明测试成功。而且控制台打出语句的顺序是和我们加载handler的顺序一样的。

 

除了<requestFlow>之外，Axis还提供了与之相应的</responseFlow>，用法和是requestflow一样的，所不同的是一个在service执行之前一个是之后。可以加下面代码到发布文件中的<service>元素下就可以实现responseflow的功能

<responseFlow>
 	<handler type="HelloWorldHandler"/>
 </responseFlow>

 

最后简单提一下远程管理，也就是Remote Administration。要实现远程管理在发布文件的<service>标签下加入下面一段语句就可以了。

<parameter name="enableRemoteAdmin" value="true"/>

 不过远程管理会有安全方面的问题，所以不建议使用。

 

一些高级部分就先说到这里，还有一些比如RPC docuement Wrapped Message的区别和使，如何传递一个Javabean，还有一些配置方面的的问题就留到下节说吧。