1.准備工作：
概念：SOAP（簡單對象訪問協議）、WSDL（web服務描述語言）、XML（可擴展標記語言）、axis（阿帕奇可擴展交互系統）
（1） 下載axis1.4，將axis1.4中的axis項目中WEB-INF\lib，將lib下的jar文件拷貝到工程如webservice的WEB-INF\lib下
（2） 將axis1.4中的axis項目，拷貝到tomcat的webapps目錄下
（3） 配置Java和Tomcat環境,設置axis環境，類似jdk的配置方法，例如：
| AXIS_HOME= E:\apache-tomcat-6.0.37-windows-x86\apache-tomcat-6.0.37\webapps\axis AXIS_LIB=%AXIS_HOME%\lib AXISCLASSPATH=%AXIS_LIB%\axis.jar;%AXIS_LIB%\commons-discovery-0.2.jar;%AXIS_LIB%\commons-logging-1.0.4.jar;%AXIS_LIB%\jaxrpc.jar;%AXIS_LIB%\saaj.jar;%AXIS_LIB%\log4j-1.2.8.jar;AXIS_LIB%\xml-apis.jar;%AXIS_LIB%\xercesImpl.jar （最后兩個可能沒有，不是必須的） |
（4） 配置web.xml添加
| <?xml version="1.0" encoding="ISO-8859-1"?> <!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd"> <web-app> <display-name>Apache-Axis</display-name> <listener> <listener-class>org.apache.axis.transport.http.AxisHTTPSessionListener</listener-class> </listener> <servlet> <servlet-name>AxisServlet</servlet-name> <display-name>Apache-Axis Servlet</display-name> <servlet-class> org.apache.axis.transport.http.AxisServlet </servlet-class> </servlet> <servlet> <servlet-name>AdminServlet</servlet-name> <display-name>Axis Admin Servlet</display-name> <servlet-class> org.apache.axis.transport.http.AdminServlet </servlet-class> <load-on-startup>100</load-on-startup> </servlet> <servlet> <servlet-name>SOAPMonitorService</servlet-name> <display-name>SOAPMonitorService</display-name> <servlet-class> org.apache.axis.monitor.SOAPMonitorService </servlet-class> <init-param> <param-name>SOAPMonitorPort</param-name> <param-value>5001</param-value> </init-param> <load-on-startup>100</load-on-startup> </servlet> <servlet-mapping> <servlet-name>AxisServlet</servlet-name> <url-pattern>/servlet/AxisServlet</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>AxisServlet</servlet-name> <url-pattern>*.jws</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>AxisServlet</servlet-name> <url-pattern>/services/*</url-pattern> </servlet-mapping> <servlet-mapping <servlet-name>SOAPMonitorService</servlet-name> <url-pattern>/SOAPMonitor</url-pattern> </servlet-mapping> <session-config> <session-timeout>5</session-timeout> </session-config> <mime-mapping> <extension>wsdl</extension> <mime-type>text/xml</mime-type> </mime-mapping> <mime-mapping> <extension>xsd</extension> <mime-type>text/xml</mime-type> </mime-mapping> <welcome-file-list id="WelcomeFileList"> <welcome-file>index.jsp</welcome-file> <welcome-file>index.html</welcome-file> <welcome-file>index.jws</welcome-file> </welcome-file-list> </web-app>
|
2.實戰
1.業務方法類的入參bean
Request.java
| package com.webservice.request;
import java.util.ArrayList; import java.util.List;
public class Request {
// 基本類型 private String msg;
// 基本類型 ，list會在客戶端生成對象數組Object[] private List<Integer> list = new ArrayList<Integer>();
// 不要使用數組，因為要指定大小，應該使用list替代 // private String[] array;
public List<Integer> getList() { return list; }
public String getMsg() { return msg; }
public void setList(List<Integer> list) { this.list = list; }
public void setMsg(String msg) { this.msg = msg; }
}
|
2. 業務方法類的回參bean
Response.java
| package com.webservice.respone;
import java.util.ArrayList; import java.util.List;
public class Response {
// 基本類型 private int code;
private String errorMsg;
// 基本類型 ，list會在客戶端生成對象數組Object[] private List<Integer> list = new ArrayList<Integer>();
// 不要使用數組，因為要指定大小，應該使用list替代 // private String[] array;
public int getCode() { return code; }
public void setCode(int code) { this.code = code; }
public String getErrorMsg() { return errorMsg; }
public void setErrorMsg(String errorMsg) { this.errorMsg = errorMsg; }
public List<Integer> getList() { return list; }
public void setList(List<Integer> list) { this.list = list; }
}
|
3. 業務方法類service，以上面兩個bean作為入參和回參
BusinessService.java
| package com.webservice.service;
import java.util.List;
import com.webservice.request.Request; import com.webservice.respone.Response;
public class BusinessService {
public Response send(Request request)
{ Response response = new Response();
try { //接收基本類型信息 String msg = request.getMsg();
//接收list List<Integer> integerList = request.getList();
System.out.println("收到基本類型消息：msg=" + msg); System.out.println("收到List<Integer>類型消息：list=" + integerList);
//組織反饋 if (null != msg && !"".equals(msg)) { //設置錯誤碼 response.setCode(0); //設置錯誤消息 response.setErrorMsg("調用成功"); //設置list response.setList(request.getList());
} else { response.setCode(-1); response.setErrorMsg("消息不能為空"); } } catch (Exception e) { response.setCode(-1); response.setErrorMsg("發生異常:" + e.getMessage()); } return response; } }
|
4.在工程的WEB-INF目錄下 編寫deploy.wsdd
主要用來定義service名字，描述service、入參、回參
| <deployment xmlns="http://xml.apache.org/axis/wsdd/" xmlns:java="http://xml.apache.org/axis/wsdd/providers/java"> <service name="businessService" provider="java:RPC"> <parameter name="className" value="com.webservice.service.BusinessService" /> <parameter name="allowedMethods" value="*" /> <beanMapping qname="myNS:Request" xmlns:myNS="urn:BeanService" languageSpecificType="java:com.webservice.request.Request" /> <beanMapping qname="myNS:Response" xmlns:myNS="urn:BeanService" languageSpecificType="java:com.webservice.respone.Response" /> </service> </deployment> |
5. 在工程的WEB-INF目錄下編寫undeploy.wsdd
用來卸載webservice服務
| <undeployment xmlns="http://xml.apache.org/axis/wsdd/"> <service name="businessService"/> </undeployment> |
6. 部署項目（啟動tomcat），接下來發布接口（關鍵一步）
進入到tomcat的項目中的WEB-INF目錄下，執行下列命令進行發布。會在此WEB-INF下生成server-config.wsdd文件（以后可以在此目錄配置其他接口）
| java -Djava.ext.dirs=lib org.apache.axis.client.AdminClient -lhttp://192.168.30.143:8080/webservice/servlet/AxisServlet deploy.wsdd |
Ps：下面命令用於取消一個已經發布的服務
| java -Djava.ext.dirs=lib org.apache.axis.client.AdminClient -lhttp://192.168.30.143:8080/webservice/servlet/AxisServlet undeploy.wsdd |
7.獲取wsdl（完成）
（1）重啟tomcat，訪問工程目錄，如：http://192.168.30.143:8080/webservice/servlet/AxisServlet（其中webservice為工程名）
（2）可以看到新的服務方法businessService，點擊一下，跳到wsdl內容頁面，ctr+A拷貝到文本編輯器，去掉開頭的空格，替換去掉所有開頭的“-”為空（即將- <替換為<）;另存為businessService.wsdl，即可提供其他方使用，注意：如果部署在linux上，要訪問linux的網頁獲取wsdl，不然可能會有問題。
-----------------------------------------------至此發布完畢------------------------------------------------
3.測試驗證
1.根據wsdl生成客戶端代碼
（1）首先制作生成代碼工具，方便以后重用；
在D:\webservice，放個axis1.4的包，創建一個批處理文件“wsdl生成java客戶端文件.bat”，內容如下：根據實際情況配置
| set Axis_Lib=D:\webservice\axis1.4\axis\WEB-INF\lib set Java_Cmd=java -Djava.ext.dirs=%Axis_Lib% set Output_Path=D:\webservice\Testclient set Package=com.webservice.client %Java_Cmd% org.apache.axis.wsdl.WSDL2Java -o%Output_Path% -p%Package% D:\webservice\businessService.wsdl @echo -------------OK----------------- @echo ---The code has been created in the folder: Testclient--- @pause |
說明：藍色部分根據實際情況調整
Axis_Lib 是axis1.4的lib位置
Output_Path是生成客戶端代碼存放位置
Package 是生成客戶端代碼所在包
最后是wsdl文件位置
（2）生成客戶端代碼
將wsdl文件，如businessService.wsdl放到D:\webservice下（上一步應該做了），執行文件“wsdl生成java客戶端文件.bat”，即可生成客戶端代碼，在Testclient目錄。
2.測試接口
將生成的客戶端帶拷貝到java或其他web工程的src下
建立測試java類，如Test.java,測試完成
| public class Test { public static void main(String[] args) throws RemoteException, ServiceException, MalformedURLException { // BusinessServiceService為接口；BusinessServiceServiceLocator為接口實現類 BusinessServiceService service = new BusinessServiceServiceLocator(); // 設置要使用的接口服務地址:多用於動態調用不同服務器上的接口 URL portAddress = new URL( "http://192.168.30.143:8080/webservice/services/businessService"); BusinessService client = service.getbusinessService(portAddress);
Request requestBean = new Request();
// 傳遞簡單類型 requestBean.setMsg("wwww.servyou.com.cn");
// 傳遞數組，最好先由list轉化 List<Integer> list = new ArrayList<Integer>(); for (int i = 0; i < 10; i++) { list.add(i); } requestBean.setList(list.toArray());
// 調用webservice Response resp = client.send(requestBean); System.out.println("消息已發送...");
//接收返回結果 int code = resp.getCode(); String errorMsg = resp.getErrorMsg();
Object[] integerList = resp.getList();
System.out.println("收到消息:"); System.out.println("錯誤碼 code="+code); System.out.println("消息 errorMsg="+errorMsg); System.out.println("收到List<Integer>類型消息：list=" + Arrays.toString(integerList)); } }
|
服務端運行結果：
| 收到基本類型消息：msg=wwww.servyou.com.cn 收到List<Integer>類型消息：list=[0, 1, 2, 3, 4, 5, 6, 7, 8, 9] |
客戶端運行結果：
| 消息已發送... 收到消息: 錯誤碼 code=0 消息 errorMsg=調用成功 收到List<Integer>類型消息：list=[0, 1, 2, 3, 4, 5, 6, 7, 8, 9] |