J2EE 開發 - 版本注意事項

1.0 簡介
2.0 已知的問題
   2.1 將模組檔加入企業應用程式專案
   2.2 替代企業應用程式中的部署描述子 (alt-dd) 元素
   2.3 EJB/Web/應用程式用戶端專案的 Java 建置路徑設定
   2.4 不支援在 EAR 內的 JAR URI 中使用空格
   2.5 企業應用程式專案名稱不應包含 DBCS 字元
   2.6 二進位碼專案是唯讀的
   2.7 多次建立範例
   2.8 在移除公用程式 JAR 檔的相依性時更新 Java 建置路徑
   3.9 「Java JAR 相依性」頁面無法更新 Java 建置路徑
   2.10 利用刪除來自動移除 WebSphere 連結
   2.11 J2EE ANT 作業支援
   2.12 資源因 JSP 驗證而鎖定
   2.13 匯入和改寫現有的檔案時,自動移出 ClearCase
   2.14 當新的 J2EE 專案使用非預設專案位置時,會出現「專案說明無效」錯誤
   2.15 J2EE headless Ant 支援:com.ibm.etools.j2ee.ant.RunAnt 應用程式

1.0 簡介

J2EE 視景包含您部署企業應用程式、EJB、Web 和應用程式用戶端等專案的資源時,通常會用到的視圖。 這個 Readme 檔會說明和 WebSphere Studio 中的 J2EE 開發工具所關聯的已知問題、限制以及解決方案。 J2EE 視圖和 J2EE Web 專案的某些其他相關項目,在 Web 工具的 Readme 檔中有它們的說明。

2.0 已知的問題

2.1 將模組檔加入企業應用程式專案

將其中一個模組檔類型(EJB JAR、WAR、RAR 和應用程式用戶端 JAR 檔)匯入到企業應用程式專案時,您必須使用正確的匯入精靈並將模組檔匯入到適當的專案類型中。 請勿匯入企業應用程式專案。 如果模組檔匯入企業應用程式專案時中,您將無法利用應用程式部署描述子編輯器將模組加入應用程式中。

2.2 替代企業應用程式中的部署描述子 (alt-dd) 元素

WebSphere Studio 目前不支援使用 alt-dd。 解決方案是編輯內含模組的部署描述子。

2.3 EJB/Web/應用程式用戶端專案的 Java 建置路徑設定

建議您只要可能,就接受該 J2EE 專案類型之 Java 建置路徑的預設值。 如果要設定企業應用程式包含之專案之間的相依性, 請改用「JAR 相依性」編輯器或「Java JAR 相依性」內容頁。如此會維持 MANIFEST.MF 檔的「類別路徑」屬性(用於伺服器執行時期) 和專案 Java 建置路徑(用於 Java 編譯)同步化。

一般而言,模組所需的程式庫必須包含在企業應用程式中,或是可從伺服器看得到。因此,將外部程式庫加入專案建置路徑中時應該要小心,因為該專案可能不在伺服器上執行。比方說,假設您要在 WEB 模組中參照程式庫 off_the_shelf.jar。您可以:

  1. 利用檔案系統匯入精靈將 off_the_shelf.jar 加入企業應用程式中;然後使用「JAR 相依性」編輯器使該 WEB 模組和 JAR 相依,或者
  2. 利用 WEB 專案的 Java 建置路徑內容, 將 JAR 加入建置路徑中;接著伺服器必須具備該 JAR 的可見性。

如果要完成這項作業以進行單元測試,請編輯伺服器配置並將 JAR 加入類別路徑中。

2.4 不支援在 EAR 內的 JAR URI 中使用空格

不支援在企業應用程式中的模組或公用程式 JAR 的 URI 中使用空格。 JAR 或模組中之 MANIFEST.MF 檔的 "Class-Path:" 屬性是在 EAR 內的相對路徑清單,用空格來分開各路徑。 如果被參照的 JAR 之 URI 包含空格,JAR 就無法參照 EAR 中的另一個 JAR。

2.5 企業應用程式專案名稱不應包含 DBCS 字元

當您建立企業應用程式專案時,我們建議您在命名該專案時不要包含 DBCS 字元。

2.6 二進位碼專案是唯讀的

EAR 匯入所建立的二進位專案(這是匯入精靈的一個選項)是唯讀的。 您不應試圖修改二進位專案的內容。 不過,您可以刪除二進位專案,用儲存庫中的程式碼版本來取代它。 二進位專案的大部分動作都應該停用。 如果您使用了二進位專案,請嘗試避免任何會修改專案或 JAR 內容的動作。

2.7 多次建立範例

如果要建立內建企業應用程式範例的多個實例,您需要先更名現有的範例專案及其所有模組專案,再重新匯入範例。 如果您沒有遵循這些步驟,第二次匯入時,不需要發出警告,就會改寫模組專案。

在「J2EE 階層」視圖中,用滑鼠右鍵按一下每個需要更名的模組,選取更名。 在開啟的對話框中,輸入新名稱,選取更名所有企業應用程式中的模組更名參照所選專案的模組相依性。 使用「J2EE 階層」視圖中的「更名」,並選取這兩個選項使模組的交互相依性維持完整是很重要的。

2.8 在移除公用程式 JAR 檔的相依性時更新 Java 建置路徑

當您移除「公用程式 JAR」的相依性時,僅當相依的 JAR 仍由 EAR 專案參照時, 對應的 Java 專案才會從 Java 建置路徑中移除。

比方說,假設您建立了 J2EE 1.3 Web 專案與 EAR,以及 JUnit Java 範例專案。 接著,請新增 JUnit 專案作為 EAR 中的「公用程式 JAR」,然後新增 JUnit 作為 Web 專案的「Java JAR 相依性」。

如果您接下來要移除 JUnit 和 Web 專案之間的相依性, 請先從 Web 專案中移除「Java JAR 相依性」,再從 EAR 中移除「公用程式 JAR」。請遵循這個順序以確保這個作業會正確運作。

2.9 「Java JAR 相依性」頁面無法更新 Java 建置路徑

「Java JAR 相依性」頁面不與「專案內容」對話框中的「Java 建置路徑」頁面同步。因此,在同一對話階段作業內,套用到其中一個頁面的變更可能不會反映在另一個頁面中。

也有某些狀況是,在頁面之間來回轉換造成在按下「確定」按鈕時,或在「確定」按鈕之前按下「套用」按鈕時,某一頁面的更新會取消另一頁面的更新。 一般而言,如果新增了 JAR 相依性,但專案並未加入 Java 建置路徑中,則會出現這個狀況。

解決方案是重新開啟「內容」對話框,切換至「JAR 相依性」頁面,取消選取再重新選取相依 JAR,再按「確定」。

2.10 利用刪除來自動移除 WebSphere 連結

當您刪除含有 WebSphere 連結的物件時,也會自動刪除連結物件。 比方說,如果您在應用程式部署描述子編輯器的「安全」頁面中刪除有連結項目的安全角色,安全角色連結也會刪除。 如果您重新加入同名的安全角色,必要時,請務必重新連結它。

2.11 J2EE ANT 作業支援

在 4.x 版中,您可以從 Web 下載 zip 檔 (com.ibm.ant.extras.zip) 來取得匯出所用到的其他工作區 Ant 作業和 J2EE 作業。 現在,這些其他作業是在基本產品的 com.ibm.etools.j2ee.ant 外掛程式中。

如果您有根據舊的外掛程式的現有 ANT 建置,您必須移轉這些建置,因為在 4.0.x 之後已有了下列改變:

  1. 由於外掛程式已從 4.0.x 能夠使用的可下載的 "extra" 更名, 用來執行無標頭的範例 runAnt.bat 檔也已經更新過。 明確地說,啟動應用程式的 ID 已從 "com.ibm.ant.extras.RunAnt" 改成 "com.ibm.etools.j2ee.ant.RunAnt"。 任何用來啟動無標頭工作區的現有 .bat 檔都必須更新。
  2. 現在,utilJAR 作業已即將作廢。 保留它只是為了相容;不過,您應該改用應用程式編輯器中的 util JAR 支援。 另外,也請注意,作業已簡化了,有些參數已不再適用。 請參閱作業文件,以取得詳細資訊。
  3. 在 ear 匯出作業中已新增了參數,用來併入精靈所支援的新旗標,其中包括匯出期間的專案 Meta 檔。 這對二進位專案很用有。請參閱產品文件,以取得最佳化二進位專案的開發作業的詳細資訊。
  4. EJBDeploy 作業的 "use35rules" 參數已更名為 "compatible35"。

2.12 資源因 JSP 驗證而鎖定

如果 Web 專案最近已被「JSP 驗證器」驗證過,該專案所參照的任何程式庫 JAR 檔或類別檔可能仍在使用中。 因此,您可能無法刪除或移動個別的 JAR 或類別檔(比方說,如果您選擇要刪除 /WEB-INF/lib 目錄)。 如果 Web 專案將 EAR 專案中的 JAR 檔當作 Java JAR 相依性來參照,就不可能刪除 EAR 專案或其中的 JAR。 如果要「釋放」這些資源以進行檔案管理活動,請關閉 Web 專案再重新開啟它。

2.13 匯入和改寫現有的檔案時,自動移出 ClearCase

當您匯入 J2EE 模組,且選擇要改寫移入 ClearCase 的檔案,您必須先移出檔案才能改寫它。 在匯入作業偵測到移入 ClearCase 的檔案時,會立即出現一個警告框,問您要不要移出特定的檔案。 如果您按一下「全部皆是」按鈕,WebSphere Studio 會試圖自動移出指定的檔案,以及移出後來在匯入作業期間所遇到的任何其他移出檔案。

2.14 當新的 J2EE 專案使用非預設專案位置時,會出現「專案說明無效」錯誤

當您建立新的 J2EE 專案(包括 Java、企業應用程式、Web、EJB、應用程式用戶端和連接器專案)時,您不能使用工作台中另一個專案已在使用的專案位置。 如果您選擇另一個專案已在使用的專案位置,精靈會顯示「專案說明無效」錯誤對話框或訊息。 如果出現這個訊息之後,您又按一下瀏覽按鈕來選取有效的專案位置,建立專案的作業仍不會結束。 暫行解決方法是按一下取消,再重新開啟建立專案的精靈。

2.15 J2EE headless Ant 支援:com.ibm.etools.j2ee.ant.RunAnt 應用程式

當您執行任何 J2EE 或 EJB Ant 作業時,請使用 com.ibm.etools.j2ee.ant.RunAnt 應用程式,不要使用 org.eclipse.ant.core.antRunner 應用程式。

使用 RunAnt 有兩個好處:

返回主 Readme 檔