時間過的真快，一不小心過了半年了，半年后我來更新第二篇webservice的博文。春困秋乏夏打盹，睡不醒的冬三月。最近又懶了。

第一篇介紹了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>  

<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>節點下面會有這樣一個子節點。

Xml代碼

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

 <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. }   

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代碼之后我們連編寫發布文件。

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>  

<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>

發布代碼中有這樣的一句，細心的朋友一定會發現。

Xml代碼

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

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

看完這句代碼再對比一下Handler的實現代碼中的一句，相信大多數人都能明白了。

Java代碼

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

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. }  

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的代碼

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. }  

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>:

Xml代碼

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

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

第二種是引用別的<handler>

Xml代碼

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

<handler name="myHandler" type="java:com.chnic.handler.MyHandler"/>
<chain name="myChain"/>
<handler type="myHandler"/>
</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>  

<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的功能

Xml代碼

1. <responseFlow>  
2.     <handler type="HelloWorldHandler"/>  
3.  </responseFlow>  

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

最后簡單提一下遠程管理，也就是Remote Administration。要實現遠程管理在發布文件的<service>標簽下加入下面一段語句就可以了。

Xml代碼

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

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

 不過遠程管理會有安全方面的問題，所以不建議使用。

一些高級部分就先說到這里，還有一些比如RPC docuement Wrapped Message的區別和使，如何傳遞一個Javabean，還有一些配置方面的的問題就留到下節說吧。