将现有项目转换为 Maven

您可以将现有 Java™ EE 项目转换为 Maven。

开始之前

要点: 适用于 Liberty 和 WebSphere® Application Server 传统版

备份工作空间,以便您可以在必要时返回至原始项目状态。

设置建议的首选项

关于此任务

要将工作空间用于 Maven 项目,请先设置建议的首选项。有关首选项的更多信息,请参阅设置 Maven 首选项。

过程

  1. 访问 Maven 项目设置首选项。 单击窗口 > 首选项 > Java EE > Maven > Maven 项目设置。
  2. 单击设置所有 Maven 值。 已设置了用于表示 Maven 配置最佳实践的首选项。
  3. 单击确定以完成设置首选项。

转换 Web、EJB、连接器、应用程序客户机、实用程序、Web 片段和 EJB 客户机项目

关于此任务

转换项目时,请注意与其他工件的依赖关系以及该项目如何访问这些工件。在非 Maven 项目中,直接在项目元数据和 MANIFEST.MF 文件中指定此信息。但在 Maven 项目中,在 pom.xml 文件中指定依赖关系。 例如,这些工件可以通过 MANIFEST.MF 文件进行访问,或部署在包含该项目的 EAR 的库目录中。 对于 Web 项目,可将工件部署在 WEB-INF/lib 目录中。

首先,使用“部署组合件”页面收集依赖关系信息。
  1. 右键单击项目。
  2. 选择属性 > 部署组合件。
  3. 单击清单条目选项卡。记下该项目引用的所有条目。
  4. 对于 Web 项目,也请单击部署组合件选项卡。 记下其部署路径以 WEB-INF/lib 开头的所有项目和 JAR 文件。
注: 如果包含您项目的 EAR 项目具有 EAR 构面 V5 或 V6,那么您的项目可能正在引用 EAR 文件的库目录中的项目或 JAR 文件内的类。 也请记下这些引用。

收集必需信息之后,您可以将项目转换为 Maven。

过程

  1. 右键单击该项目,然后选择配置 > 转换为 Maven 项目。
  2. 完成 Maven POM 对话框。 输入组标识、工件标识和版本,或者接受缺省值。(可选)输入名称和描述。 对于包装,请按照下列项目类型进行选择:
    Web 项目
    war
    EJB 项目
    ejb
    连接器、实用程序、Web 片段和 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 具有部署描述符,请将 META-INF 文件夹从 EAR 文件的根目录移至 application 文件夹。

转换 EAR 项目

关于此任务

转换项目时,请注意与其他工件的依赖关系以及该项目如何访问这些工件。在非 Maven 项目中,直接在项目元数据和 MANIFEST.MF 文件中指定此信息。但在 Maven 项目中,在 pom.xml 文件中指定依赖关系。记录属于 EAR 一部分的模块、使用库目录与其他模块进行共享的库(适用于 EAR V5 或更新版本)或其他依赖关系。

首先,使用“部署组合件”页面收集依赖关系信息:
  1. 右键单击项目。
  2. 选择属性 > 部署组合件。
  3. 记下属于 EAR 一部分的模块。
  4. 如果 EAR 是 V5 或更高版本,请记下 EAR 库目录值。
  5. 记下库目录中的 JAR 文件和项目。 要标识这些文件,请查找其部署路径以库目录的值开头的 JAR 文件和项目。
注: 在转换项目之前,如果存在 EAR 部署描述符文件 META-INF/application.xml,请先保存该文件的一份副本。保存一份副本是必要的,这是因为在转换期间,现有部署描述符将替换为空白部署描述符。

过程

  1. 右键单击该项目,然后选择配置 > 转换为 Maven 项目。
  2. 完成 Maven POM 对话框。 输入组标识、工件标识和版本,或者接受缺省值。(可选)输入名称和描述。 对于包装,请输入 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