Eclipse 3.1 WTP Web程序支持Beehive

2019-11-18 13:02:30

字體：大中小

來源：轉載

供稿：網友

　　下面闡述的是如何使一個Eclipse Web Tools Platform (WTP) Dynamic Web應用程序支持Apache Beehive。其中使用的開源工具包括：Eclipse 3.1.1、Web Tools Platform (WTP) 1.0M8、java Development Tools Annotation PRocessing Tool (JDT APT) beta和Apache Beehive 1.0。
　　
　　前提條件
　　
　　您已經啟動了Eclipse 3.1.1、WTP 1.0M8和JDT APT Beta，并且安裝了Apache Beehive 1.0。否則，請利用以下鏈接來設置環境：
　　Eclipse SDK 3.1.1：http://www.eclipse.org/downloads/index.php
　　WTP 1.0M8：http://download.eclipse.org/weBTools/downloads/drops/S-1.0M8-200509230840/
　　JDT APT beta：http://www.eclipse.org/jdt/apt/introToAPT.Html
　　Apache Beehive 1.0：http://beehive.apache.org/releases/release-1.0.cgi
　　
　　WTP Dynamic Web項目設置
　　
　　1. 創建新的Dynamic Web項目
　　
　　我們將通過New Project Wizard（新項目向導）創建一個WTP Dynamic Web項目。并對該項目加以調整，以便支持Apache Beehive。打開Project Wizard，然后利用以下信息填寫Wizard中的相關值：
　　
　　Project Wizard：　　　　　　　　　　　　Web -> Dynamic Web Project
　　
　　Name：　　　　　　　　　　　　　　　　　[此處填寫項目名稱]
　　
　　Show Advanced >>　　　　　　　　　　　　[選中]
　　
　　Target runtime -> New...　　　　　　　　BEA -> BEA WebLogic Server v9.0
　　使用默認的JRE
　　application Server Directory：[填寫WLS的安裝位置]
　　
　　Module Version：　　　　　　　　　　　　2.4
　　
　　Add module to an EAR application：　　　不選
　　（我們不想把這個Web應用程序添加到EAR）
　　
　　Context Root：　　　　　　　　　　　　　[使用默認值]
　　
　　Source Folder：　　　　　　　　　　　　 src
　　
　　Web Content folder：　　　　　　　　　　web
　　
　　Add support for annotated Java classes：選中
　　
　　Support Multiple Modules per project：　不選
　　
　　新的Dynamic Web Project Wizard如下所示：
　　　 Eclipse 3.1 WTP Web程序支持Beehive（圖一）

　　2. 導入Beehive Support Ant構建文件
　　
　　所提供的Beehive Support Ant構建文件位于一個zip存檔文件中。有兩種方法可以將該文件的內容導入新的Web項目：
　　
　　1. 利用Eclipse的導入功能
　　
　　2. 將文件內容解壓到Web App項目目錄下
　　
　　將下面的文件保存在您的系統上：setup_beehive.zip
　　
　　然后右擊Package EXPlorer View中的Web項目，選擇Import... -> Archive file。在下面的例子中，該文件保存在C:/Temp目錄下：
　　　 Eclipse 3.1 WTP Web程序支持Beehive（圖二）

　　3. 將Web project/setup.beehive文件夾中的Ant構建文件添加到AntView
　　
　　現在，Beehive Support Ant構建文件已就緒，我們可以將setup.beehive/build.xml文件添加到Ant View，這樣一切都預備好了。您會看到如下界面：
　　　 Eclipse 3.1 WTP Web程序支持Beehive（圖三）

　　4. 打開NavigatorView
　　
　　我們要查看一下文件系統的內容，以便更好地了解WTP項目的構成。最好的方法是利用Navigator View。您會看到如下界面：
　　　 Eclipse 3.1 WTP Web程序支持Beehive（圖四）

　　請注重以圓點開頭的所有文件和文件夾。這些文件和文件夾是Eclipse、WTP和其它插件用來治理項目的行為和配置的。當進一步配置該項目時，可以定期打開這些文件，查看所做的更改對它們的影響。
　　
　　應非凡注重.deployables文件夾。該文件夾包含部署一個“已構建的”Web應用程序所必需的結構。例如：假如我們要設置開發環境以便使用Tomcat，該目錄即為在Tomcat上部署的結構。WebLogic Server 9則有一點不同，要根據該文件夾中的內容創建一個可部署的.jar文件，然后將該.jar文件移至WebLogic Server的autodeploy文件夾中。
　　
　　5. 檢驗build.xml的屬性
　　
　　您需要確保build.xml文件針對所需的環境進行了配置。需要驗證的屬性標記是beehive.home和project.name。假如新的Dynamic Web項目沒有使用推薦的值，您可能還需要查看project.src和project.web屬性。這些屬性必須正確設置，構建文件才能工作。
　　
　　6. 運行01.enable.beehive Ant目標
　　
　　01.enable.beehive Ant目標執行多種任務。它將部分netui-blank Beehive示例復制到Web項目以及提供支持的Beehive和Controls庫中。
　　
　　從Ant View運行01.enable.beehive Ant目標并查看結果。在下面的界面中，用黃色突出顯示了由該Ant目標文件添加或受其影響的文件：
　　
　　注重：假如在運行Ant任務之后，您的View沒有更新，請手動刷新Web項目。
　　　 Eclipse 3.1 WTP Web程序支持Beehive（圖五）

　　假如您希望了解Ant構建文件執行的操作，最好是打開構建文件，瀏覽其內容。您會發現它所執行的操作與Beehive Tools（Beehive Ant文件和任務）相同，只不過是以一種用于Eclipse WTP Dynamic Web Project的方式。
　　
　　7. 更改Web項目的默認輸出文件夾
　　
　　當設置Dynamic Web Project時，請將/bin文件夾作為默認輸出文件夾。如前所述，.deployables文件夾包含“可部署的/可運行的”組件。因此，我們需要更改該設置。
　　
　　打開Web項目Properties，找到Java Build Path，然后選中。您可以通過手動輸入或者使用Browse...按鈕進行更改。您會看到如下界面：
　　　 Eclipse 3.1 WTP Web程序支持Beehive（圖六）

　　8. 更改Java Compiler JDK Compliance level以支持注釋
　　
　　除非您已將整個workspace的JDK Compliance level更改為5.0，否則該項目就不支持注釋。我們知道注釋對于Apache Beehive十分重要，因此我們需要更改JDK Compliance level。
　　
　　打開Web項目Properties，找到Java Compiler，然后選中。選擇Enable project specific settings，然后將Compiler compliance level設置為5.0。您會看到如下界面：
　　　 Eclipse 3.1 WTP Web程序支持Beehive（圖七）

　　9. 查看.deployables文件夾
　　
　　現在，我們已經快要在Eclipse中完成一個自構建的Beehive項目了。讓我們看一下.deployables文件夾的內容。記住，您需要在Navigator View中進行查看。.deployables文件夾內容如下所示：
　　　 Eclipse 3.1 WTP Web程序支持Beehive（圖八）

　　注重，部署到Web服務器所需要的一切東西“幾乎”都在該文件夾中。有趣的是，其中一些經過匯編的Page Flow（SharedFlow.class和Controller.class）包含有注釋，但提供支持的struts配置卻不見了。即使Page Flows經過編譯，也不能完全正常運行，而這正是JDT APT配置發揮作用的時候。在下面一節中，我們將配置JDT APT。
　　
　　為Beehive配置JDT APT
　　
　　您可能注重到了，Ant構建文件包含一個稱為02.setup.jdt.apt的目標。這是一種自動執行下面步驟的方法。但是，假如您是初次使用Beehive創建Web應用程序，建議您執行下面的步驟，以便可以更好地了解如何為Apache Beehive配置JDT APT。
　　
　　1.在Web項目中創建build/apt/src文件夾
　　
　　配置JDT APT，將生成的所有源文件放入build/apt/src文件夾。最好提前創建該文件夾。
　　
　　2. 將build/apt/src文件夾作為源文件夾添加至Java Build Path
　　
　　新創建的源文件夾需要作為源文件夾放入Java Build Path。這樣，Eclipse就會優先處理生成的源文件。
　　
　　打開Web項目Properties，找到Java Build Path并選中。然后在Source選項卡下，選擇Add Folder...按鈕，找到并選中build/apt/src文件夾。請確定只選中了src文件夾而沒有選中父文件夾（例如build/apt）。您的項目Properties如下所示：
　　　 Eclipse 3.1 WTP Web程序支持Beehive（圖九）

　　關閉Properties窗口之后，您會在Package Explorer View中看到以下界面：
　　　 Eclipse 3.1 WTP Web程序支持Beehive（圖十）

　　3. 配置Web項目的Annotation Processing
　　
　　JDT APT有兩個配置點，第一個就是Annotation Processing設置。該配置點答應您設置保存生成的源文件以及處理鍵/值對的目錄。鍵/值對被交給處理器，以便通知處理器source root、content root、output root等等都在何處。
　　
　　打開Web項目的Properties，在樹型目錄結構中找到Java Compiler -> Annotation Processing節點并選中，然后利用以下信息進行配置：
　　
　　注重：您需要將MyWebApp替換為自己的項目名稱。
　　
　　Enable project specific settings:　　　選中
　　
　　Enable annotation processing:　　　　　選中
　　
　　Generated source directory:　　　　　　build/apt/src
　　
　　Processor Option web.output.root:　　　%ROOT%/MyWebApp/.deployables/MyWebApp
　　
　　Processor Option web.content.root:　　 %ROOT%/MyWebApp/web
　　
　　Processor Option web.source.roots:　　 %ROOT%/MyWebApp/src
　　
　　您會看到如下界面：
　　　 Eclipse 3.1 WTP Web程序支持Beehive（圖十）

　　將web.output.root設置為%ROOT%/MyWebApp/.deployables/MyWebApp而非%ROOT%/MyWebApp/web的原因是，在如何在當前的WTP中進行構建方面，存在著一個問題。假如您使用的是第二種設置，struts配置就不會將其配置到.deployables文件夾中。但是，由于在項目文件（例如web/WEB-INF/classes）中不需要struts配置，則實際上將該設置配置到.deployables文件夾更有意義。
　　
　　4. 配置Web項目的Factory Path
　　
　　這是JDT APT的第二個配置點。它可以指定用于定位注釋處理器的.jar文件等等。共有四個.jar文件需要添加至Factory Path配置以便支持Apache Beehive。
　　
　　打開Web項目的Properties，在樹型目錄結構中找到Java Compiler -> Annotation Processing -> Factory Path節點并選中。然后利用以下信息進行配置：
　　
　　Enable project specific settings:　選中
　　
　　Add External Jars...　　　　　　　　C:/apache-beehive-1.0/lib/common/velocity-1.4.jar
　　
　　Add External Jars...　　　　　　　　C:/apache-beehive-1.0/lib/common/velocity-dep-1.4.jar
　　
　　Add External Jars...　　　　　　　　C:/apache-beehive-1.0/lib/controls/beehive-controls.jar
　　
　　Add External Jars...　　　　　　　　C:/apache-beehive-1.0/lib/netui/beehive-netui-compiler.jar
　　
　　您會看到如下界面：
　　　 Eclipse 3.1 WTP Web程序支持Beehive（圖十二）

　　5. 在Web項目中運行Run Project -> Clean...并查看結果
　　
　　現在，我們已配置了JDT APT，接下來需要驗證構建過程是否能夠正常工作。我們通過在Web項目中執行清除來執行完整構建。然后我們在Navigator View中查看結果。
　　
　　假如Navigator View還沒有打開，則立即打開，展開Web項目中的.deployables文件夾。選擇Project -> Clean...菜單項并且只清除Web項目。清除完成之后，您會在Navigator View中看到如下界面：
　　　 Eclipse 3.1 WTP Web程序支持Beehive（圖十三）

　　6. 完成配置
　　
　　至此，我們已完成WTP Dynamic Web應用程序的Beehive配置。我們可以添加Page Flow、Java Control等等，并讓Eclipse/Beehive自動構建必要的二進制文件和配置文件。
　　
　　您可以隨意探索Navigator View，查看.deployables文件夾和_pageflow文件夾中所生成的內容。您可以打開某些文件，如struts-config.xml，查看所生成的內容。

上一篇：在Eclipse中擴展RefactoringWizard 框架

下一篇：JBuilder2005+JBOSS+Oracle9i環境配置