构建控制器和视图
创建域类只是成功的一半。每个模型都还需要一个良好的控制器和一些视图(我假设您熟悉 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. 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.gsp
<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:
在此,TripController 重定向到 list 动作,同时传递 params hashmap 中的所有的参数(或 QueryString)。
最后,save 动作(见清单 5)并没有相应的 save.gsp 页面。如果记录被成功地保存到数据库中,那么该动作会重定向到 show 动作页面。否则,它呈现 create.gsp 页面,以便显示错误,并让您重试。
清单 5. 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 是如何工作的,而是看看它的实际效果。