1、JAE 构建系统用户手册Maven 构建方式作者：桃谷更新时间： 2013-10-21版本：0.2一、预热知识 .3二、术语解释 .3三、实现限制 .31. 不支持 goal：install deploy.32. 不提供官方的 Maven 仓库镜像 .43. 不提供全局（通用）Maven settings.xml 文件 .44. Maven 构建脚本文件（pom.xml）限制 .4四、可能的问题 .41. 不支持二方依赖 .42.无法获取三方依赖 .53. 非 Maven 依赖 .5五、解决方法 .51. 解决二方依赖 .52. 解决三方依赖 .73. 解决特殊依赖 .10一、预热知识如果您是
2、第一次使用 Maven，请首先学习以下资源：http:/ Maven 的工作原理以及使用方法，请忽略。二、术语解释二方依赖：是指独立于当前应用，由同一 ISV 开发的依赖资源三方依赖：有第三方开发的依赖资源，例如 Apache Commons Language 三方类库（commons-lang:commons-lang:2.3:jar）Maven 构建脚本文件：pom.xml 文件三、实现限制JUAE 平台支持 Maven 构建方式，支持最新 Maven 3.0.5版本，由于特殊原因，做了以下限制：1. 不支持 goal：install deploy 由于 Maven 构建在 JUAE 平台
3、内部构建，多个应用可能在相同机器上面构建，为了防止多个应用工程相互冲突（多个应用 groupId、artifactId、version 重复） ，同时也防止非法源码泄漏的问题（利用 groupId、artifactId、version 获取源码） 。 未来很有可能支持 ISV 独立 Maven 独立仓库时，可以解除当前限制2. 不提供官方的 Maven 仓库镜像目前官方无法提供 Maven 仓库镜像未来很有可能支持 ISV 独立 Maven 独立仓库时，可以解除当前限制3. 不提供全局（通用）Maven settings.xml 文件目前实现不支持他全局（通用）Maven settings.x
4、ml，尽管如此，应用开发者很有可能自行添加私有 Maven 仓库镜像配置到 settings.xml 文件中，这样，线下和线上的配置不一致，可能导致应用工程源码线上构建时，无法获取第三方依赖。4. Maven 构建脚本文件（pom.xml）限制Maven 构建脚本文件（pom.xml）必须存放在应用工程的根目录下，并且文件名称必须为”pom.xml”四、可能的问题1. 不支持二方依赖由于不支持 install 和 deploy 无法将二方应用依赖部署仓库中去，同时没有官方Maven 仓库镜像，因此也无法下载相应的依赖2.无法获取三方依赖由于官方无法提供 Maven 仓库镜像或者配置了私有 Ma
5、ven 仓库地址，当应用工程源码线上构建时，无法获取第三方依赖3. 非 Maven 依赖由于应用需要依赖无法从 Maven 仓库获取，或者压根就不存在五、解决方法1. 解决二方依赖在上章中提到，构建系统不支持二方依赖。因此，可以通过将二方应用工程源码作为当前应用工程。例如：当前应用工程 project-test其 Maven 原信息为：com.acemproject-test1.0.0所依赖二方 jar 包：common-service-2.0.0.jar,对应的 Maven 原信息为：moncommon-service2.0.0可 common-service 为二方应用工程，那么，如果要解
6、决二方依赖的问题，解决的办法是：将 common-service 工程作为 project-test 的子模块。具体操作步骤如下：首先，将 common-service 工程目录复制到 project-test 工程目录（请注意清理 svn或者 git 元信息目录，防治版本控制混乱）然后，将 common-service 工程配置成 project-test 工程的子模块，在 project-test工程 pom.xml 文件添加配置：.common-service.最终，添加依赖管理配置：moncommon-service2.0.0 .2. 解决三方依赖由于非官方公用 Maven 仓库稳定性
7、无法保证，因此构建系统 Maven settings.xml 文件仅支持官方公共仓库，即默认仓库配置（http:/search.maven.org/） 。强烈推荐应用开发人员尽可能地使用官方仓库中的三方依赖配置。因此，在应用Maven 工程构建（或迁移）时，尽可能地在中央 Maven 仓库中搜索（http:/search.maven.org/） 。例如，应用工程依赖 struts 2，因此，搜索关键字”struts” ，其结果页为：http:/search.maven.org/#search%7Cga%7C1%7Cstruts查找版本等于2 的结果记录：点击“2“的连接，进入配置详情页面：ht
8、tp:/search.maven.org/#artifactdetails%7Corg.apache.struts%7Cstruts-parent%7C2%7Cpom复制红色区域的内容到应用工程的 Maven 依赖配置区。如果第三方依赖无法在中央仓库获取的话，允许在应用工程 pom.xml 文件中，添加合理的仓库配置信息，例如：ibiblioIbiblio Maven Repositoryhttp:/www.ibiblio.org/Slowly office sitehttp:/ 解决特殊依赖本节中的特殊依赖是指当无法从 Maven 仓库下载的依赖资源。幸运地是，Maven 提供了自定义本地仓
9、库方式处理特殊依赖问题。接下来，将详细介绍操作方法。Maven 的仓库配置比较灵活，可以定义远程仓库，一般通过 HTTP 协议获取。同时，还可以配置本地仓库，利用的是 file 协议。实际上，自定义本地仓库与 Maven 本地仓库的目录结构。以 Google guava 工程为例，其依赖配置信息为：com.google.guavaguava14.0.1 笔者本地 Maven 仓库路径为：D:softwaredevjavamaven_repository，Maven 依赖目录结构规则如下：1. groupId 目录结构以上述 Google guava 工程为例，groupId 与 Java package 规则类似，本例中的 groupId 为”com.google.guava“ ，因此，groupId 目录结构如下：
