将现有项目转换为 Maven

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

开始之前

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

关于此任务

用于转换项目的任务的建议顺序如下所示:

  1. 设置建议的首选项
  2. 转换非 EAR 项目
  3. 转换 EAR 项目
    1. 创建内容文件夹
    2. 转换 EAR 项目
    3. 向 EAR 添加模块
    4. 添加与其他模块的依赖关系
    5. 向 EAR 库目录添加库

设置建议的首选项

关于此任务

要将工作空间用于 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 库目录添加库
指示主题类型的图标 任务主题
信息中心的条款和条件 | 反馈

时间戳记图标 最近一次更新时间: 2014 年 4 月 17 日

文件名:convert.html