Groovy轻松入门——Grails实战之Ajax篇

Ajax虽是“旧酒装新瓶”，但其威力着实不小。近两年来可谓红透半边天，它之所以能为大众接受，其中一个很大的原因就是提高了用户浏览体验，能更逼真的模拟出GUI界面。好了，Ajax的益处就说到这里，下面让我们看下Grails是如何帮助我们方便地应用Ajax的:

如果您对下面说设计的内容有点不解，那么您可以先看一下 Groovy轻松入门——Grails实战基础篇，然后开始我们的Ajax之旅。

1, 在命令行中输入：“grails create-app AjaxDemo”（注意：不带引号“”）创建一个Grails project，我将它命名为AjaxDemo：
D:/Temp/grails_apps>grails create-app AjaxDemo

Welcome to Grails 0.5 - http://grails.org/
Licensed under Apache Standard License 2.0
Grails home is set to: D:/D/MY_DEV/grails-0.5
Base Directory: D:/Temp/grails_apps
Environment set to production
Note: No plugin scripts found
Running script D:/D/MY_DEV/grails-0.5/scripts/CreateApp.groovy
[mkdir] Created dir: D:/Temp/grails_apps/AjaxDemo/src
[mkdir] Created dir: D:/Temp/grails_apps/AjaxDemo/src/java
[mkdir] Created dir: D:/Temp/grails_apps/AjaxDemo/src/groovy
[mkdir] Created dir: D:/Temp/grails_apps/AjaxDemo/src/test
[mkdir] Created dir: D:/Temp/grails_apps/AjaxDemo/grails-app
[mkdir] Created dir: D:/Temp/grails_apps/AjaxDemo/grails-app/controllers
[mkdir] Created dir: D:/Temp/grails_apps/AjaxDemo/grails-app/jobs
[mkdir] Created dir: D:/Temp/grails_apps/AjaxDemo/grails-app/services
[mkdir] Created dir: D:/Temp/grails_apps/AjaxDemo/grails-app/domain
[mkdir] Created dir: D:/Temp/grails_apps/AjaxDemo/grails-app/taglib
[mkdir] Created dir: D:/Temp/grails_apps/AjaxDemo/grails-app/utils
[mkdir] Created dir: D:/Temp/grails_apps/AjaxDemo/grails-app/views
[mkdir] Created dir: D:/Temp/grails_apps/AjaxDemo/grails-app/views/layouts
[mkdir] Created dir: D:/Temp/grails_apps/AjaxDemo/grails-app/i18n
[mkdir] Created dir: D:/Temp/grails_apps/AjaxDemo/grails-app/conf
[mkdir] Created dir: D:/Temp/grails_apps/AjaxDemo/grails-tests
[mkdir] Created dir: D:/Temp/grails_apps/AjaxDemo/scripts
[mkdir] Created dir: D:/Temp/grails_apps/AjaxDemo/web-app
[mkdir] Created dir: D:/Temp/grails_apps/AjaxDemo/web-app/js
[mkdir] Created dir: D:/Temp/grails_apps/AjaxDemo/web-app/css
[mkdir] Created dir: D:/Temp/grails_apps/AjaxDemo/web-app/images
[mkdir] Created dir: D:/Temp/grails_apps/AjaxDemo/web-app/WEB-INF/classes
[mkdir] Created dir: D:/Temp/grails_apps/AjaxDemo/web-app/META-INF
[mkdir] Created dir: D:/Temp/grails_apps/AjaxDemo/lib
[mkdir] Created dir: D:/Temp/grails_apps/AjaxDemo/spring
[mkdir] Created dir: D:/Temp/grails_apps/AjaxDemo/hibernate
[propertyfile] Creating new property file: D:/Temp/grails_apps/AjaxDemo/application.properties
[copy] Copying 2 files to D:/Temp/grails_apps/AjaxDemo
[copy] Copying 2 files to D:/Temp/grails_apps/AjaxDemo/web-app/WEB-INF
[copy] Copying 1 file to D:/Temp/grails_apps/AjaxDemo/web-app/WEB-INF
[copy] Copying 5 files to D:/Temp/grails_apps/AjaxDemo/web-app/WEB-INF/tld
[copy] Copying 119 files to D:/Temp/grails_apps/AjaxDemo/web-app
[copy] Copying 1 file to D:/Temp/grails_apps/AjaxDemo/grails-app/conf
[copy] Copying 1 file to D:/Temp/grails_apps/AjaxDemo/grails-app/conf
[copy] Copying 1 file to D:/Temp/grails_apps/AjaxDemo/grails-app/conf
[copy] Copying 1 file to D:/Temp/grails_apps/AjaxDemo/grails-app/conf
[copy] Copying 13 files to D:/Temp/grails_apps/AjaxDemo/grails-app
[mkdir] Created dir: D:/Temp/grails_apps/AjaxDemo/plugins/core/grails-app/taglib
[mkdir] Created dir: D:/Temp/grails_apps/AjaxDemo/plugins/core/grails-app/utils
[copy] Copying 7 files to D:/Temp/grails_apps/AjaxDemo/plugins/core/grails-app/taglib
[copy] Copying 4 files to D:/Temp/grails_apps/AjaxDemo/plugins/core/grails-app/utils
[copy] Copying 1 file to D:/Temp/grails_apps/AjaxDemo/spring
[copy] Copying 1 file to D:/Temp/grails_apps/AjaxDemo
[copy] Copying 1 file to D:/Temp/grails_apps/AjaxDemo
[copy] Copying 1 file to D:/Temp/grails_apps/AjaxDemo
[propertyfile] Updating property file: D:/Temp/grails_apps/AjaxDemo/application.properties
Created Grails Application at D:/Temp/grails_apps/AjaxDemo
D:/Temp/grails_apps>
   

2，“cd AjaxDemo”，进入AjaxDemo目录，输入“grails create-domain-class User”，创建一个域类User：

D:/Temp/grails_apps/AjaxDemo>grails create-domain-class User
Welcome to Grails 0.5 - http://grails.org/
Licensed under Apache Standard License 2.0
Grails home is set to: D:/D/MY_DEV/grails-0.5
Base Directory: D:/Temp/grails_apps/AjaxDemo
Environment set to production
Running script D:/D/MY_DEV/grails-0.5/scripts/CreateDomainClass.groovy
[copy] Copying 1 file to D:/Temp/grails_apps/AjaxDemo/grails-app/domain
Created  for User
[copy] Copying 1 file to D:/Temp/grails_apps/AjaxDemo/grails-tests
Created Tests for User
D:/Temp/grails_apps/AjaxDemo>

3，“grails generate-all User”，生成scaffolding code（如：list.gsp等）：

D:/Temp/grails_apps/AjaxDemo>grails generate-all User
Welcome to Grails 0.5 - http://grails.org/
Licensed under Apache Standard License 2.0
Grails home is set to: D:/D/MY_DEV/grails-0.5
Base Directory: D:/Temp/grails_apps/AjaxDemo
Environment set to production
Running script D:/D/MY_DEV/grails-0.5/scripts/GenerateAll.groovy
Compiling sources 
[mkdir] Created dir: D:/Temp/grails_apps/AjaxDemo/web-app/WEB-INF/lib
[mkdir] Created dir: D:/Temp/grails_apps/AjaxDemo/web-app/WEB-INF/spring
[copy] Copying 34 files to D:/Temp/grails_apps/AjaxDemo/web-app/WEB-INF/lib
[mkdir] Created dir: D:/Temp/grails_apps/AjaxDemo/web-app/WEB-INF/grails-app/i18n
[mkdir] Created dir: D:/Temp/grails_apps/AjaxDemo/web-app/WEB-INF/grails-app/views
[copy] Copying 2 files to D:/Temp/grails_apps/AjaxDemo/web-app/WEB-INF/grails-app/views
[mkdir] Created dir: D:/Temp/grails_apps/AjaxDemo/web-app/WEB-INF/templates/scaffolding
[copy] Copying 5 files to D:/Temp/grails_apps/AjaxDemo/web-app/WEB-INF/templates/scaffolding
[native2ascii] Converting 7 files from D:/Temp/grails_apps/AjaxDemo/grails-app/i18n to 
D:/Temp/grails_apps/AjaxDemo/web-app/WEB-INF/grails-app/i1
8n
[copy] Copying 1 file to D:/Temp/grails_apps/AjaxDemo/web-app/WEB-INF/spring
[copy] Copying 1 file to D:/Temp/grails_apps/AjaxDemo/web-app/WEB-INF/classes
[copy] Copying 1 file to D:/Temp/grails_apps/AjaxDemo/web-app/WEB-INF/classes
Generating views for domain class [User]
Generating list view for domain class [User]
list view generated at D:/Temp/grails_apps/AjaxDemo/./grails-app/views/user/list.gsp
Generating show view for domain class [User]
Show view generated at D:/Temp/grails_apps/AjaxDemo/./grails-app/views/user/show.gsp
Generating edit view for domain class [User]
Edit view generated at D:/Temp/grails_apps/AjaxDemo/./grails-app/views/user/edit.gsp
Generating create view for domain class [User]
Create view generated at D:/Temp/grails_apps/AjaxDemo/./grails-app/views/user/create.gsp
Generating controller for domain class [User]
Controller generated at ./grails-app/controllers/UserController.groovy
D:/Temp/grails_apps/AjaxDemo>
   

4，修改AjaxDemo/grails-app/controllers/UserController.groovy的内容为：

class  UserController {
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
[ userList: User.list( params ) ]
}
def show  =  {
[ user : User.get( params.id ) ]
}
def delete  =  {
def user  =  User.get( params.id )
if (user) {
user.delete()
flash.message  =   " User ${params.id} deleted. "
redirect(action:list)
}
else  {
flash.message  =   " User not found with id ${params.id} "
redirect(action:list)
}
}
def edit  =  {
def user  =  User.get( params.id )
if ( ! user) {
flash.message  =   " User not found with id ${params.id} "
redirect(action:list)
}
else  {
return  [ user : user ]
}
}
def update  =  {
def user  =  User.get( params.id )
if (user) {
user.properties  =  params
if (user.save()) {
redirect(action:show,id:user.id)
}
else  {
render(view: ' edit ' ,model:[user:user])
}
}
else  {
flash.message  =   " User not found with id ${params.id} "
redirect(action:edit,id:params.id)
}
}
def create  =  {
def user  =   new  User()
user.properties  =  params
return  [ ' user ' :user]
}
def save  =  {
def user  =   new  User()
user.properties  =  params
if (user.save()) {
redirect(action:show,id:user.id)
}
else  {
render(view: ' create ' ,model:[user:user])
}
}
//  自己添加的Closure ajax定义
def ajax  =  {}

//  自己添加的Closure sayHello定义
def sayHello  =  {
render  " [${new Date()}] Hello, ${params.name} "
}
}

添加sayHello闭包的目的很明显，因为客户端需要调用。那为什么还要添加ajax这个闭包呢？其实添加 ajax 这个闭包的目的是使http://localhost:8080/AjaxDemo/user/ ajax 这个请求合法化，否则会发生404错误，找不到页面：
HTTP ERROR: 404

Not Found

RequestURI=/AjaxDemo/user/ajax

Powered by Jetty://

所以被客户端请求的 每个 gsp页面，都需要在相应的Controller中添加以gsp文件名为变量名的Closure，如上面的ajax.gsp和ajax = {}所示，其中Closure中可以添加相关代码，我们这里仅仅是做Ajax的演示，所以就不需要代码

 

5，在AjaxDemo/grails-app/views/user目录下，新建ajax.gsp，用来演示remoteLink的用法，内容为：

< g:javascript  library ="prototype"   />

< div  id ="hello" > Content will be displayed here </ div >
< g:remoteLink  action ="sayHello"  params ="[name:'BlueSUN']"  
update ="hello" >Say Hello </ g:remoteLink >

params表示要传递的参数，而update表示返回结果显示的地方，注意update="hello"中的hello对应于div的id，表示结果将显示于div所在处。

点击链接后的界面：
[Fri May 11 17:46:47 CST 2007] Hello, BlueSUN
Say Hello

6，修改AjaxDemo/grails-app/views/user/ ajax.gsp，演示formRemote的用法，内容为：

<g:javascript library="prototype" />

<div id="hello">Content will be displayed here</div>
<div id="error"></div>
<g:remoteLink action="sayHello" params="[name:'BlueSUN']" 
update="hello">Say Hello</g:remoteLink>
<hr />
<g:formRemote name="test" url="[controller:'user',action:'sayHello']" 
update="[success:'hello',failure:'error']">
<input type="text" name="name" value="BlueSUN" />
<input type="submit" value="Say Hello" />
</g:formRemote >

原本用params传递的参数，现在可以以form的形式传递了，将想传递的内容输入name的textfield中即可。

默认值我设为BlueSUN，现在我将值改为terry，点击Say Hello按钮，结果如下：
[Fri May 11 18:16:17 CST 2007] Hello, terry
Say Hello

7，修改AjaxDemo/grails-app/views/user/ ajax.gsp和AjaxDemo/grails-app/controllers/UserController.groovy，演示remoteField的用法：
ajax.gsp:

<g:javascript library="prototype" />

<div id="hello">Content will be displayed here</div>
<div id="error"></div>
<g:remoteLink action="sayHello" params="[name:'BlueSUN']" 
update="hello">Say Hello</g:remoteLink>
<hr />
<g:formRemote name="test" url="[controller:'user',action:'sayHello']" 
update="[success:'hello',failure:'error']">
<input type="text" name="name" value="BlueSUN" />
<input type="submit" value="Say Hello" />
</g:formRemote >
<hr />
<g:remoteField action="sayHello2" update="hello"  name="name" value="" />
UserController.groovy:

class UserController {
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
[ userList: User.list( params ) ]
}
def show = {
[ user : User.get( params.id ) ]
}
def delete = {
def user = User.get( params.id )
if(user) {
user.delete()
flash.message = "User ${params.id} deleted."
redirect(action:list)
}
else {
flash.message = "User not found with id ${params.id}"
redirect(action:list)
}
}
def edit = {
def user = User.get( params.id )
if(!user) {
flash.message = "User not found with id ${params.id}"
redirect(action:list)
}
else {
return [ user : user ]
}
}
def update = {
def user = User.get( params.id )
if(user) {
user.properties = params
if(user.save()) {
redirect(action:show,id:user.id)
}
else {
render(view:'edit',model:[user:user])
}
}
else {
flash.message = "User not found with id ${params.id}"
redirect(action:edit,id:params.id)
}
}
def create = {
def user = new User()
user.properties = params
return ['user':user]
}
def save = {
def user = new User()
user.properties = params
if(user.save()) {
redirect(action:show,id:user.id)
}
else {
render(view:'create',model:[user:user])
}
}
// 自己添加的Closure ajax定义
def ajax = {}

// 自己添加的Closure sayHello定义
def sayHello = {
render "[${new Date()}] Hello, ${params.name}"
}

// 自己添加的Closure sayHello2定义
def sayHello2 = {
render "[${new Date()}] Hello, ${params.value}"
}
}

由于 用remoteField传递过来的参数名为value，又为了保留以前的演示，所以再定义一个sayHello2闭包，注意是params.value而非params.name

输入“BlueSUN” ，请注意输入时页面的相应更新效果，结果界面：
输入到一半，即输入“Blue”
[Fri May 11 18:34:03 CST 2007] Hello, Blue
Say Hello

紧接着输入“SUN”
[Fri May 11 18:32:42 CST 2007] Hello, BlueSUN
Say Hello

8，修改AjaxDemo/grails-app/views/user/ ajax.gsp，演示remoteFunction的用法，内容为：

<g:javascript library="prototype" />

<div id="hello">Content will be displayed here</div>
<div id="error"></div>
<g:remoteLink action="sayHello" params="[name:'BlueSUN']" 
update="hello">Say Hello</g:remoteLink>
<hr />
<g:formRemote name="test" url="[controller:'user',action:'sayHello']" 
update="[success:'hello',failure:'error']">
<input type="text" name="name" value="BlueSUN" />
<input type="submit" value="Say Hello" />
</g:formRemote >
<hr />
<g:remoteField action="sayHello2" update="hello"  name="name" value="" />
<hr />
<button onClick="${remoteFunction(action:'sayHello',
update:[success:'hello', failure:'error'], params:'/'name=/' + /'BlueSUN/'')}">
Say Hello</button>
   

点击Say Hello按钮后，结果页面：

[Fri May 11 18:48:37 CST 2007] Hello, BlueSUN
Say Hello

Say Hello

9，Grails也可以利用Ajax异步显示Server端返回的页面，新建页面AjaxDemo/grails-app/views/user/result.gsp:

< html >
< head >
< meta  http-equiv ="Content-Type" 

 content ="text/html; charset=UTF-8" />
< meta  name ="layout"  content ="main"   />
< title > Result Page </ title >
</ head >
< body >
< div  class ="nav" >
< span  class ="menuButton" >

< a  href ="${createLinkTo(dir:'')}" > Home </ a ></ span >
</ div >
< div  class ="body" >
< h1 > ${name} </ h1 >
</ div >
</ body >
</ html >

修改AjaxDemo/grails-app/controllers/UserController.groovy:

class  UserController {
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
[ userList: User.list( params ) ]
}
def show  =  {
[ user : User.get( params.id ) ]
}
def delete  =  {
def user  =  User.get( params.id )
if (user) {
user.delete()
flash.message  =   " User ${params.id} deleted. "
redirect(action:list)
}
else  {
flash.message  =   " User not found with id ${params.id} "
redirect(action:list)
}
}
def edit  =  {
def user  =  User.get( params.id )
if ( ! user) {
flash.message  =   " User not found with id ${params.id} "
redirect(action:list)
}
else  {
return  [ user : user ]
}
}
def update  =  {
def user  =  User.get( params.id )
if (user) {
user.properties  =  params
if (user.save()) {
redirect(action:show,id:user.id)
}
else  {
render(view: ' edit ' ,model:[user:user])
}
}
else  {
flash.message  =   " User not found with id ${params.id} "
redirect(action:edit,id:params.id)
}
}
def create  =  {
def user  =   new  User()
user.properties  =  params
return  [ ' user ' :user]
}
def save  =  {
def user  =   new  User()
user.properties  =  params
if (user.save()) {
redirect(action:show,id:user.id)
}
else  {
render(view: ' create ' ,model:[user:user])
}
}
//  自己添加的Closure ajax定义
def ajax  =  {}

//  自己添加的Closure sayHello定义
def sayHello  =  {
render  " [${new Date()}] Hello, ${params.name} "
}

//  自己添加的Closure sayHello2定义
def sayHello2  =  {
render  " [${new Date()}] Hello, ${params.value} "
}
//  自己添加的Closure displayResultPage定义
def displayResultPage  =  {
render(view: ' result ' , model:[name:params.name])
}
}

修改AjaxDemo/grails-app/views/user/ajax.gsp:

< g:javascript  library ="prototype"   />

< div  id ="hello" > Content will be displayed here </ div >
< div  id ="error" ></ div >
< g:remoteLink  action ="sayHello"  params ="[name:'BlueSUN']"  
update ="hello" > Say Hello </ g:remoteLink >
< hr  />
< g:formRemote  name ="test"  url ="[controller:'user',action:'sayHello']"  
update ="[success:'hello',failure:'error']" >
< input  type ="text"  name ="name"  value ="BlueSUN"   />
< input  type ="submit"  value ="Say Hello"   />
</ g:formRemote  >
< hr  />
< g:remoteField  action ="sayHello2"  
update ="hello"   name ="name"  value =""   />
< hr  />
< button  onClick ="${remoteFunction(action:'sayHello',
update:[success:'hello', failure:'error'], params:'/'name=/' + /'BlueSUN/'')}" 
> Say Hello </ button >
< hr  />
< g:formRemote  name ="test"  url ="[controller:'user',action:'displayResultPage']"  
update ="[success:'hello',failure:'error']" >
< input  type ="text"  name ="name"  value ="BlueSUN"   />
< input  type ="submit"  value ="Say Hello"   />
</ g:formRemote  >

输入“terry”，点击Say Hello按钮，结果页面（样式的丢失是因为在ajax.gsp中没有声明css，目的是抓重点，抛开一切琐碎的内容）：

 

最后要提醒大家一点，如果要使用中文，请将中文写在AjaxDemo/grails-app/i18n/messages_zh_CN.properties中，然后用<g:message code="key" />来显示。