將現有的專案轉換成 Maven

您可以將現有的 Java™ EE 專案轉換成 Maven。

開始之前

重要: 適用於 Liberty 和 WebSphere® Application Server 傳統版

請備份工作區,必要時就能回復到原始專案狀態。

設定建議的喜好設定

關於這項作業

如果要使用您的工作區來處理 Maven 專案,請先設定建議的喜好設定。如需喜好設定的相關資訊,請參閱設定 Maven 喜好設定。

程序

  1. 存取 Maven 專案設定喜好設定。 按一下 Windows > 喜好設定 > Java EE > Maven > Maven 專案設定。
  2. 按一下設定所有 Maven 值。 設定可代表 Maven 配置最佳作法的喜好設定。
  3. 按一下確定,完成設定喜好設定。

轉換 Web、EJB、連接器、應用程式用戶端、公用程式、網頁片段及 ejb 用戶端專案

關於這項作業

轉換專案時,請記住對其他構件的相依關係及專案如何存取構件。 在非 Maven 專案中,此資訊直接在專案 meta 資料及 MANIFEST.MF 檔中指定。 但在 Maven 專案中,相依關係是在 pom.xml 檔中指定。例如,您可以透過 MANIFEST.MF 檔存取構件,或將構件部署在包含專案的 EAR 的程式庫目錄中。 就 Web 專案而言,構件可以部署在 WEB-INF/lib 目錄中。

首先,請利用部署組合頁面來收集相依關係資訊。
  1. 在專案上按一下滑鼠右鍵。
  2. 選取內容 > 部署組合。
  3. 按一下資訊清單項目標籤。請記下專案所參照的所有項目。
  4. 對於 Web 專案,還需要按一下部署組合標籤。 請記下部署路徑開頭為 WEB-INF/lib 的所有專案及 JAR 檔。
註: 如果包含您專案的 EAR 專案具有 EAR 資料類型第 5 版或第 6 版,則您專案參照的類別可能是來自該 EAR 檔的程式庫目錄中的專案或 JAR 檔。 也請記下這些參照。

收集必要的資訊之後,就可以將專案轉換成 Maven。

程序

  1. 用滑鼠右鍵按一下專案,並選取配置 > 轉換成 Maven 專案。
  2. 完成 Maven POM 對話框。 輸入群組 ID、構件 ID 及版本,或接受預設值。選擇性地輸入名稱及說明。 根據下列專案類型來選擇包裝:
    Web 專案
    war
    EJB 專案
    ejb
    連接器、公用程式、網頁片段及 EJB 用戶端專案
    jar
    應用程式用戶端專案
    app-client
  3. 按一下完成,以完成對話框。 這時會開啟 POM 編輯器。如果對其他專案的參照已遺失,您可能會看到編譯錯誤。
  4. 清除編譯錯誤。 將您要參照的專案轉換成 Maven,然後將 Maven 相依關係新增至這些專案。請參閱新增與其他模組的相依關係。
  5. 更新專案。 在您變更專案之後,用滑鼠右鍵按一下專案,並選取 Maven > 更新專案。

轉換 EAR 專案

關於這項作業

轉換 EAR 專案涉及幾項作業:
  1. 建立內容資料夾。
  2. 轉換 EAR 專案。
  3. 將模組新增至 EAR。
  4. 新增對其他模組的相依關係。
  5. 將程式庫新增至 EAR 程式庫目錄。
請執行下列步驟來完成這些作業。

建立內容資料夾

關於這項作業

在 WebSphere® Application Server Developer Tools 中使用預設工作區喜好設定建立 EAR 專案時,EAR 的內容目錄是空的,這表示專案根資料夾中的一切項目都在 EAR 檔中。 如果專案沒有內容資料夾,您必須建立內容目錄。

程序

  1. 檢查 EAR 是否有內容資料夾。
    1. 用滑鼠右鍵按一下專案,並選取內容 > 部署組合。
    2. 如果您看到對映到 /(根目錄)的內容資料夾,表示 EAR 有專案根目錄以外的內容資料夾。
      內容資料夾不是根目錄
    3. 如果您看到專案的根目錄對映到根目錄,如下圖所示,表示專案沒有內容目錄:
      內容資料夾是根目錄
  2. 如果專案沒有內容資料夾,請在「部署組合」頁面按一下取消,並遵循下列步驟建立內容資料夾:
    1. 用滑鼠右鍵按一下 EAR 專案,並選取新建 > 資料夾。 在資料夾名稱中,輸入資料夾結構的名稱。對於 Maven 專案,建議的資料夾結構為 src/main/application。按一下完成。
      建立資料夾結構
    2. 存取部署組合頁面。 用滑鼠右鍵按一下專案,並選取內容 > 部署組合。
    3. 選取將專案根目錄對映到 EAR 根目錄的項目,然後按一下移除。
    4. 按一下新增,選取資料夾,然後按下一步。
    5. 選取您所建立的資料夾,然後按一下完成。 比方說,如果您建立建議的資料夾結構,請選取 src/main 下的 application 資料夾。
      選取資料夾
    6. 檢查結構。 在部署組合區段中,您建立的資料夾現在對映到專案的根目錄。下圖顯示建立 src/main/application 資料夾時的範例。
      對映到根目錄的資料夾
    7. 按一下確定,完成部署組合對映。
    8. 從專案的根目錄中,將您要併入 EAR 中的所有資源移至您建立的資料夾。 比方說,如果您使用建議的資料夾結構 src/main/application,且 EAR 有部署描述子,請從 EAR 檔的根目錄中,將 META-INF 資料夾移至 application 資料夾。

轉換 EAR 專案

關於這項作業

轉換專案時,請記住對其他構件的相依關係及專案如何存取構件。 在非 Maven 專案中,此資訊直接在專案 meta 資料及 MANIFEST.MF 檔中指定。 但在 Maven 專案中,相依關係是在 pom.xml 檔中指定。 請記下屬於 EAR 的模組、使用程式庫目錄供其他模組共用的程式庫(適用於 EAR 第 5 版或更新版本),或其他相依關係。

首先,請利用部署組合頁面來收集相依關係資訊:
  1. 在專案上按一下滑鼠右鍵。
  2. 選取內容 > 部署組合。
  3. 請記下屬於 EAR 的模組。
  4. 如果 EAR 為第 5 版或更新版本,請記下 EAR 程式庫目錄值。
  5. 請記下程式庫目錄中的 JAR 檔及專案。 如果要識別這些檔案,請尋找部署路徑開頭為程式庫目錄值的 JAR 檔及專案。
註: 轉換專案之前,請儲存 EAR 的部署描述子檔案 META-INF/application.xml 的副本(如果存在)。 必須儲存副本,因為在轉換期間,現有的部署描述子會以空的部署描述子取代。

程序

  1. 用滑鼠右鍵按一下專案,並選取配置 > 轉換成 Maven 專案。
  2. 完成 Maven POM 對話框。 輸入群組 ID、構件 ID 及版本,或接受預設值。選擇性地輸入名稱及說明。 在包裝中,輸入 ear。
  3. 按一下完成。 這時會開啟 POM 編輯器。
    註: 如果 EAR 有部署描述子,則會產生新的空白部署描述子。如果原始部署描述子包含安全角色之類的元素,請在 pom.xml 檔中配置元素。如需相關資訊,請參閱:Maven EAR 外掛程式
  4. 更新專案。 在您變更專案之後,用滑鼠右鍵按一下專案,並選取 Maven > 更新專案。
  5. 如果要完成 EAR 轉換,您必須完成下列三項作業:
    1. 新增模組至 EAR 專案
    2. 新增與其他模組的相依關係
    3. 將程式庫新增至 EAR 程式庫目錄
Icon that indicates the type of topic Task topic
Timestamp icon Last updated: last_date

File name: convert.html