從心開始

???來源：http://tech.it168.com/j/e/2006-10-28/200610281432707.shtml??? （紅色部分為實驗批注）

附：MyEclipse 5.0 官方提供的圖文教程：

http://www.myeclipseide.com/ContentExpress-display-ceid-81.html#webservices

???開發(fā)環(huán)境
??? Sun Java 5+ Eclipse 3.2 +MyEclipse 5.0.0.?

??? 概述?

??? 本文介紹了使用MyEclipse Web Service來迅速開發(fā)和測試一個HelloWorld Web Service,其中包括:?
??? 1. 介紹了MyEclipse Web Services的基本概念?
??? 2. 創(chuàng)建一個MyEclipse Web Services工程?
??? 3. 創(chuàng)建一個簡單的HelloWorld Web Service?
??? 4. 在Web容器中,如Tomcat 5中部署Web Service?
??? 5. 使用Web Services Explorer來測試部署的Web Services?

??? XFire Java SOAP框架概述?
??? MyEclipse Web Services是建立在XFire Java SOAP框架和工具基礎上的, XFire是一款開源的Java SOAP框架。它擁有一個輕量級的信息處理模塊，通過STAX來與SOAP信息相結合。提供了一個工作在Web Services下的簡單API，支持POJO和schema開發(fā). XFire支持 Web Services standards,Spring 整合, 支持JBI , 支持 JAXB ,XMLBeans,Java 5 和JAX-WS.并支持HTTP, JMS, XMPP, In-memory傳輸協(xié)議.?

??? 一. 創(chuàng)建Web Service工程?

??? 在MyEclipse 5.0中引入了一個新的工程類型即Web Service工程,該工程擴展了MyEclipse Web Project來支持額外的Web Service配置,開發(fā)和部署.本部分將使用Web Services Project wizard來創(chuàng)建和配置一個新的Web Service Projects Web Service Wizard將完成下列的動作:?
??? 創(chuàng)建MyEclipse J2EE Web Project?
??? 在工程中的web.xml文件中配置XFire Servlet?
??? 創(chuàng)建XFire services.xml配置文件?
??? 在工程中的構建路徑中添加MyEclipse-XFire類庫?
??? 添加一個指定的MyEclipse web project builder到.projects文件,以便部署services.xml文件到它合適的位置.如: <webroot>/WEB-INF/classes/META-INF/xfire/?

??? 運行Web Service Project Wizard?
??? 該向導包括三個頁面, Page-1搜集Web Project配置細節(jié), Page-2搜集XFire配置細節(jié), Page-3在新建的構建路徑中配置XFire類庫?
??? 1. 執(zhí)行Web Services Project Wizard.?
?????? 1). 選擇File>New>Other?
?????? 2). 擴展MyEclipse種類按照J2EE工程的種類?
?????? 3). 選擇Web Services Project然后點擊Next,如圖所示

??? Figure-1: New Project Wizard Launcher?
??? 2. 添加Project Name,點擊Next

??? Figure-2: Page-2, Collecting web configuration details?
??? 3.在向導的Page-2中添加XFire servlet和service.xml文件的配置信息,按照默認的值即可.

??? Figure-3: XFire servlet and services.xml configuration
??? 4.在向導的Page-3中選擇類庫添加到工程的構建路徑中,其中XFire Core Library是需要的,如果要在工程中開發(fā)一個客戶端應用, XFire HTTP Client Libraries也是需要的.

??? Figure-4: Selecting XFire libraries to add to new web service project buildpath?

??? 5選擇Finish完成Web Service工程的創(chuàng)建過程?
??? Figure-5,顯示了新創(chuàng)建的HelloWorld Web Service工程的組織結構,Web Service 工程和一個標準的MyEclipse Web工程很相似. XFire Web Service配置元素如圖紅色區(qū)域顯示:

??? Figure-5: Web services artifacts of a new web service project?

??? 二. 創(chuàng)建Web Service-Code-first Strategy?
??? 在這部分將用MyEclipse Web Service Wizard并通過使用Code-first Strategy來創(chuàng)建一個HelloWorldService示例.?

??? 1. 執(zhí)行MyEclipse Web Service Wizard,有兩種方法來執(zhí)行MyEclipse Web Service Wizard?
??? 方法1.從MyEclipse perspective toolbar中來執(zhí)行向導?
??? 在打開的Web Service Wizard上的workbench上來選擇新Web Service按鈕?
??? 方法2.從workbench menubar執(zhí)行向導?
??? 1. 從workbench menubar選擇: File>New>Other>MyEclipse>Web Service

??? Figure-6: Launching Web Service Wizard?

??? 2. 在Page-1選擇HelloWorld 工程并選擇Create web service from Java bean?
??? 3. 選擇Next到Page-2

??? Figure-7: Page-1 of new web service wizard

??? 4. 填寫Web Service的名字HelloWorldService?
??? 5. 選擇Java Source folder或者選擇New按鈕來新建一個source folder?
??? 6. 填寫Java package或者通過選擇Browse按鈕來選擇一個已經存在的package.也可以選擇New按鈕來新建一個Java package?
??? 注意:對Service接口和Service執(zhí)行的類的默認值是基于所填入Web Service名字來產生的.?
??? 7. 選擇Next來初始化Web Service的創(chuàng)建過程

??? Figure-8: Page-2 of new web service wizard.?
??? 該向導產生了IHelloWorldService Java接口和HelloWorldServiceImpl Java類.并且在services.xml配置文件中創(chuàng)建了一個<service>實體(如圖所示),注意到example(String message)方法在接口類中產生,當Web Service部署后作為一個測試操作.

??? Figure-9: Newly created HelloWorld interface and implementation class?

Web Service 服務端服務接口代碼：


Web Service 服務端服務實現代碼：


????
??? 三. 部署Web Service Project?
??? Web Service可以部署在任何MyEclipse支持的J2EE應用服務器上,該部分將演示如何在Tomcat 5 Web容器上部署HelloWorld工程.?

??? 3.1部署HelloWorld Web Service Project?

??? Figure-10顯示了如何部署HelloWorld應用.?
??? 1. 從Server Manager中選擇Deployer按鈕(step-1)?
??? 2. 在Server Deployments對話框中選擇Add to create a new deployment (step-2)?
??? 3. 在New Deployment對話框中選擇HelloWorld工程并選擇Exploded Archive選項?
??? 4. 在New Deployment對話框選擇Finish來將HelloWorld在Tomcat 5默認的位置中打包為WAR?
??? 5. 選擇OK完成部署

??? Figure-10: Three-step deployment process?
??? 新HelloWorld WAR部署將出現在Server Manager視圖中Tomcat 5節(jié)點下.

??? Figure-11: Servers Manager View depicting deployed HelloWorld web service project

??? 四. 啟動Tomcat服務器?（或 JBoss 服務器）

??? 五. 使用Web Service Explorer測試Web Service?
??? MyEclipse提供了一個Web Service Explorer來測試Web Service.?
??? 1. 在MyEclipse perspective中選擇toolbar button來執(zhí)行Web Service Explorer

??? Figure-15: Web Services Explorer launch button on workbench toolbar?

??? 2. 選擇WSDL模式(Figure-16)?
??? 3. 在活動面板中鍵入HelloWorldService WSDL文檔的URL

http://localhost:8080/wstest/services/SampleService?WSDL

Web Service Explorer將下載自動產生的WSDL文檔,該WSDL文檔由XFire framework,并產生一系列的操作能夠調用service.?
??? 4. 在活動面板中選擇example操作并在in0域中鍵入HelloWorld?
??? 5. 選擇Go按鈕來調用在HelloWorldService上的example操作,,結果出現在Status面板上

??? Figure-16: Web Services Explorer testing HelloWorldService?

??? 六. 創(chuàng)建Java Test客戶端?
??? XFire提供了一個動態(tài)的代理框架,能夠讀取WSDL文檔和創(chuàng)建潛在的消息服務使Java類來執(zhí)行在Web Service的行為.該部分將為HelloWorld Web Service寫一個Java Web Service客戶端?
??? 6.1增加XFire類庫配置?
??? 為了使example client能夠在HelloWorld工程中運行,需要增加XFire HTTP Client類庫到工程的構建路徑中.?
??? 1. 在Package Explore視圖中右擊HelloWorld工程選擇Build Path>Add Library?
??? 2. 選擇MyEclipse Libraries?
??? 3. 選擇XFire HTTP Client Libraries

??? Figure-17: Choosing the XFire HTTP Client Libraries?
??? 4. 選擇Finish?
??? 6.2創(chuàng)建HelloWorldClient類?
??? 執(zhí)行Java類向導來創(chuàng)建HelloWorldClient類

??? Figure-18: HelloWorldClient defined in New Java Class Wizard.?

??? Web Service 客戶端代碼如下:


??? 該段代碼定義了創(chuàng)建一個XFire web service proxy的過程,該代理支持POJO IHelloWorldService接口?

??? 右鍵點擊Run As>Java Application或者Debug As>JavaApplication來運行或調試該程序