因為工作關系需要從事Webservice的開發工作，公司的webserivce是由Apache的AXIS來實現的，以前對這個了解不算多，不過經過幾天的研究，特奉上小小的心得一篇。
先介紹下本人開發環境吧。 JDK 1.4.2 + Myeclipse 6.0（實在經不起誘惑，嘗嘗鮮） + Tomcat 5.0.28 + AXIS 1.4。 AXIS 1.4包可以在http://ws.apache.org/axis/ 找到。 假設所有的環境你已經搭好，并且AXIS包也已經下好了。OK， Here we go~
解壓axis-bin-1_4.zip這個包可以看到webapps目錄，雙擊進入把里面的AXIS文件夾拷到 %TOMCAT_HOME%\webapps目錄下，之后拷貝activation.jar、mail.jar、tools.jar到%TOMCAT_HOME%\webapps\axis\WEB-INF\lib目錄下。啟動tomcat，訪問http://localhost:8080/axis/happyaxis.jsp 如果訪問成功，恭喜你！基本的配置你已經做完了。
PS：此處的%TOMCAT_HOME%指的是Tomcat的安裝目錄，至于那另外的三個jar包，J2EE 1.4庫里就能找的到。
現在來說一下最關鍵的Webservice的發布。AXIS提供了兩種發布方式，一種是即時發布（Instant Deployment），另外一種是定制發布（Custom Deployment）。即時發布提供了一種非常簡單的webservice的發布方式，但是其中限制太多，因此在實際的開發中定制發布才是首選。這里也將會以定制發布為重點來介紹。
1.即時發布 JWS (Java Web Service) Files - Instant Deployment
即時發布提供了一種非常簡單發布方式，發布者只要有Java源代碼（也就是.java文件），然后把其后綴名改成jws（也就是 java web service的縮寫）拷貝到%TOMCAT_HOME%\webapps\axis目錄下即完成了所有的發布工作。AXIS的編譯引擎會處理接下來的所有事情。下面是一段示例代碼：
java 代碼
- public class HelloAXIS {
- public String Hello(String name){
- return "AXIS say hello to " + name;
- }
- }
把 HelloAXIS.java 文件改成 HelloAXIS.jws 然后拷貝到%TOMCAT_HOME%\webapps\axis目錄下，啟動Tomcat之后訪問 http://localhost:8080/axis/HelloAXIS.jws 如果能看到 Click to see the WSDL這個超鏈接就說明已經發布成功了，點擊進去就可以看到這個Webservice的WSDL描述文件。server端的發布已經完成了，接下來就是編寫Client端測試代碼了。
java 代碼
- package com.chnic.test;
- import java.net.URL;
- import javax.xml.namespace.QName;
- import org.apache.axis.client.Call;
- import org.apache.axis.client.Service;
- public class Test {
- public static void main(String[] args) throws Exception{
- String targetEendPoint = "http://localhost:8080/axis/HelloAXIS.jws" ;
- Service service = new Service();
- Call call = (Call) service.createCall();
- call.setOperationName( new QName(targetEendPoint, "Hello" ));
- call.setTargetEndpointAddress( new URL(targetEendPoint));
- String result = (String) call.invoke( new Object[]{ "Robert" });
- System.out.println(result);
- }
- }
測試代碼很簡單，如果熟悉java反射機制的朋友不用兩分鐘就能看明白。運行后客戶端控制臺出現 AXIS say hello Robert。測試成功。果然很簡單吧。不過在這簡單背后卻是以犧牲靈活性為代價的。假如你現在手里只有.class 或者一個jar包，jws就不再能滿足你的需求了，最要命的就是即時發布不支持帶包的類，這點AXIS的用戶手冊上寫的也很明白。
Important: JWS web services are intended for simple web services. You cannot use packages in the pages, and as the code is compiled at run time you can not find out about errors until after deployment. Production quality web services should use Java classes with custom deployment.
2.定制發布 Custom Deployment - Introducing WSDD
比起即時發布定制發布更加煩瑣也更復雜，但是換來的卻是更大的靈活性，因此在實際項目中定制發布還是不二的選擇。定制發布需要你自己編寫一個WSDD（Web Service Deployment Descriptor）文件，這個東東類似與XML稍后會做出介紹。廢話不多說，我們來看代碼：
java 代碼
- package com.chnic.webservice;
- public class HelloWorld {
- public HelloWorld(){
- }
- public String hello(String str){
- return "Hello " + str;
- }
- public int add( int a, int b){
- return a + b;
- }
- }
一個帶包的很簡單的類，在eclipse下編譯后按照包名拷到 %TOMCAT_HOME%\webapps\axis\WEB-INF\classes 目錄下。以這個類為例，拷貝完之后這個HelloWorld.class的路徑就是 %TOMCAT_HOME%\webapps\axis\WEB-INF\classes\com\chnic\webservice。PS： 如果嫌這樣太麻煩，可以另外建一個Java Web工程用myeclipse的發布工具發布到Tomcat之后，整體一次性拷貝到websericve的工程中。
接下來就需要編寫發布文件deploy.wsdd。到%TOMCAT_HOME%\webapps\axis\WEB-INF 目錄下建立這個文件并在其中添加如下內容：
xml 代碼
- < deployment xmlns = http://xml.apache.org/axis/wsdd/
- xmlns:java = "http://xml.apache.org/axis/wsdd/providers/java" >
- < service name = "HelloWorld" provider = "java:RPC" >
- < parameter name = "className" value = "com.chnic.webservice.HelloWorld" />
- < parameter name = "allowedMethods" value = "*" />
- </ service >
- </ deployment >
簡單的介紹下各個節點的含義，"HelloWorld"當然是這個webservice的名字，后面緊跟的java：RPC指的是服務類型。這里一共有有4種類型，分別是：RPC, Document, Wrapped 和 Message。有興趣可以看下 org.apache.axis.providers這個包和子包下面的類的API文檔。之后的parameter節點第一個當然是指出具體的類，第二個從字面上也很好理解：允許調用的方法。這里的配置告訴引擎可以調用所有的public方法，當然你也可以自己指定。
編寫完配置發布文件之后，cmd打開windows的控制臺，進入%TOMCAT_HOME%\webapps\axis\WEB-INF目錄下鍵入如下命令
- java -Djava.ext.dirs=lib org.apache.axis.client.AdminClient deploy.wsdd
之后控制臺返回Processing file deploy.wsdd 和 Done processing 這兩段話即說明發布成功。（此時會在同級目錄生成一個server-config.wsdd文件 ）在這里的AdminClient是AXIS提供的一個客戶端管理工具。至于java.ext.dirs的含義可以去了解一下classloader和JVM類裝載機制方面的知識，在這里就不多解釋。 還有一點要注意的是在發布的時候Tomcat服務必須處于啟動狀態，否則就會拋出一堆無法連接的異常信息。發布成功之后你可以通過訪問 http://localhost:8080/axis/servlet/AxisServlet 來查看你所有的定制發布的服務。
客戶端測試代碼
- String targetEendPoint = "http://localhost:8080/axis/services/HelloWorld" ;
- Service service = new Service();
- Call call = (Call) service.createCall();
- call.setTargetEndpointAddress( new URL(targetEendPoint));
- call.setOperationName( new QName(targetEendPoint, "hello" ));
- String result = (String) call.invoke( new Object[]{ "Robert" });
- System.out.println(result);
- call.setOperationName( new QName(targetEendPoint, "add" ));
- Integer res = (Integer) call.invoke( new Object[]{ new Integer( 1 ), new Integer( 2 )});
- System.out.println( "The result is: " + res);
運行測試代碼，控制臺顯示 Hello Robert 和 The result is: 3 這兩句話，說明發布成功。仔細觀察下發現其實除了那個targetEndpoint 之外，即時發布和定制發布的客戶端調用代碼基本上都是一樣的。定制發布的URL可以在WSDL文件里找到。 其實定制發布還有一些高級特性，這個就留到下一篇再說吧。
小白