java grails mave_Grails 与 Maven 集成

Grails 与 Maven 集成

杨健

2013 年 9 月 09 日发布

概述

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 的支持

org.grails.plugins

hibernate

2.1.0.RC1

zip

compile

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"?>

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">

4.0.0

build.groupid

my-app

grails-app

0.1

my-app

0.1

......

现在可以运行 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 文件内容的说明属性说明：modelVersionPOM 模型的版本，Maven2/3 的话，值为 4.0.0

groupId项目所属的组，一般项目都是由几个模块组成，所以各个模块所属的项目(组)由此参数设定。

artifactId项目在组中的定义，和 Grails 项目根目录下 application.properties 中的 app.name 名字一致。

packaging值为 grails-app，指出应用是 Grails 的应用，所以打包时会以 Grails 的应用打包。

version项目当前版本，必须和 application.properties 中的 app.version 内容一致。

name项目的名称。

description项目的描述。

properties设置 Grails 的版本号。

dependencies当运行命令 create-pom 时， grails 会基于 BuildConfig.groovy 在 POM 文件中生成项目所依赖的包，插件等。

build构建的设置。这一部分包括了构建 Grails 项目的 Maven 插件。

repositories项目的仓库设置。 Grails 有自己的 Maven 仓库来存储插件和它的核心依赖。

profiles自定义构建环境。

Maven Archetype 的使用

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

清单 6. 用 maven 的 Archetype 生成 Grails mavenmvn 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

maven-compiler-plugin

1.51.5

我们需要将 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"?>

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">

4.0.0

org.mycompany

parent

pom

1.0

parent

myapp

plugin1

plugin2

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

清单 9. 当前目录的 pom.xml 文件<?xml version="1.0" encoding="utf-8"?>

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">

4.0.0

org.mycompany

parent

1.0

org.mycompany

myapp

grails-app

0.1

......

首先对当前目录下的 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 文件

org.grails.plugins

plugin1

0.1

zip

compile

org.grails.plugins

plugin2

0.1

zip

compile

这里的设置指定了 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 自身的构建机制进行构建。

相关主题Grails 官方网站：对 Grails 框架的各个组成部分有详细的说明。

Maven 官方网站：对 Maven 的基础概念及如何使用有详细的说明。

developerWorks Java 技术专区：这里有数百篇关于 Java 编程各个方面的文章。