要资料 文章 文库 视频 Code iProcess 课程 认证 咨询 工具 讲座吧   成长之路  
会员   
 
  
每天15篇文章
不仅获得谋生技能
更可以追随信仰
 
 
     
   
分享到
Grails 与 Maven 集成
 
作者 杨 健,火龙果软件    发布于 2013-11-21
 

本文主要介绍 Grails 和 Maven 集成。Grails 2.1 版本以后,对 Maven 的集成有了很大的改进。本文通过实例讲述 Grails 与 Maven 集成的各种方法,使读者可以学会使用 Maven 对 Grails 项目进行构建。

概述

Grails 简介:Grails 是一个开源的 Web 开发框架,它采用动态语言 Groovy 进行开发,并且可以和用 Java 开发的项目进行集成。Grails 充分体现了约定优于配置的原则,将项目的配置减到最低。目前主流的 Java Web 框架都过于复杂,如 Structs、Spring、Webwork,这些框架的用户都需要编写和维护许多配置文件,并且用这些框架的项目写法各有不同,没有统一的标准。Grails 的出现解决了这些问题,用户可以发现在 Grails 中很少去修改和添加配置文件。

Maven 简介:Maven 是一个项目管理工具,基于项目对象模型(Project Object Model),Maven 可以管理项目的构建、报告和文档的生成。Maven 主要用于用 Java 进行开发的项目。

Grails 对于 Maven 的支持:在 Grails 2.1 以前,Grails 插件必须在 BuildConfig.groovy 文件配置,对 Java 的依赖必须在 pom 文件中指定。

在 Grails 2.1 以后,对 Maven 集成的支持有了大的改进,现在 pom 文件也支持引用 Grails 插件,如清单 1:

清单 1. pom.xml 对 Grails 的支持

<dependency> 
<groupId>org.grails.plugins</groupId>
<artifactId>hibernate</artifactId>
<version>2.1.0.RC1</version>
<type>zip</type>
<scope>compile</scope>
</dependency>

Maven 插件现在可以识别 Grails 依赖的其它插件和 Jar 包。并且 Grails 增加了一个新的命令:create-multi-project-build,这个命令在包括多个 Grails 应用或插件的目录中被调用,会生成对复杂项目的 Maven 构建。在 Grails2.1 后,对已有 Grails 项目的 Maven 管理,也只需要输入 create-pom 命令来创建项目对应的 pom 文件。

开发环境:Grails 2.1、Maven 3、JDK1.6。

单个 Grails 项目与 Maven 的集成

首先运行 create-app 命令来生成 Grails 项目,接着在 Grails 项目的根目录下用命令 create-pom 生成 POM 文件。具体实例如清单 2:

清单 2. 用命令 create-pom 生成 POM 文件

 #> grails create-app my-app       
#> cd my-app
#> grails create-pom build.groupid

我们对上面三条命令进行简要说明,第一条是 Grails 项目的创建命令,这个命令将会以用户指定的名称来创建 Grails 应用,我们指定的名称是 my-app,所以会生成名称为 my-app 的 Grails 应用。第二条命令是进入我们创建的 my-app 的根目录下,因为第三条命令需要在 Grails 的根目录下运行。第三条命令是为 Grials 应用创建 POM 文件,使得 Grails 应用可以用 Maven 进行构建,参数 groupid 是指定应用隶属的项目。

运行 create-pom 命令后,我们可以看到在 my-app 根目录生成了文件 pom.xml, 文件显示如清单 3:

清单 3. 在 my-app 根目录生成的 pom.xml 文件

<?xml version="1.0" encoding="utf-8"?> 
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
http://maven.apache.org/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>build.groupid</groupId>
<artifactId>my-app</artifactId>
<packaging>grails-app</packaging>
<version>0.1</version>
<name>my-app</name>
<description>0.1</description>
......
</project>

现在可以运行 mvn 的命令做简单测试,如:mvn package, 可以看到结果如清单 4:

清单 4. 运行 mvn 的命令做简单测试

|Loading Grails 2.1.0 
|Configuring classpath
|Running pre-compiled script
.
|Environment set to prod
.................................
|Packaging Grails application
....
|Compiling 1 source files
............
|Compiling 3 GSP files for package [myApp]
..
|Compiling 4 GSP files for package [databaseMigration]
..
|Building WAR file
..........................................
|Done creating WAR target\my-app-0.1.war
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 2:13.841s
[INFO] Finished at: Tue Oct 16 13:31:29 CST 2012
[INFO] Final Memory: 16M/34M
[INFO] ------------------------------------------------------------------------

从结果可以看出,我们可以使用 Maven 的命令来构建 Grails 项目。其它的 Maven 的标准命令也可以运行。例如清单 5 的命令:

清单 5. 其它的 Maven 的标准命令

compile – 编译 Grails 项目
package – 构建生成 war 文件
install – 构建生成 war 文件并且将其安装在你本地的 Maven 库中
test – 运行项目的测试
clean- 清理 Grails 项目

我们对 Maven 命令执行的流程做简要说明。当在项目的根目录下输入 mvn clean package 时,maven 会将这个命令委托给 grails maven 插件来调用 grails clean 和 grails package 这两个命令。当运行这些命令时,所有的依赖来自于 Maven 的配置文件而非 Grails 的配置文件。

表 1. POM 文件内容的说明

Maven Archetype 的使用

上面讲的是在已有的 Grails 项目中集成 Maven,我们也可以用 maven 的 Archetype 生成 Grails maven 项目。当用 archetype 时,我们无需安装 Grails, 只需输入下面的命令,如清单 6:

清单 6. 用 maven 的 Archetype 生成 Grails maven

mvn archetype:generate -DarchetypeGroupId=org.grails 
-DarchetypeArtifactId=grails-maven-archetype
-DarchetypeVersion=2.1.0
-DgroupId=example -DartifactId=my-app

使用 maven archetype 命令后,可以快速的生成项目的骨架。其中参数 DarchetypeGroupId ,DarchetypeArtifactId 和 DarchetypeVersion 指定了以 Grails 2.1 的模板生成项目骨架。 DgroupId 和 DartifactId 参数指定要创建应用的 GroupId 以及 artifactId,我们没有指定应用的版本,所以当运行这个命令后,会提示输入 version。当输入提示需要输入的值并最后输入“Y“按回车键时,会生成一个新的 Maven 项目。在这个项目中会生成 POM 文件,src 文件夹以及其它文件。在生成的项目骨架中,我们看到并不像 Grails 项目的结构,所以我们需要修改 POM 文件并运行 mvn initialize 命令。

打开 my-app/pom.xml,找到 maven-compiler-plugin, 如清单 7 所示:

清单 7. 找到 maven-compiler-plugin

<plugin> 
<artifactId>maven-compiler-plugin</artifactId>
<configuration>

<source>1.5</source> <target>1.5</target>
</configuration>
</plugin>

我们需要将 JDK 的版本从 1.5 改为 1.6,因为我们本地安装的是 JDK1.6。然后我们输入命令 mvn initialize:如下图所示:

图 1. 输入命令 mvn initialize

当此命令执行完后,我们打开 my-app 目录,会发现一个完整的 grails 项目结构目录已经生成。

多模块 Grails 项目与 Maven 集成

首先创建 3 个 Grails 项目,命令如下:

图 2. 创建 3 个 Grails 的命令

接着我们用命令 create-multi-project-build 来使多模块项目与 Maven 集成。

图 3. 多模块项目与 Maven 集成

当此命令运行完后,在当前目录下会生成一个 pom.xml,并且在前面创建的三个项目文件夹下生成 pom.xml。
当前目录的 pom.xml 文件显示如清单 8:

清单 8. 当前目录的 pom.xml 文件

 <?xml version="1.0" encoding="utf-8"?> 
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
http://maven.apache.org/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>org.mycompany</groupId>
<artifactId>parent</artifactId>
<packaging>pom</packaging>
<version>1.0</version>
<name>parent</name>
<modules>
<module>myapp</module>
<module>plugin1</module>
<module>plugin2</module>
</modules>
</project>

三个子项目下的 pom.xml 文件如下,以 myapp 目录下的 pom.xml 为例:

清单 9. 当前目录的 pom.xml 文件

<?xml version="1.0" encoding="utf-8"?> 
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
http://maven.apache.org/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>org.mycompany</groupId>
<artifactId>parent</artifactId>
<version>1.0</version>
<relativePath>..</relativePath>
</parent>
<groupId>org.mycompany</groupId>
<artifactId>myapp</artifactId>
<packaging>grails-app</packaging>
<version>0.1</version>
......
</project>

首先对当前目录下的 POM 文件进行分析,从 POM 文件中可以看到 groupId, artifactId 和 version 都是用命令 create-multi-project-build 时传的参数。packaging 被设置成 pom 来指出它有子模块。modules 标签列出了所包含的子模块,因为我们前面创建了 3 个模块,所以这里列出了 3 个子模块。

下面我们对模块中的 POM 文件进行分析。

先看下 plugin1 下面的 pom.xml,在这个文件里首先是 parent 标签。Parent 标签的内容中 groupId,artifactId,version 的值和父 pom.xml 中相同。relativePath 指定了父 POM 文件的位置,所以根据这些配置可以找到父 POM 文件。Parent 标签下面是子模块的 groupId,artifactId,version 的设置,这里我们注意到 plugin 的 groupId 默认值是 org.grails.plugins。并且 packaging 的值为 grails-plugin。Plugin2 下面的 pom.xml 文件和 plugin1 下面的相似,所以不再做分析。

对于 myapp 文件夹下的 pom 文件,可以看到 parent 的值也是指向父 pom 文件。packaging 值为 grails-app,指出这是 Grails 的应用。在此 POM 文件中,我们会发现 dependency 有下面的设置:

清单 10. 当前目录的 pom.xml 文件

<dependency> 
<groupId>org.grails.plugins</groupId>
<artifactId>plugin1</artifactId>
<version>0.1</version>
<type>zip</type>
<scope>compile</scope>
</dependency>

<dependency>
<groupId>org.grails.plugins</groupId>
<artifactId>plugin2</artifactId>
<version>0.1</version>
<type>zip</type>
<scope>compile</scope>
</dependency>

这里的设置指定了 myapp 依赖于 plugin1 和 plugin2。

下面我们运行 mvn install 来进行测试,可以看到构建的顺序,先根据当前目录下 parent 的值为 pom 知道这个是多模块的构建,然后去查找子模块的 pom.xml,根据子模块的 pom 文件进行构建。由于子模块 myapp 依赖于 plugin1 和 plugin2,所以 plugin1 和 plugin2 会先被构建。

图 4. 构建 plugin1 和 plugin2

Grails Plugin 与 Maven 集成

这里我们对 grails plugin 的构建做一下简要说明。Plugin 创建时用命令 grails create-plugin plugin_name, 创建 pom 文件的命令和一般应用相同,都是 create-pom。对于 pom 文件,主要的区别是 packaging 的值不同。plugin 的值为 grails-plugin,app 的值为 grails-app。这个设置使得 plugin 在构建时会调用其对应的构建命令。

Grails 插件可以被安装在其它应用中。如果我们用 IDE 打开 Grails 项目,可以看到在 Plugins 目录下,默认已经安装了 cache、hibernate、jquery、resources 等插件。

总结

通过本文对 Grails 与 Maven 集成的介绍,可以看到 Grails 项目创建完成后,开发者如何用 Maven 来进行构建。目前大多数的 Java 项目会采用 Maven 进行构建管理,所以当 Grails 项目模块是整个项目的一部分时,采用 Maven 对 Grails 项目进行统一管理,会使得对整个项目的构建管理一致。一般在单个 Grails 项目时,会采用 Grails 自身的构建机制进行构建。

相关文章

为什么要做持续部署?
剖析“持续交付”:五个核心实践
集成与构建指南
持续集成工具的选择-装载
相关文档

持续集成介绍
使用Hudson持续集成
持续集成之-依赖管理
IPD集成产品开发管理
相关课程

配置管理、日构建与持续集成
软件架构设计方法、案例与实践
单元测试、重构及持续集成
基于Android的单元、性能测试
 
分享到
 
 


集成与构建指南
项目管理:Maven让事情变得简单
持续集成工具hudson
持续集成
Maven权威指南
程序集(UML中的包)之间循环
更多...   


产品发布管理
配置管理方法、实践、工具
多层次集成配置管理
使用CC与CQ进行项目实践
CVS与配置管理
Subversion管理员

相关咨询服务
SCM启动咨询
SCM流程规范咨询
SCM评估性咨询


海航股份 重构及持续集成
电研华源 设计原理、建模与重构
软件配置管理日构建及持续集成
单元测试、重构及持续集成
中国软件研发中心 单元测试与重构
单元测试、重构和持续集成实践
罗克韦尔 C++单元测试+重构+Gtest
更多...   
 
 
 
 
 
每天2个文档/视频
扫描微信二维码订阅
订阅技术月刊
获得每月300个技术资源
 
 

关于我们 | 联系我们 | 京ICP备10020922号 京公海网安备110108001071号