编写第一个 Grails 应用程序我经常旅行 — 一年至少 40 趟。我发现，日程表可以很好地告诉我何时 需要达到某个地方，但是不能显示那个地方在哪里。而在线地图刚好相反：它们可以解决地点问题，但不能解决时间问题。所以，在本文和本系列接下来的两篇文章中，您将构建一个定制的 Grails 应用程序，在计划旅程时，这个应用程序既可以用于解决时间问题，又可以用于解决地点问题。
后续介绍本系列后面的文章将讨论如何将 Google Calendar 和 Google Maps 与 Grails 相结合。
首先，在一个空白目录下，输入 grails create-app trip-planner。稍后，可以看到一个名为 trip-planner 的目录。同 Maven、Rails 和 AppFuse 一样，Grails 会建立一个标准的目录结构。如果您觉得这个目录结构限制了您，并且只有精心设计自己的定制目录树才能使用一个框架，那么这样使用 Grails 不会有多大的乐趣。约定优于配置中的约定 部分使您可以拥有任何 Grails 应用程序，并立即知道各个部分之间的联系。
进入 trip-planner 目录，并输入 grails create-domain-class Trip。如果一切顺利，将得到两个新的文件：grails-app/domain/Trip.groovy 和 grails-app/test/integration/TripTests.groovy。在后面的文章中，我将谈到测试。目前，我们主要关注域类。一开始，域类看上去如清单 1 所示：
清单 1. Grails 生成的域类
看上去没什么内容，对吗？接下来让我们来完善它。为 Trip 添加一些字段，如清单 2 所示：
清单 2. 添加字段后的 Trip 类1
2
3
4
5
6
7
8
| class Trip {
String name
String city
Date startDate
Date endDate
String purpose
String notes
}
|
如前所述，这里不需要创建 getter 和 setter 方法：Groovy 会动态地生成它们。Trip 还有很多新的、有用的动态方法，这些方法的名称非常易用理解：
- Trip.save() 将数据保存 到 HSQLDB 数据库中的 Trip 表中。
- Trip.delete() 从 Trip 表中删除 数据。
- Trip.list() 返回一个 Trip 列表。
- Trip.get() 返回一个 Trip。
所有这些方法都已经存在，您在需要的时候就可以使用它们。注意，Trip 并没有扩展某个父类或者实现某个接口。由于 Groovy 的元编程功能，那些方法只是出现在适当类中的适当位置（只有 grails-app/domain 目录中的类才拥有这些与持久性相关的方法）。
构建控制器和视图创建域类只是成功的一半。每个模型都还需要一个良好的控制器和一些视图（我假设您熟悉 Model-View-Controller 模式；请参阅 ）。输入 grails generate-all Trip，以构建一个 grails-app/controllers/TripController.groovy 类，并在 grails-app/views/Trip 中生成一组匹配的 Groovy Server Page（GSP）。对于控制器中的每个 list 动作，都有一个相应的 list.gsp 文件。create 动作则对应于一个 create.gsp 文件。从这里可以看出约定优于配置的优点：无需 XML 文件就可以匹配这些元素。每个域类根据名称与一个控制器配对。控制器中的每个动作也是根据名称与一个视图配对。如果您愿意，也可以绕开这种基于名称的配置，但是大多数时候只需遵循约定，应用程序自然就可以运行。
看看清单 3 所示的 grails-app/controller/TripController.groovy：
清单 3. TripController1
2
3
4
5
6
7
8
| class TripController {
...
def list = {
if(!params.max) params.max = 10
[ tripList: Trip.list( params ) ]
}
...
}
|
Java 开发人员首先会注意到的是，这么少的代码可以实现多少功能。以 list 动作为例。起重要作用的是最后一行。Grails 将返回一个 hashmap，其中只有一个名为 tripList 的元素。（Groovy 方法的最后一行是一个隐式的 return 语句。如果您愿意，也可以手动地输入单词 return）。tripList 元素是 Trip 对象的一个 ArrayList，Trip 对象是通过 Trip.list() 方法从数据库中拉出的。通常该方法将返回表中的全部记录。它上面的一行代码表示 “如果 URL 中提供了一个 max 参数，那么使用它来限制返回的 Trip 的数量。否则，将 Trip 的数量限制为 10”。URL http://localhost:8080/trip-planner/trip/list 将调用这个动作。例如，http://localhost:8080/trip-planner/trip/list?max=3 显示 3 个 trip，而不是通常的 10 个。如果有更多的 trip 要显示，Grails 会自动创建上一页和下一页的分页链接。
那么，如何使用这个 hashmap？看看 grails-app/views/list.gsp，如清单 4 所示：
清单 4. list.gsp1
2
3
4
5
6
7
| <g:each in="${tripList}" status="i" var="trip">
<tr class="${(i % 2) == 0 ? 'odd' : 'even'}">
<td>
<g:link action="show" id="${trip.id}">${trip.id?.encodeAsHTML()}</g:link>
</td>
</tr>
</g:each>
|
list.gsp 主要是一些老式 HTML 加上少量 GroovyTagLib。以 g: 为前缀的就是 GroovyTag。在清单 4 中，g:each 遍历 tripList ArrayList 中的每个 Trip，并构建一个格式良好的 HTML 表格。
对控制器的理解可以归结为三个 R：return、redirect 和 render。有些动作利用隐式的 return 语句将数据返回到具有相同名称的 GSP 页面。有些动作进行重定向。例如，如果 URL 中未指定动作，则将调用 index：
1
| def index = { redirect(action:list,params:params) }
|
在此，TripController 重定向到 list 动作，同时传递 params hashmap 中的所有的参数（或 QueryString）。
最后，save 动作（见清单 5）并没有相应的 save.gsp 页面。如果记录被成功地保存到数据库中，那么该动作会重定向到 show 动作页面。否则，它呈现 create.gsp 页面，以便显示错误，并让您重试。
清单 5. save 动作1
2
3
4
5
6
7
8
9
10
| def save = {
def trip = new Trip(params)
if(!trip.hasErrors() && trip.save()) {
flash.message = "Trip ${trip.id} created"
redirect(action:show,id:trip.id)
}
else {
render(view:'create',model:[trip:trip])
}
}
|
在此，我们不详细讨论 Grails 是如何工作的，而是看看它的实际效果。 |
