通過使用 Eclipse 插件，可以執(zhí)行服務(wù)器的基本管理工作，還可以為 Community Edition 服務(wù)器開發(fā)和部署 J2EE
應(yīng)用程序并進行測試。此外，如果希望開發(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 Standard
Edition (J2SE) SDK；僅有 J2SE Java Runtime Environment (JRE) 并不夠。有關(guān)
Community Edition 和該插件工具的建議平臺和 Java 環(huán)境，請參閱產(chǎn)品文檔（請參見參考資料）。
下載和安裝
Eclipse 插件工具可以從產(chǎn)品網(wǎng)站免費下載。要下載的文件是 wasce_eclipse_plugin zip 文件。
在嘗試安裝該插件工具前，請安裝上述所有必備軟件。該插件工具的安裝較為簡單：直接將 wasce_eclipse_plugin zip 文件的內(nèi)容解壓縮到 Eclipse 主目錄即可。
回頁首
基本服務(wù)器管理
請按照以下管理步驟開始使用 Eclipse 插件：
-
啟動 Eclipse：
-
要在安裝了 Eclipse 插件工具后首次啟動該工具，請打開命令提示符，并導(dǎo)航到 eclipse_home 目錄，其中 eclipse_home 是您的 Eclipse 安裝目錄。
-
在命令行鍵入 eclipse -clean，以啟動 Eclipse。-clean 選項將確保對新插件工具進行識別。在 Eclipse 的后續(xù)啟動中并不需要使用此選項。
-
切換到 J2EE 透視圖，該透視圖是使用 Eclipse 框架開發(fā) J2EE 應(yīng)用程序的首選透視圖。如果尚未進入 J2EE 透視圖，請選擇 Windows => Open Perspective => Other...，然后在 Select Perspective 面板選擇 J2EE，并單擊 OK。
-
在服務(wù)器上執(zhí)行任何部署或測試活動前，必須定義一個新服務(wù)器和服務(wù)器運行時，這兩個都是 WTP 中的概念：
要定義新 Community Edition 服務(wù)器和服務(wù)器運行時，請執(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 的值進行相應(yīng)的更改，然后單擊 Finish。
圖 1 顯示了 J2EE 透視圖中新定義的服務(wù)器。
圖 1. 新定義的服務(wù)器
-
啟動和停止服務(wù)器：
要使用 Eclipse 框架啟動服務(wù)器，請執(zhí)行以下步驟：
- 在 J2EE 透視圖中，打開 Servers 視圖。
- 在 Servers 面板上右鍵單擊要啟動的服務(wù)器。
- 在出現(xiàn)的上下文菜單上單擊 Start。
要使用 Eclipse 框架停止服務(wù)器，請執(zhí)行以下操作：
- 在 J2EE 透視圖中，打開 Servers 視圖。
- 在 Servers 面板上右鍵單擊要停止的服務(wù)器。
- 在出現(xiàn)的上下文菜單中單擊 Stop。
除了啟動和停止外，還可以右鍵單擊服務(wù)器并選擇其他操作，如 Delete、Restart、Debug、Publish、Add and Remove Projects 或 Launch Geronimo Console。Eclipse 插件監(jiān)視服務(wù)器的狀態(tài)，并相應(yīng)地設(shè)置已停止、正在啟動和已啟動指示器。即使并未使用 Eclipse 啟動或停止服務(wù)器，或服務(wù)器是遠程服務(wù)器，此信息也是準確的。
回頁首
創(chuàng)建和部署第一個程序
產(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)用程序的源代碼和二進制形式文件。如果導(dǎo)航到 src\webapp，會看到這是一個非常簡單的 Web 應(yīng)用程序。
-
啟動 Eclipse，切換到 J2EE 透視圖，并定義一個新服務(wù)器和服務(wù)器運行時。
-
啟動服務(wù)器
-
導(dǎo)入或創(chuàng)建新 J2EE 項目時，請確保計算機具有 Internet 接入。可能要求您接受 Sun Microsystems?
許可證，以便 Eclipse 能緩存部署描述符和與項目關(guān)聯(lián)的其他 XML 文件的文檔類型定義（document type
definition，DTD）和 XML 模式定義（XML schema definition，XSD）。如果沒有 Internet
接入，相應(yīng)進程可能會被掛起或非常緩慢。
-
將 Hello 應(yīng)用程序?qū)?Eclipse IDE：
- 在 Eclipse 菜單欄上，單擊 File 并選擇 Import...。
- 在 Import 面板上，選擇 WAR file，然后單擊 Next。
- 在 War Import 面板上，導(dǎo)航到
samples_install\samples\wasce\hello\target\hello-1.0.war，以將其作為 WAR file 的值，其中 samples_install 為示例安裝目錄。將前面定義的服務(wù)器運行時設(shè)置為目標運行時。取消選中 add module to an EAR application 并單擊 Finish。
圖 2 顯示了已導(dǎo)入 Eclipse 中的 Hello 應(yīng)用程序。Geronimo Web 部署計劃 (geronimo-web.xml) 旁邊的 G
圖標指示該計劃可以使用 Geronimo Web
部署計劃編輯器進行識別和查看；否則，如果沒有此標志，將使用普通文本編輯器對此計劃進行查看。開發(fā) J2EE 應(yīng)用程序時，請確保 Geronimo
部署計劃可以使用 Geronimo Web 部署計劃編輯器進行識別和查看，以便您的應(yīng)用程序能部署到 Community Edition 服務(wù)器。
圖 2. 已導(dǎo)入 Eclipse 中的 Hello 應(yīng)用程序
或者，也可以采用以下步驟創(chuàng)建一個新 Hello 項目：
- 在 Eclipse 菜單欄上，選擇 File => New => Project...。
- 在 New Project 面板上，展開 Web 并選擇 Dynamic Web Project。單擊 Next。
- 在 Dynamic Web Project 面板上指定項目名稱，如
Hello。確保 target runtime 的值為前面定義的服務(wù)器運行時，并確保取消選中了 Add module to an EAR application。單擊 Next。
- 由于我們將從 Hello 示例應(yīng)用程序使用計劃，因此請在 Select project facets 面板上取消選中 Geronimo Deployment Plans。單擊 Finish。
- 將 samples_install\samples\wasce\hello\src\webapp\index.jsp 復(fù)制到 workspace\hello\WebContent 目錄，其中 samples_install 是示例安裝目錄，而 workspace 是您的 Eclipse IDE 的當前工作區(qū)。
- 另外，還要將 samples_install\samples\wasce\hello\src\webapp\WEB-INF\geronimo-web.xml 文件復(fù)制到 workspace\hello\WebContent\WEB-INF 目錄。
- 在 Project Explorer 視圖上，導(dǎo)航到 Hello 項目，單擊右鍵，并選擇 Refresh，以刷新項目。應(yīng)該會看到 geronimo-web.xml 和 index.jsp 文件。
-
將 Hello 項目部署到服務(wù)器：
- 在 Project Explorer 視圖上，右鍵單擊 Hello 項目，并選擇 Run As => Run on Server。
- 在 Run on server 面板上，使 Choose an existing server 選項保持選中狀態(tài)并選擇前面定義的服務(wù)器。如果不希望以后再次詢問要使用的服務(wù)器，請選中 Set server as project default (do not ask again)。
- 單擊 Next，以查看工作區(qū)中可用項目列表和已部署到該服務(wù)器的項目列表。單擊 Finish。
應(yīng)該看到 http://localhost:8080/hello 已在 Eclipse IDE 內(nèi)新啟動的內(nèi)部 Web 瀏覽器中打開。
圖 3. Eclipse 中的 Hello 應(yīng)用程序
現(xiàn)在已經(jīng)成功部署并運行了 Hello
應(yīng)用程序。這再簡單不過了。如果要部署更為復(fù)雜的應(yīng)用程序（例如，對外部庫有依賴關(guān)系的應(yīng)用程序或需要將很多資源引用映射到實際資源的應(yīng)用程序），可以使
用 Geronimo 部署計劃編輯器來構(gòu)建計劃。部署計劃編輯器僅是最低要求。在某些情況下，您將需要使用 Source 視圖來驗證部署計劃中的其他配置和部署元素。
回頁首
調(diào)試您的第一個應(yīng)用程序
可以采用調(diào)試狀態(tài)啟動服務(wù)器，并添加斷點來調(diào)試您的應(yīng)用程序。讓我們再次使用 Hello 應(yīng)用程序作為例子，以說明如何使用 Eclipse 調(diào)試您的應(yīng)用程序。
-
更新 hello.jsp，在其中添加一個名為 hello 的新字符串（圖 4）。
-
在第 6 行添加一個斷點，并保存更改。
-
以調(diào)試狀態(tài)啟動服務(wù)器。如果服務(wù)器已經(jīng)在運行，請在 Servers 視圖中右鍵單擊服務(wù)器，并選擇 Restart => Debug。如果服務(wù)器已經(jīng)停止，請在 Servers 視圖中右鍵單擊服務(wù)器，并選擇 Debug。
-
等待服務(wù)器狀態(tài)更改為 Debugging。
圖 4. 已更新的 Hello 應(yīng)用程序
-
在 Project Explorer 視圖中，右鍵單擊 Hello 項目，并選擇 Debug as => Debug on Server。
更改到 Debug 透視圖（如果未自動更改）。將對新創(chuàng)建的 JSP
進行編譯，并將應(yīng)用程序重新部署到服務(wù)器，調(diào)試器將在放置了斷點的代碼行停止?，F(xiàn)在可以單步執(zhí)行您的
JSP，逐步查看變量值的更改情況。繼續(xù)執(zhí)行時（使用綠色箭頭），JSP 將會在 Web 瀏覽器中打開。
圖 5. 調(diào)試 Hello 應(yīng)用程序
回頁首
使用 J2EE 分析功能
Geronimo 服務(wù)器運行時包含該服務(wù)器唯一的類。如果在 J2EE
資產(chǎn)中使用任何唯一類，則無法將這些資產(chǎn)部署到任何其他應(yīng)用服務(wù)器上。換句話說，您的 J2EE 應(yīng)用程序?qū)⒉痪哂锌梢浦残?。如果希望開發(fā)可移植的
J2EE 應(yīng)用程序，請使用 Eclipse 插件中包含的 J2EE 分析功能。
并不需要執(zhí)行特殊的步驟來安裝 J2EE 分析功能。只要將 Geronimo 服務(wù)器定義為項目的目標運行時，就包含此功能，可供您的項目使用。如果您的項目使用非 J2EE API，保存項目時會在 Problems 視圖中顯示警告，指示采用的是不推薦的訪問方式。有關(guān)如何打開和關(guān)閉不推薦訪問警告的信息，請參閱產(chǎn)品文檔（請參見參考資料）。
回頁首
故障排除
日志記錄
遇到問題時，首先需要查看的就是日志：
- 在 Eclipse IDE 中的 Console 視圖查看服務(wù)器控制臺輸出。缺省服務(wù)器控制臺輸出級別為 INFO。要將服務(wù)器控制臺輸出級別設(shè)置為 DEBUG，請在 Servers 視圖中雙擊服務(wù)器。在 Server Overview 面板上，將控制臺輸出級別設(shè)置為 DEBUG，然后保存更改。
- 選中 workspace\.metadata\.log 文件，其中 workspace 是您的 Eclipse IDE 的當前工作區(qū)。
- Community Edition 服務(wù)器日志位于 installDir/var/log 目錄，其中 installDir 是服務(wù)器的安裝目錄。server.log 文件包含服務(wù)器啟動、部署、配置、應(yīng)用程序運行和服務(wù)器關(guān)閉數(shù)據(jù)。
購買支持服務(wù)
雖然 WebSphere Application Server Community Edition 是免費的，您仍然可以按年度購買支持服務(wù)。有關(guān)詳細信息，請參閱 Technical Support Offerings for WebSphere Application Server Community Edition。
