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