開(kāi)發(fā)環(huán)境
Sun Java 5+ Eclipse 3.2 +MyEclipse 5.0.0.
概述
本文介紹了使用MyEclipse Web Service來(lái)迅速開(kāi)發(fā)和測試一個(gè)HelloWorld Web Service,其中包括:
1. 介紹了MyEclipse Web Services的基本概念
2. 創(chuàng )建一個(gè)MyEclipse Web Services工程
3. 創(chuàng )建一個(gè)簡(jiǎn)單的HelloWorld Web Service
4. 在Web容器中,如Tomcat 5中部署Web Service
5. 使用Web Services Explorer來(lái)測試部署的Web Services
XFire Java SOAP框架概述
MyEclipse Web Services是建立在XFire Java SOAP框架和工具基礎上的, XFire是一款開(kāi)源的Java SOAP框架。它擁有一個(gè)輕量級的信息處理模塊，通過(guò)STAX來(lái)與SOAP信息相結合。提供了一個(gè)工作在Web Services下的簡(jiǎn)單API，支持POJO和schema開(kāi)發(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中引入了一個(gè)新的工程類(lèi)型即Web Service工程,該工程擴展了MyEclipse Web Project來(lái)支持額外的Web Service配置,開(kāi)發(fā)和部署.本部分將使用Web Services Project wizard來(lái)創(chuàng )建和配置一個(gè)新的Web Service Projects Web Service Wizard將完成下列的動(dòng)作:
創(chuàng )建MyEclipse J2EE Web Project
在工程中的web.xml文件中配置XFire Servlet
創(chuàng )建XFire services.xml配置文件
在工程中的構建路徑中添加MyEclipse-XFire類(lèi)庫
添加一個(gè)指定的MyEclipse web project builder到.projects文件,以便部署services.xml文件到它合適的位置.如: <webroot>/WEB-INF/classes/META-INF/xfire/
運行Web Service Project Wizard
該向導包括三個(gè)頁(yè)面, Page-1搜集Web Project配置細節, Page-2搜集XFire配置細節, Page-3在新建的構建路徑中配置XFire類(lèi)庫
1. 執行Web Services Project Wizard.
1). 選擇File>New>Other
2). 擴展MyEclipse種類(lèi)按照J2EE工程的種類(lèi)
3). 選擇Web Services Project然后點(diǎn)擊Next,如圖所示
Figure-1: New Project Wizard Launcher
2. 添加Project Name,點(diǎn)擊Next
Figure-2: Page-2, Collecting web configuration details
3.在向導的Page-2中添加X(jué)Fire servlet和service.xml文件的配置信息,按照默認的值即可.
Figure-3: XFire servlet and services.xml configuration
4.在向導的Page-3中選擇類(lèi)庫添加到工程的構建路徑中,其中XFire Core Library是需要的,如果要在工程中開(kāi)發(fā)一個(gè)客戶(hù)端應用, XFire HTTP Client Libraries也是需要的.
Figure-4: Selecting XFire libraries to add to new web service project buildpath
5選擇Finish完成Web Service工程的創(chuàng )建過(guò)程
Figure-5,顯示了新創(chuàng )建的HelloWorld Web Service工程的組織結構,Web Service 工程和一個(gè)標準的MyEclipse Web工程很相似. XFire Web Service配置元素如圖紅色區域顯示:
Figure-5: Web services artifacts of a new web service project
二. 創(chuàng )建Web Service-Code-first Strategy
在這部分將用MyEclipse Web Service Wizard并通過(guò)使用Code-first Strategy來(lái)創(chuàng )建一個(gè)HelloWorldService示例.
1. 執行MyEclipse Web Service Wizard,有兩種方法來(lái)執行MyEclipse Web Service Wizard
方法1.從MyEclipse perspective toolbar中來(lái)執行向導
在打開(kāi)的Web Service Wizard上的workbench上來(lái)選擇新Web Service按鈕
方法2.從workbench menubar執行向導
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. 填寫(xiě)Web Service的名字HelloWorldService
5. 選擇Java Source folder或者選擇New按鈕來(lái)新建一個(gè)source folder
6. 填寫(xiě)Java package或者通過(guò)選擇Browse按鈕來(lái)選擇一個(gè)已經(jīng)存在的package.也可以選擇New按鈕來(lái)新建一個(gè)Java package
注意:對Service接口和Service執行的類(lèi)的默認值是基于所填入Web Service名字來(lái)產(chǎn)生的.
7. 選擇Next來(lái)初始化Web Service的創(chuàng )建過(guò)程
Figure-8: Page-2 of new web service wizard.
該向導產(chǎn)生了IHelloWorldService Java接口和HelloWorldServiceImpl Java類(lèi).并且在services.xml配置文件中創(chuàng )建了一個(gè)<service>實(shí)體(如圖所示),注意到example(String message)方法在接口類(lèi)中產(chǎn)生,當Web Service部署后作為一個(gè)測試操作.
Figure-9: Newly created HelloWorld interface and implementation class
三. 部署Web Service Project
Web Service可以部署在任何MyEclipse支持的J2EE應用服務(wù)器上,該部分將演示如何在Tomcat 5 Web容器上部署HelloWorld工程.
3.1部署HelloWorld Web Service Project
Figure-10顯示了如何部署HelloWorld應用.
1. 從Server Manager中選擇Deployer按鈕(step-1)
2. 在Server Deployments對話(huà)框中選擇Add to create a new deployment (step-2)
3. 在New Deployment對話(huà)框中選擇HelloWorld工程并選擇Exploded Archive選項
4. 在New Deployment對話(huà)框選擇Finish來(lái)將HelloWorld在Tomcat 5默認的位置中打包為WAR
5. 選擇OK完成部署
Figure-10: Three-step deployment process
新HelloWorld WAR部署將出現在Server Manager視圖中Tomcat 5節點(diǎn)下.
Figure-11: Servers Manager View depicting deployed HelloWorld web service project
四. 啟動(dòng)Tomcat服務(wù)器
五. 使用Web Service Explorer測試Web Service
MyEclipse提供了一個(gè)Web Service Explorer來(lái)測試Web Service.
1. 在MyEclipse perspective中選擇toolbar button來(lái)執行Web Service Explorer
Figure-15: Web Services Explorer launch button on workbench toolbar
2. 選擇WSDL模式(Figure-16)
3. 在活動(dòng)面板中鍵入HelloWorldService WSDL文檔的URLhttp://localhost:8080/HelloWorld/services/HelloWorldService?WSDL,Web Service Explorer將下載自動(dòng)產(chǎn)生的WSDL文檔,該WSDL文檔由XFire framework,并產(chǎn)生一系列的操作能夠調用service.
4. 在活動(dòng)面板中選擇example操作并在in0域中鍵入HelloWorld
5. 選擇Go按鈕來(lái)調用在HelloWorldService上的example操作,,結果出現在Status面板上
Figure-16: Web Services Explorer testing HelloWorldService
六. 創(chuàng )建Java Test客戶(hù)端
XFire提供了一個(gè)動(dòng)態(tài)的代理框架,能夠讀取WSDL文檔和創(chuàng )建潛在的消息服務(wù)使Java類(lèi)來(lái)執行在Web Service的行為.該部分將為HelloWorld Web Service寫(xiě)一個(gè)Java Web Service客戶(hù)端
6.1增加X(jué)Fire類(lèi)庫配置
為了使example client能夠在HelloWorld工程中運行,需要增加X(jué)Fire HTTP Client類(lèi)庫到工程的構建路徑中.
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類(lèi)
執行Java類(lèi)向導來(lái)創(chuàng )建HelloWorldClient類(lèi)
Figure-18: HelloWorldClient defined in New Java Class Wizard.
代碼如下:
public static void main(String[] args) ...{
Service srvcModel = new
ObjectServiceFactory().create(IHelloWorldService.class);
XFireProxyFactory factory =
new XFireProxyFactory(XFireFactory.newInstance().getXFire());
String helloWorldURL =
"http://localhost:8080/HelloWorld/services/HelloWorldService";
try ...{
IHelloWorldService srvc = (IHelloWorldService)factory.create(srvcModel, helloWorldURL);
String result = srvc.example("hello world");
System.out.print(result);
} catch (MalformedURLException e) ...{
e.printStackTrace();
}
}
該段代碼定義了創(chuàng )建一個(gè)XFire web service proxy的過(guò)程,該代理支持POJO IHelloWorldService接口
右鍵點(diǎn)擊Run As>Java Application或者Debug As>JavaApplication來(lái)運行或調試該程序
