Grails 快速入门

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

安装 Grails

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

图 1. 设置 GRAILS_HOME 环境变量

然后把 %GRAIS_HOME%\bin 加到 System 的 Path 变量中。

图 2. 设置 Path 环境变量

在控制台下输入 grails help，如果能看到 Grails 的命令列表，Grails 的安装配置就算成功了。

图 3. 检验 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

新创建的 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

图 6. Show Team page

图 7. Edit team page

回页首

一些疑问

前面的例子演示了如何使用 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-app\i18n 中的资源文件，这在后面还会做详细介绍。

Grails 快速入门

相关文章