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 利用刪除來自動移除 WebSphere 連結
   2.8 資源因 JSP 驗證而鎖定
   2.9 當新的 J2EE 專案使用非預設專案位置時,會出現「專案說明無效」錯誤

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 檔的「類別路徑:」屬性在 EAR 內是以空格區隔的相對路徑清單。如果被參照之 JAR 的 URI 包含空格,一個 JAR 就無法參照 EAR 中的另一個 JAR。

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

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

2.6 二進位碼專案是唯讀的

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

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

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

2.8 資源因 JSP 驗證而鎖定

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

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

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

返回主 Readme 檔