posts - 64,  comments - 9,  trackbacks - 0
(转 自Javaeye chnic 童鞋)利用AXIS开发Webservice(二) —— WSDD的一些高级特性

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

关键字: webservice axis handler chain

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

 

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

 

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

Xml代码 复制代码
  1. <undeployment xmlns="http://xml.apache.org/axis/wsdd/">  
  2.  <service name="HelloWorld"/>  
  3. </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>节点下面会有这样一个子节点。

Xml代码 复制代码
  1. <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的代码。

Java代码 复制代码
  1. package com.chnic.handler;   
  2.   
  3. import org.apache.axis.AxisFault;   
  4. import org.apache.axis.MessageContext;   
  5. import org.apache.axis.handlers.BasicHandler;   
  6.   
  7. public class HelloWorldHandler extends BasicHandler{   
  8.   
  9.     private static final long serialVersionUID = 1L;   
  10.     public void invoke(MessageContext context) throws AxisFault {   
  11.         String status = (String) this.getOption("status");   
  12.         System.out.println("HelloWorldHandler's status is: " + status);   
  13.     }   
  14. }   

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

Xml代码 复制代码
  1. <deployment xmlns="http://xml.apache.org/axis/wsdd/"    
  2.     xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">  
  3.     <handler name="Hello" type="java:com.chnic.handler.HelloWorldHandler">  
  4.        <parameter name="status" value="success"/>  
  5.     </handler>  
  6.   
  7.     <service name="HelloWorld" provider="java:RPC">  
  8.      <requestFlow>  
  9.        <handler type="Hello"/>  
  10.      </requestFlow>  
  11.         <parameter name="className" value="com.chnic.webservice.HelloWorld"/>  
  12.         <parameter name="allowedMethods" value="*"/>  
  13.         <parameter name="scope" value="session"/>  
  14.     </service>  
  15. </deployment>  

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

Xml代码 复制代码
  1. <parameter name="status" value="success"/>  

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

Java代码 复制代码
  1. 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我们来组成一条锁链。

Java代码 复制代码
  1. package com.chnic.handler;   
  2.   
  3. import org.apache.axis.AxisFault;   
  4. import org.apache.axis.MessageContext;   
  5. import org.apache.axis.handlers.BasicHandler;   
  6.   
  7. public class MyHandler extends BasicHandler {   
  8.   
  9.     private static final long serialVersionUID = 1L;   
  10.     public void invoke(MessageContext context) throws AxisFault {   
  11.         System.out.println("This is MyHandler..");   
  12.     }   
  13. }  

 之后我们编写Chain的代码

Java代码 复制代码
  1. package com.chnic.chain;   
  2.   
  3. import org.apache.axis.SimpleChain;   
  4. import com.chnic.handler.HelloWorldHandler;   
  5. import com.chnic.handler.MyHandler;   
  6.   
  7. public class HelloWorldChain extends SimpleChain {   
  8.   
  9.     private static final long serialVersionUID = 1L;   
  10.     public HelloWorldChain(){   
  11.         HelloWorldHandler hwh = new HelloWorldHandler();   
  12.         MyHandler mh = new MyHandler();   
  13.         this.addHandler(hwh);   
  14.         this.addHandler(mh);   
  15.     }   
  16. }  

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

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

 

Xml代码 复制代码
  1. <chain name="myChain">  
  2.     <handler type="java:com.chnic.handler.MyHandler"/>  
  3. </chain>  

第二种是引用别的<handler>

 

Xml代码 复制代码
  1. <handler name="myHandler" type="java:com.chnic.handler.MyHandler"/>  
  2. <chain name="myChain"/>  
  3.    <handler type="myHandler"/>  
  4. </chain>  

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

Xml代码 复制代码
  1. <deployment xmlns="http://xml.apache.org/axis/wsdd/"    
  2.     xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">  
  3.        
  4.     <chain name="myChain">  
  5.         <handler type="java:com.chnic.chain.HelloWorldChain"/>  
  6.     </chain>  
  7.        
  8.     <service name="HelloWorld" provider="java:RPC">  
  9.      <requestFlow>  
  10.        <chain type="myChain"/>  
  11.      </requestFlow>  
  12.   
  13.         <parameter name="className" value="com.chnic.webservice.HelloWorld"/>  
  14.         <parameter name="allowedMethods" value="*"/>  
  15.         <parameter name="scope" value="session"/>  
  16.     </service>       
  17. </deployment>  

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

 

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

Xml代码 复制代码
  1. <responseFlow>  
  2.     <handler type="HelloWorldHandler"/>  
  3.  </responseFlow>  

 

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

Xml代码 复制代码
  1. <parameter name="enableRemoteAdmin" value="true"/>  

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

 

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

posted on 2009-07-03 18:39 super_nini 阅读(445) 评论(0)  编辑  收藏

只有注册用户登录后才能发表评论。
网站导航:
 
Copyright ©2024 super_nini Powered By: 博客园 模板提供：沪江博客
<2009年7月>
日一二三四五六
2829301234
567891011
12131415161718
19202122232425
2627282930311
2345678

常用链接

留言簿

随笔档案

文章档案

相册

搜索

  •  

最新评论

阅读排行榜

评论排行榜