通過使用 Eclipse 插件,可以執(zhí)行服務(wù)器的基本管理工作,還可以為 Community Edition 服務(wù)器開發(fā)和部署 J2EE應(yīng)用程序并進(jìn)行測試。此外,如果希望開發(fā)可移植 J2EE 應(yīng)用程序,以便方便地部署到任何其他應(yīng)用服務(wù)器,可以使用該插件中包含的 J2EE分析功能。本文和 Tim Francis 的文章 Create, deploy, and debug Apache Geronimo applications 一起,提供了適用于 WebSphere Application Server Community Edition V1.0.1.1 的最新具體信息。
由于 Eclipse 插件工具依賴于 Eclipse 和 Web Tools Platform (WTP),因此您需要在安裝此插件工具前安裝以下軟件:
如果尚未安裝上述任何組件,可以改為下載 WTP All-In-One Bundle,該軟件包中包含所有必需的組件。
該插件工具還要求在建議的平臺上安裝 Community Edition 服務(wù)器,并建議安裝 32 位 Java 2 StandardEdition (J2SE) SDK;僅有 J2SE Java Runtime Environment (JRE) 并不夠。有關(guān)Community Edition 和該插件工具的建議平臺和 Java 環(huán)境,請參閱產(chǎn)品文檔(請參見參考資料)。
Eclipse 插件工具可以從產(chǎn)品網(wǎng)站免費(fèi)下載。要下載的文件是 wasce_eclipse_plugin zip 文件。
在嘗試安裝該插件工具前,請安裝上述所有必備軟件。該插件工具的安裝較為簡單:直接將 wasce_eclipse_plugin zip 文件的內(nèi)容解壓縮到 Eclipse 主目錄即可。
請按照以下管理步驟開始使用 Eclipse 插件:
要在安裝了 Eclipse 插件工具后首次啟動該工具,請打開命令提示符,并導(dǎo)航到 eclipse_home
目錄,其中 eclipse_home
是您的 Eclipse 安裝目錄。
在命令行鍵入 eclipse -clean
,以啟動 Eclipse。-clean
選項(xiàng)將確保對新插件工具進(jìn)行識別。在 Eclipse 的后續(xù)啟動中并不需要使用此選項(xiàng)。
切換到 J2EE 透視圖,該透視圖是使用 Eclipse 框架開發(fā) J2EE 應(yīng)用程序的首選透視圖。如果尚未進(jìn)入 J2EE 透視圖,請選擇 Windows => Open Perspective => Other...,然后在 Select Perspective 面板選擇 J2EE,并單擊 OK。
在服務(wù)器上執(zhí)行任何部署或測試活動前,必須定義一個新服務(wù)器和服務(wù)器運(yùn)行時,這兩個都是 WTP 中的概念:
服務(wù)器 是可以將 J2EE 應(yīng)用程序部署到其上的目標(biāo)服務(wù)器。它包含各種服務(wù)器信息,如主機(jī)名、端口號、管理員用戶名、密碼以及服務(wù)器類型。
服務(wù)器運(yùn)行時 由類庫及其對特定類型和版本的服務(wù)器的訪問規(guī)則。
要定義新 Community Edition 服務(wù)器和服務(wù)器運(yùn)行時,請執(zhí)行以下步驟:
在 Eclipse 菜單欄上,選擇 File => New => Other, then click Next。
在 Select a wizard 面板上,選擇 Server => Server,然后單擊 Next。
在 New Server 面板上,確保 Server host name 設(shè)置為 localhost。對于 Server type,請選擇 Apache, Apache Geronimo v1.0 Server。單擊 Next。
在 New Apache Geronimo v1.0 Server Runtime 面板上,指定 JRE 和 Community Edition 服務(wù)器安裝目錄,然后單擊 Next。
對 administrator name、password 和 ports 的值進(jìn)行相應(yīng)的更改,然后單擊 Finish。
圖 1 顯示了 J2EE 透視圖中新定義的服務(wù)器。
要使用 Eclipse 框架啟動服務(wù)器,請執(zhí)行以下步驟:
要使用 Eclipse 框架停止服務(wù)器,請執(zhí)行以下操作:
除了啟動和停止外,還可以右鍵單擊服務(wù)器并選擇其他操作,如 Delete、Restart、Debug、Publish、Add and Remove Projects 或 Launch Geronimo Console。Eclipse 插件監(jiān)視服務(wù)器的狀態(tài),并相應(yīng)地設(shè)置已停止、正在啟動和已啟動指示器。即使并未使用 Eclipse 啟動或停止服務(wù)器,或服務(wù)器是遠(yuǎn)程服務(wù)器,此信息也是準(zhǔn)確的。
產(chǎn)品網(wǎng)站提供的其中一個下載文件,它是包含示例應(yīng)用程序的 ZIP 文件。借助這些示例學(xué)習(xí)使用 Community Edition是一種非常好的方法。通過部署這些應(yīng)用程序中最簡單的程序 Hello 示例,可以了解在 Eclipse IDE中創(chuàng)建和部署您自己的應(yīng)用程序所需了解的基本知識,
從產(chǎn)品下載頁下載 wasce_samples zip 文件,并將其解壓縮到一個指定位置。
在 samples\wasce 目錄中,hello 目錄中同時包含了該應(yīng)用程序的源代碼和二進(jìn)制形式文件。如果導(dǎo)航到 src\webapp,會看到這是一個非常簡單的 Web 應(yīng)用程序。
啟動服務(wù)器
導(dǎo)入或創(chuàng)建新 J2EE 項(xiàng)目時,請確保計(jì)算機(jī)具有 Internet 接入??赡芤竽邮?Sun Microsystems? 許可證,以便 Eclipse 能緩存部署描述符和與項(xiàng)目關(guān)聯(lián)的其他 XML 文件的文檔類型定義(document type definition,DTD)和 XML 模式定義(XML schema definition,XSD)。如果沒有 Internet 接入,相應(yīng)進(jìn)程可能會被掛起或非常緩慢。
將 Hello 應(yīng)用程序?qū)?Eclipse IDE:
samples_install\samples\wasce\hello\target\hello-1.0.war
,以將其作為 WAR file 的值,其中 samples_install 為示例安裝目錄。將前面定義的服務(wù)器運(yùn)行時設(shè)置為目標(biāo)運(yùn)行時。取消選中 add module to an EAR application 并單擊 Finish。圖 2 顯示了已導(dǎo)入 Eclipse 中的 Hello 應(yīng)用程序。Geronimo Web 部署計(jì)劃 (geronimo-web.xml) 旁邊的 G 圖標(biāo)指示該計(jì)劃可以使用 Geronimo Web 部署計(jì)劃編輯器進(jìn)行識別和查看;否則,如果沒有此標(biāo)志,將使用普通文本編輯器對此計(jì)劃進(jìn)行查看。開發(fā) J2EE 應(yīng)用程序時,請確保 Geronimo 部署計(jì)劃可以使用 Geronimo Web 部署計(jì)劃編輯器進(jìn)行識別和查看,以便您的應(yīng)用程序能部署到 Community Edition 服務(wù)器。
或者,也可以采用以下步驟創(chuàng)建一個新 Hello 項(xiàng)目:
Hello
。確保 target runtime 的值為前面定義的服務(wù)器運(yùn)行時,并確保取消選中了 Add module to an EAR application。單擊 Next。將 Hello 項(xiàng)目部署到服務(wù)器:
應(yīng)該看到 http://localhost:8080/hello 已在 Eclipse IDE 內(nèi)新啟動的內(nèi)部 Web 瀏覽器中打開。
現(xiàn)在已經(jīng)成功部署并運(yùn)行了 Hello應(yīng)用程序。這再簡單不過了。如果要部署更為復(fù)雜的應(yīng)用程序(例如,對外部庫有依賴關(guān)系的應(yīng)用程序或需要將很多資源引用映射到實(shí)際資源的應(yīng)用程序),可以使用 Geronimo 部署計(jì)劃編輯器來構(gòu)建計(jì)劃。部署計(jì)劃編輯器僅是最低要求。在某些情況下,您將需要使用 Source 視圖來驗(yàn)證部署計(jì)劃中的其他配置和部署元素。
可以采用調(diào)試狀態(tài)啟動服務(wù)器,并添加斷點(diǎn)來調(diào)試您的應(yīng)用程序。讓我們再次使用 Hello 應(yīng)用程序作為例子,以說明如何使用 Eclipse 調(diào)試您的應(yīng)用程序。
更新 hello.jsp,在其中添加一個名為 hello
的新字符串(圖 4)。
在第 6 行添加一個斷點(diǎn),并保存更改。
以調(diào)試狀態(tài)啟動服務(wù)器。如果服務(wù)器已經(jīng)在運(yùn)行,請?jiān)?Servers 視圖中右鍵單擊服務(wù)器,并選擇 Restart => Debug。如果服務(wù)器已經(jīng)停止,請?jiān)?Servers 視圖中右鍵單擊服務(wù)器,并選擇 Debug。
等待服務(wù)器狀態(tài)更改為 Debugging。
在 Project Explorer 視圖中,右鍵單擊 Hello 項(xiàng)目,并選擇 Debug as => Debug on Server。 更改到 Debug 透視圖(如果未自動更改)。將對新創(chuàng)建的 JSP 進(jìn)行編譯,并將應(yīng)用程序重新部署到服務(wù)器,調(diào)試器將在放置了斷點(diǎn)的代碼行停止?,F(xiàn)在可以單步執(zhí)行您的 JSP,逐步查看變量值的更改情況。繼續(xù)執(zhí)行時(使用綠色箭頭),JSP 將會在 Web 瀏覽器中打開。
Geronimo 服務(wù)器運(yùn)行時包含該服務(wù)器唯一的類。如果在 J2EE資產(chǎn)中使用任何唯一類,則無法將這些資產(chǎn)部署到任何其他應(yīng)用服務(wù)器上。換句話說,您的 J2EE 應(yīng)用程序?qū)⒉痪哂锌梢浦残?。如果希望開發(fā)可移植的J2EE 應(yīng)用程序,請使用 Eclipse 插件中包含的 J2EE 分析功能。
并不需要執(zhí)行特殊的步驟來安裝 J2EE 分析功能。只要將 Geronimo 服務(wù)器定義為項(xiàng)目的目標(biāo)運(yùn)行時,就包含此功能,可供您的項(xiàng)目使用。如果您的項(xiàng)目使用非 J2EE API,保存項(xiàng)目時會在 Problems 視圖中顯示警告,指示采用的是不推薦的訪問方式。有關(guān)如何打開和關(guān)閉不推薦訪問警告的信息,請參閱產(chǎn)品文檔(請參見參考資料)。
遇到問題時,首先需要查看的就是日志:
雖然 WebSphere Application Server Community Edition 是免費(fèi)的,您仍然可以按年度購買支持服務(wù)。有關(guān)詳細(xì)信息,請參閱 Technical Support Offerings for WebSphere Application Server Community Edition。