Grails 快速入门

下面就开始演示 Grails 的安装以及如何用 Grails 迅速的开发一个最简单的应用程序。

安装 Grails

首先从 Grails.org 上下载 Grails 安装程序（目前最新版本是 1.0RC1），将压缩包解压到硬盘上，并设置环境变量

GRAILS_HOME

为解压的路径。

图 1. 设置 GRAILS_HOME 环境变量

Grails 快速入门

然后把

%GRAIS_HOME%\bin

加到 System 的 Path 变量中。

图 2. 设置 Path 环境变量

Grails 快速入门

在控制台下输入

grails help

，如果能看到 Grails 的命令列表，Grails 的安装配置就算成功了。

图 3. 检验 Grails 是否安装成功

Grails 快速入门

回页首

创建一个 Grails 应用程序

创建 Grails 应用程序需要使用

grails create-app

命令，在控制台输入：

grails create-app Contact

Grails 会为我们创建一个名叫“Contact”文件夹，并在其中生成一个应用程序框架，生成的应用程序目录结构如下：

表 1. Contact 应用文件目录结构

Contact
+	grails-app
	+	conf	存放配置信息，包含数据源、应用程序启动时自动执行的类 ApplicationBootStrap.groovy, Url 映射配置
	+	controller	存放控制器(“MVC”的“C”)
	+	domain	存放域类(“MVC”的“M“)
	+	i18n	存放国际化资源文件
	+	services	存放 service 类
	+	taglib	存放标签库类
	+	views	存放视图模版(“MVC”的 V，每个控制器对应一个文件夹并存放在 Views 中，每个文件夹中会有多个 GSP 页面)
		+	layouts	存放布局模板
+	grails-tests	存放测试代码
+	hibernate	存放可选的其它 Hibernate 配置文件
+	lib	存放其它 Jar 包（如 JDBC 驱动等）
+	spring	存放可选的 Spring 配置文件
+	src
	+	java	存放 Java 源程序
	+	groovy	存放 Groovy 源程序
+	web-app
	+	css	存放 CSS 样式表
	+	images	存放图片文件
	+	js	存放 JavaScript 文件
	+	WEB-INF	存放部署相关的文件
	+	index.gsp	应用程序的首页

从上述目录结构可以看出 Grails 的“约定优于配置”设计理念，它约定了不同层次代码存放的位置以及项目的组织方式，这既提供了一种最佳实践，同时也节省了开发人员配置项目的精力。

添加 Domain Class

接下来，为刚创建好的项目添加一些功能。首先创建两个 Domain Class。前面说过，Domain Class 实质上是数据库表映射的实体类。通过控制台，进入项目的根文件夹（注意：本文出现一切的控制台输入，除 create-app 外，都需要在项目文件夹中执行），输入

grails create-domain-class Team

：

图 4. 创建 Domain Class

Grails 快速入门

新创建的 Domain 类出现在了 grails-app/domain 文件夹中，同时 Grails 还创建了相应的

Test

类。用记事本打开 grails-app\domain 文件夹中的 Team.groovy，加入如下内容：

class Team { 
    String teamName
    Date foundDate
}

这两行代码描述了

Team

所包含的属性，从代码中可以看出 Groovy 语言的一些特点：

无需“;”结尾（有“;”也不会报错）；
简单数据类型，与 Java 相同；

创建 Controller

接下来为 Domain Class Team 类创建 Controller，在控制台输入

grails create-controller Team

，Grails 会在 grails-app/controller 中创建一个名为

TeamController

的类。编辑 TeamController.groovy 文件。加入如下代码：

class TeamController {
    def scaffold = Team
}

不要小看这仅有的一行代码，它使 Team 表有了相应的 CRUD（增、删、查、改）功能的页面。在控制台中输入

grails run-app

，运行应用以查看效果：

图 5. Team list page

Grails 快速入门

图 6. Show Team page

Grails 快速入门

图 7. Edit team page

Grails 快速入门

回页首

一些疑问

前面的例子演示了如何使用 Grails 快速开发一个应用。如果使用 Struts 之类的 Java Web 框架开发一个类似上述的功能可能要花几个小时的时间，而使用 Grails 只用了不到五分钟可以完成了创建。对 Grails 的“快”您应该有了一个比较直观的感受了吧？

虽然现在程序已经实现了对 Team 表的 CRUD 操作，但读者可能会有如下的几个疑问：

数据库在哪？
如何修改页面的外观？
URL 与 Controller 的对应关系是什么？
表单能做验证吗？

下面，我们将对这几个问题加以解答，并给应用程序加入一些新的功能。

回页首

配置数据库

实现了 CRUD，为什么没有配置数据库呢？

Grails 为用户提供的一个内置的轻量级数据库 hsqldb，虽然在性能和功能上难以满足要求，但是对于演示 scaffold 还是绰绰有余的。当然，我们可以用 MySQL 去替换它，下面就来演示这个过程（如果读者不想使用 MySQL 去替换 hsqldb，可以跳过下面的内容）。

首先修改 grails-app\conf\DataSource.groovy：

dataSource {
    pooled = false
    driverClassName = "com.mysql.jdbc.Driver"
    username = "root"
    password = "***"
}
hibernate {
    cache.use_second_level_cache=true
    cache.use_query_cache=true
    cache.provider_class='org.hibernate.cache.EhCacheProvider'
}
// environment specific settings
environments {
    development {
        dataSource {
            dbCreate = "update" // one of 'create', 'create-drop','update'
            url = "jdbc:mysql://localhost:3306/Contact_dev"
        }
    }
    test {
        dataSource {
            dbCreate = "update"
            url = "jdbc:mysql://localhost:3306/Contact_test"
        }
    }
    production {
        dataSource {
            dbCreate = "update"
            url = "jdbc:mysql://localhost:3306/Contact_prod"
        }
    }
}

Grails 默认要求提供三个数据库，分别用于开发、测试和产品环境。修改连接的 Driver 名称、用户名密码以及三个数据库的URL，保存。接下来分别创建上述三个数据库，并把 MySQL 的 JDBC 驱动程序拷贝到 lib 文件夹中。

接下来，重新运行项目（

grails run-app

），Grails 会自动为 Domain Class 创建相应的数据库表。至此，Team 的 CRUD 程序就运行在 MySQL 之上了。

回页首

修改页面外观

使用 scaffold 实现的 CRUD 实际上并没有创建 GSP 页面，所以无法定制 View 内容。在 Grails 中，可以使用

grails generate-all

命令为指定的 Domain Class 创建实现 CRUD 操作的 Controller 和 View。所以，在控制台运行（如果提示 TeamController 已存在，是否覆盖？请选"是"）：

grails generate-all Team

Grails 会在 grails-app\views\ 目录中创建一个名叫 team 的文件夹，文件夹的名称刚好和 controller 一一对应。team 文件夹中包含了 4 个 GSP 文件，分别是 create.gsp、list.gsp、edit.gsp 和 show.gsp。这几个页面和之前 scaffold 实现的功能是一致的。修改这几个页面的代码，即可以定制页面的外观。

回页首

URL 与 Controller 的命名约定

打开

generate-all

命令产生的 Controller 即 TeamController.groovy 文件，可以看到如下内容：

class TeamController {
    
    def index = { redirect(action:list,params:params) }

    // the delete, save and update actions only accept POST requests
    def allowedMethods = [delete:'POST', save:'POST', update:'POST']

    def list = {
        if(!params.max) params.max = 10
        [ teamList: Team.list( params ) ]
    }

    def show = {
        [ team : Team.get( params.id ) ]
    }
…

其中

def xxx = {xxx}

的结构在 Groovy 语言中叫闭包（Closure），在 Controller 中，每个闭包对应为一个 Action，即处理一个特定的 Web 请求。然后看看 Grails URL 的命名原则：

http(s)://host:pot/ProjectName/ControllerName/ActionName/Parameters

如果请求的 URL 是 http://localhost:8080/Contact/team/list，即调用了

team

控制器的

list

Action，对应将会触发 TeamController 的

list

闭包的执行。每个 Action 被执行完毕后，会默认跳转去执行它在 View 中同名的 GSP 页面。并把 Action 返回的数据传递给 GSP。比如这个例子中，

list

Action 执行完毕后，会跳转到 grails-app\views\team\list.gsp 视图，并把

Team.list(params)

的结果传递给 list.gsp，在 list.gsp 中可以通过

teamList

访问到 Controller 传递过来的数据。

回页首

表单的验证

Grails 对表单的验证提供了强大的支持，可以使用 Domain Class 的验证来实现表单的验证。修改 Team.groovy 文件：

class Team { 
    String teamName
    Date foundDate
    static constraints = {
        teamName(size:3..50,blank:false,unique:true)
    }
}

在

Team

类中加入个名叫

constraints

的静态 Closure，并在其中描述验证逻辑：team 的字符串长度在 3~50 之间、不能为空、而且是唯一的。（注意早期版本的 Grails 使用

length

限定字符串的长度，在 V0.5 以后改为了

size

保存 Team.groovy，重新运行 Contact，会发现验证逻辑已经可以工作了：

图 8. 表单验证

Grails 快速入门

但验证失败后报出的错误信息对用户来说并不友好。想要修改这些内容，需要编辑 grails-app\i18n 中的资源文件，这在后面还会做详细介绍。

Grails 快速入门

继续阅读

Groovy学习（二）：GDK初探

Groovy学习笔记-基础

Linux下Grails开发环境变量配置

grails环境配置

windows搭建grails环境

Grails Grails和 Spring

Grails环境部署开发

Grails环境配置与环境打包

Groovy快速入门-5-switch分支和循环语句

Groovy的展开操作符（Spread Operator）.和

Groovy 与 Java 的区别

Stubs和Mocks区别 (Stubs vs. Mocks)

flash AS3函数闭包代码

ofbiz学习笔记--Tips & Tricks while working with Groovy

Groovy探索自定义Range 一一个简单的自定义Range类

iReport org/codehaus/groovy/control/CompilationFailedException