配置MyEclipse開發Webtop的開發環境

在EMC的Documentum中，在目前的6.5版本中，使用WDK來開發Webtop是標準的方式，但是WDK相當的龐大的複雜，只看開發文檔是很難理解WDK的，所以通過Debug的方式來調試WDK就成了比較迫切的需求，經過一天的嘗試終於配置成功，發出來與大家分享，避免其它人再走彎路。

一、安裝Tomcat並部署Webtop

1、安裝Tomcat6.0

這裡將Tomcat安裝在C:\Tomcat 6.0中。

2、部署Webtop6.5

（1）將下載的Webtop6.5複製到C:\Tomcat 6.0\webapps\中，虛擬目錄名為webtop。

（2）修改webtop\WEB-INF\classes下面的dfc.properties檔案，使其可以找到Documentum的Repository，如在我的機器上修改為：

dfc.docbroker.host[0]=WU
dfc.docbroker.port[0]=1489

dfc.globalregistry.password=KmYwfPemMrpphRf5Lwazxg==
dfc.globalregistry.repository=documentum
dfc.globalregistry.username=dm_bof_registry

dfc.session.allow_trusted_login=false

在開發測試環境中，Content Server與Web伺服器安裝在同一台機器時，也可以將dfc.properties引用到Content Server的配置，如下所示：

#include d:\Documentum\config\dfc.properties
dfc.session.allow_trusted_login=false

3、配置Tomcat

（1）標籤庫支援

在未設定標籤庫支援時，開啟網站時會提示：“com.documentum.web.form.control.TagPoolingEnabledException: JSP tag pooling is not supported. Please refer to the product deployment guide for instructions on turning off tag pooling for the application server.”

通過查看相關文檔，瞭解到需要修改webtop\WEB-INF中的web.xml檔案，在其中增加一個servlet節，如下所示：

<servlet><servlet-name>jsp</servlet-name><servlet-class>org.apache.jasper.servlet.JspServlet</servlet-class><init-param><param-name>enablePooling</param-name><param-value>false</param-value></init-param><init-param><param-name>fork</param-name><param-value>false</param-value></init-param><init-param><param-name>xpoweredBy</param-name><param-value>false</param-value></init-param><load-on-startup>3</load-on-startup></servlet>

修改後重啟Tomcat服務，就可以看到Webtop的介面了（註：如果錯誤依舊，請刪除C:\Tomcat 6.0\work中的所有檔案）：
（2）JVM效能設定如果未配置Java虛擬機器的效能的相關參數，在運行Webtop時可能會發生記憶體溢出的情況，這時需要在Tomcat中設定Java虛擬機器的記憶體等相關參數。開啟開始菜單中的程式中的“Apache Tomcat 6.0”、“Configure Tomcat”，在彈出的視窗中選擇Java頁，然後面下面的Java Options中添加如下參數

-Xms512m
-Xmx512m
-XX:PermSize=256M
-XX:MaxPermSize=256m
-XX:ReservedCodeCacheSize=48m

其中各項參數可根據機器的實際情況進行取捨，但是在32位的機器中-Xms512m記憶體設定和-Xmx512m超過1.5G左右時會報錯，需要進行嘗試性設定，具體需要參考網上的其它文章。

二、配置開發環境

1、安裝JDK1.5

在目前的WDK 6.5SP3中，必需使用JDK1.5，相應的JRE也要使用1.5，否則會出現相容性錯誤，我在實驗中就曾出現由於使用JRE6，從而在WDK的源檔案中實現了ResetSet介面的類需要實現大量的抽象方法，在使用了JRE5以後才解決這個問題。

2、安裝MyEclipse

3、設定MyEclipse

（1）開啟MyEclipse，並設定好工作空間後，點擊“Windows->Preferences”、“Java->Compiler->Building”

，取消選擇“Scrub output folders when cleaning projects”，：

點擊Installed JREs，點擊Add按鈕後，在JRE home directory中輸入JDK1.5的路徑，如所示：

點擊OK按鈕後，在返回的列表中確定只使用JRE1.5。

（2）開啟MyEclipse，並設定好工作空間，點擊“File”、“New”、“Java Project”，在出現的視窗中進行的設定：

點擊Next後，不要設定任何的源檔案夾，並保持預設的輸出目錄為：webtop/WEB-INF/classes，：

點擊Finish。

在左側的Navigator中的Webtop中點擊右鍵，在彈出的菜單中選擇“New”、“Folder”，在彈出的視窗中進行如下設定：

其中檔案夾名是任意的，在Advanced中需要將此檔案夾連結到webtop\WEB-INF\classes中，後面將會對此檔案夾進行設定，使其作為項目的Build Path中引入的Library。

點擊“Finish”按鈕建立該檔案夾。

（2）設定Build Path

右擊“webtop”，點擊“屬性”，在彈出的視窗中，點擊“Java Build Path”，如果當前的配置尚未引入\WEB-INF\lib目錄中的包，則可以手工引入。

在添加了DFC的相關Jar包後，還需要添加servlet和jsp的相關Jar包，這兩個Java包要使用Tomcat中的，在我的機器中這兩個Jar包在C:\Tomcat 6.0\lib中，：

點擊“開啟”後，在返回的視窗中點擊“Add Class Folder”按鈕將上面建立的wdkClasses目錄添加進來，：

點擊OK後，在返回的視窗中點擊“OK”退出設定。

現在通過Ctrl+B進行Build，可能會發生錯誤，錯誤的資訊會很奇怪，出錯的資訊是：The type Comparable is not generic; it cannot be parameterized with arguments <String>。解決這個問題的方法是在Java Build Path中的Order and Export，將JRE System Library 提到最上面點勾選，：

點擊OK後，再次編譯應該會沒有問題了。

（3）引入WDK中的原始碼

在WDK開發包中，EMC提供了部分的原始碼，這部分原始碼對於我們進行調試來說是相當重要的，這需要將它們引入到MyEclipse環境中。

在左側的Webtop目錄中的webcomponent中建立src檔案夾，：

將下載的WDK檔案夾中的wdk.war\webcomponent中的src目錄中的所有檔案粘貼點到上面的src目錄中：：

為了能夠讓MyEclipse能夠編譯這些檔案，需要在Java Build Path中Source頁中，點擊Add Folder按鈕，並在彈出的視窗中選擇webcomponent下面的src，：

現在通過Ctrl+B來Build項目，會發現如下錯誤：The project was not built since its build path is incomplete. Cannot find the class file for javax.portlet.PortletRequest. Fix the build path then try building this project。這說明缺少相應的Portlet的Jar包，雖然我們不是Porltet的環境，但是WDK的源碼的環境需要此Jar包，所以要引入此Jar包，此Jar包是：portlet-api-1.0.jar。在Java Build Path的Libraries頁中點擊“Add External JARs”引入此Jar包，：

再次進行Build後應該沒有錯誤了。

在下載的WDK檔案夾中也有個src檔案夾，這裡麵包含了控制項相關的部分源碼，要引入這些源碼需要在左側的分類樹中的wdk檔案夾中點擊右鍵，“New“、“Folder”，建立一個src檔案夾，：

將下載的WDK中的src中的檔案複製到上面建立的src目錄中，：

同樣，需要在Java Build Path中的Source頁中如webcompoent一樣將其加入，使MyEclipse可以對其進行編譯,在我的機器中編譯是發現DateTimeTag.java檔案發生編譯錯誤，處理後發現是注釋存在問題，將注釋刪除即可。

如果發現大量的錯誤，可以嘗試在MyEclipse的webtop項目中右擊，在Resources頁中將“Text file encoding 修改為UTF-8”,如所示：

（4）在MyEclipse中加入Tomcat伺服器

在Window菜單中的Preferences中點擊My Eclipse、Servers、Tomcat、6.x中，進行如的設定

點擊OK按鈕儲存設定

（5）設定自訂的環境並進行調試

在WDK開發中，自訂的配置及代碼是需要放置在Custom檔案夾下的，所以需要在Custom檔案夾中建立src檔案夾，並像上面一樣將其放在Java Build Path的Source中，將加入WDK Tutorial的Hello Webtop進行測試，如所示：

在HelloWebtop.java中設定斷點，並在My Eclipse中開啟Tomcat（必需在My Eclipse中開啟）後，當運行到Hello_world.jsp時，會進入到斷點，如所示：

 

到此測試組態環境成功。

註：

1.如果遇到大量的編譯錯誤，可能是因為Class檔案的原因。此時用原始的WEB-INF\classes\com\documentum覆蓋開發環境下的同目錄，然後在MyEclipse中將wdkclass刪除，然後再建立link後，再重新放到Build Path中的Library中。

2.The type Comparable is not generic; it cannot be parameterized with arguments <E>錯誤：在Order and Export中將JRE選中，並放到最頂。

3.如果加完Tomcat，並啟動時出錯，檢查在MyEclipse中該Tomcat是否使用的是1.5的SDK