WSDL2Java操作指南

 

1. 安裝JDK1.5, 配置系統環境變量:
   下載安裝JDK後, 設置環境變量：
   JAVA_HOME=C:\Program Files\Java\jdk1.5.0_02
   Path=%Path%;%JAVA_HOME%\bin(這裏的%Path%指你係統已經有的一系列配置)
   CLASSPATH=%JAVA_HOME%\lib

2. 下載axis, 配置系統環境變量:
   下載axis後，配置如下：
   AXIS_LIB=F:\Java\axis\axis-1_4\lib
   然後在CLASSPATH裏添加axis的8個jar:
   CLASSPATH=%JAVA_HOME%\lib;
 %AXIS_LIB%\axis.jar;
 %AXIS_LIB%\axis-ant.jar;
 %AXIS_LIB%\commons-discovery-0.2.jar;
 %AXIS_LIB%\commons-logging-1.0.4.jar;
 %AXIS_LIB%\jaxrpc.jar;
 %AXIS_LIB%\log4j-1.2.8.jar;
 %AXIS_LIB%\saaj.jar;
 %AXIS_LIB%\wsdl4j-1.5.1.jar;
  
3. 添加附加的3個jar:
   自己去獲取activation.jar, mail.jar, xerces.jar, 放到AXIS_LIB所指的目錄下，
然後在CLASSPATH裏添加：
   CLASSPATH=%JAVA_HOME%\lib;
 %AXIS_LIB%\axis.jar;
 %AXIS_LIB%\axis-ant.jar;
 %AXIS_LIB%\commons-discovery-0.2.jar;
 %AXIS_LIB%\commons-logging-1.0.4.jar;
 %AXIS_LIB%\jaxrpc.jar;
 %AXIS_LIB%\log4j-1.2.8.jar;
 %AXIS_LIB%\saaj.jar;
 %AXIS_LIB%\wsdl4j-1.5.1.jar;
 %AXIS_LIB%\activation.jar;
 %AXIS_LIB%\mail.jar;
 %AXIS_LIB%\xerces.jar

4. 獲取或者自己編寫wsdl文件

5. 生成webservice服務器端的代碼：
   5.1 先看命令的幫助, 在cmd.exe的提示符執行：java org.apache.axis.wsdl.WSDL2Java -h
       我可以看到很多選項，其中就有-s和-S
   5.2 執行WSDL2Java, 生成skeleton類:
       java org.apache.axis.wsdl.WSDL2Java -s -S true BluePower.wsdl
       將生成：  A skeleton class
                  An implementation template class
                  One deploy.wsdd file
                  One undeploy.wsdd file
   5.3 執行WSDL2Java, 不生成skeleton類:
       java org.apache.axis.wsdl.WSDL2Java -s BluePower.wsdl
       將生成：  
                  An implementation template class
                  One deploy.wsdd file
                  One undeploy.wsdd file
       (我們發現少了一個A skeleton class)
   5.4 名字解釋：
   Skeleton class:
      它是Axis engine 和 the actual service implementation 類之間的一個代理類。
       The skeleton contains an implementation of the AddressBook service.
       This implementation is either passed into the skeleton on construction,
       or an instance of the generated implementation is created.
       When the Axis engine calls the skeleton's addEntry method,
       it simply delegates the invocation to the real implementation's addEntry method.
   Implementation Template class:
       它就是我們的實際服務器端的實現代碼，我們要在不同的方法裏寫具體的實現處理。
      
6. 根據deploy.wsdd生成server-config.wsdd:
  這裏比較模糊，我暫時的方法是：
  先部署一個web服務器，如用resin，然後把第5步生成的類文件放到classes下(eclipse可以指定編譯路徑)，
  把deploy.wsdd放到classes上一目錄，也就是WEB-INF下，運行命令：
  java -cp %AXIS_CLASSPATH% org.apache.axis.client.AdminClient -lhttp://localhost:8080/test/services/MyServer deploy.wsdd
  若出現：<Admin>Done processing</Admin>則成功，若出現失敗，則具體情況具體分析。
  成功後，當前目錄就會生成server-config.wsdd文件。
  注意：爲什麼這裏用%AXIS_CLASSPATH%, 因爲直接把這些jar配置在CLASSPATH裏，調用log4j時有衝突。最好不要放到CLASSPATH
 
7. server-config.wsdd文件裏的未解決的數組類型問題：
  若接口參數或返回值有數組，則會生成ArrayMapping的配置，而在resin下配置axis的servlet去裝載，就是不行。
  暫時的解決方法是，把這些數組類型就聲明爲一般類型，就能裝載了；客戶端用數組類型訪問，服務器也能正常
  解析出來，返回給客戶端的數組類型，客戶端也能正常解析。