轉---------利用AXIS開發Webservice(二) —— WSDD的一些高級特性 (學習)
Posted on 2012-06-07 16:52 小白19870626 閱讀(307) 評論(0) 編輯 收藏 所屬分類: webservice時間過的真快,一不小心過了半年了,半年后我來更新第二篇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,還有一些配置方面的的問題就留到下節說吧。
小白