Grails + EJB领域模型教程
作者 Jason Rudolph 译者 胡键 发布于 2007年8月26日 下午9时3分
Ruby on Rails不断地受到软件工程世界的关注,但企业依旧对其表示怀疑。为什么会这样?我们怀疑:“构建于脚本语言之上的框架,怎能适合我的企业应用?!”针对Ruby on Rails,典型的论调就是缺少对企业服务(如分布式事务、消息传递等)的支持。对很多企业而言,如果平台没有这些服务,那么它将不可能被考虑。
Grails旨在解决那些关注点,并证明快速应用开发(RAD)对企业是可行的。Grails建构于Groovy之上,提供了与Java的无缝集成。它能直接访问你的业务所依赖的那些企业服务,同时为你的工具集增添强大的动态语言结构。
作为展示它企业集成能力的令人印象深刻的一个例子,Grails可让你快速而简单的基于已有EJB3实体Bean构建一个Web应用。但是,它的能力并不是仅此而已。Grails大幅增强了你的实体Bean的能力,而且这些完全是动态做到的,没有更改任何你的EJB源码。Grails对象关系映射(GORM)建立在Hibernate3(最终将提供对Java持久化API的支持)之上,利用Groovy的元对象协议(MOP)为你的不同静态实体Bean增加了各种方便的动态方法。这些方法不仅能从Grails和Groovy访问,而且你的Java代码同样能访问它们!我们瞬间就拥有了JEE/EJB3的企业级能力和RAD Web应用开发的全部好处!
那么,让我们看看基于EJB3实体Bean构建Grails应用要做哪些工作。在以下步骤中,我们将创建一个新的Grails应用,将实体Bean导入到应用,为实体Bean产生快速构建缺省Web界面的脚手架代码(scaffolding),然后再探索Grails为实体Bean增加的一些方便的动态方法。
首先,我们需要从一个EJB3应用开始。(Grails并不需要你以一个EJB3应用作为起点。但是,本文的一般性假设是你有兴趣将RAD Web开发并入你的EJB3项目。)假设我们有一些EJB3实体Bean,它们代表一个公司里的员工(EmployeeBean)和分配给员工的计算机(ComputerBean)。(如果遇到任何问题,请参见资源小节。你将在那儿找到该Grails应用的完整源代码——一个使用这些实体Bean的简单JEE应用——以及其它有用的东西。)
以下是支持我们实体Bean的两张表。(例子中,我们将使用MySQL 5.0。你可以使用这个脚本创建一个名为ejb3example的新数据库,它同时将生成这些表。)
接下来,让我们快速地查看一下公司里忙碌地工蜂们及他们的硬件。
构建与这些数据交互的Web用户界面,并和已有代码集成要花多长时间呢?它这不应该花费太多的时间,但是,我们肯定已经接受了这样的观点,即这个过程需要重大的努力。使用Grails,无需如此。
步骤1 —— 安装Grails
因为EJB3依赖JDK 5,所以你需要确保JDK 5已经安装,并将你的JAVA_HOME环境变量指向JDK 5的安装目录。
按照这些快速步骤,在你的系统上安装Grails。(本文使用Grails 0.2.1,它是撰写文章时的最新稳定发布。译注:当前的版本是0.5.6。)(如果你在使用*nix系统,如遇安装问题,请检查这个线索。)
步骤2 —— “Hello Grails!”
- 在命令提示符下,进入你想创建Grails应用的目录。然后输入grails create-app。当询问应用名时,输入ejb3_grails。
jMac:~/dev jason$ grails create-app
...
create-app:
[input] Enter application name:
ejb3_grails
...
BUILD SUCCESSFUL
Total time: 4 seconds - 为了验证环境正确,启动应用。进入刚刚创建的应用目录,然后输入grails run-app启动应用。
jMac:~/dev jason$ cd ejb3_grails jMac:~/dev/ejb3_grails jason$ grails run-app ... run-app:watch-context:
- 现在,应用正等待我们的请求。打开浏览器,输入http://localhost:8080/ejb3_grails/,你应该看到以下欢迎你进入Grails的友好信息。
步骤3 —— 导入实体Bean
- Grails预装了HSQLDB,但因为我们使用的是MySQL,我们需要一些快捷的步骤,来告诉Grails如何与我们的数据库进行交流。首先,从http://www.mysql.com/products/connector/j/下载MySQL的Java驱动。我选择的是当前可用于产品阶段的产品,在本文撰写的时候,它的版本是3.1.13。
- 打开zip文件,将其中的mysql-connector-java-3.1.13-bin.jar解压到你的Grails应用的lib目录——本例中,是ejb3_grails/lib。(注意:JAR文件确切的名字会跟据你下载驱动的版本不同而变化)。
- 现在,我们准备告诉Grails在哪儿找到我们的数据库。用你喜爱的编辑器打开ApplicationDataSource.groovy,按以下内容修改。你可以在ejb3_grails/grails-app/conf/中找到这个文件。(注意:你需要改变用户名和口令以适应你MySQL帐号。)
import org.codehaus.groovy.grails.orm.hibernate.cfg.GrailsAnnotationConfiguration
class ApplicationDataSource {
def configClass = GrailsAnnotationConfiguration.class
boolean pooling = true
//String dbCreate = "create-drop" // one of 'create', 'create-drop','update'
String url = "jdbc:mysql://localhost/ejb3example"
String driverClassName = "com.mysql.jdbc.Driver"
String username = "ejb3example"
String password = "ejb3example"
}除了指明链接设置,我们还需要定义configClass成员,以允许Grails支持在实体Bean中使用标注。
最后,我们需要给dbCreate设置加上注释。这个设置允许Grails在运行时使用你的领域对象同步更新数据库模式。尽管它是个强大的选项,但是在这个例子中我们并不需要。通过把这个设置注释掉,我们指示Grails保持模式的原样。
-
接下来,我们需要将实体Bean——EmployeeBean和ComputerBean——复制到我们的Grails工程。Grails会在src/java目录中查找Java类。请确保创建与这些类的包相匹配的、完整的目录结构。
jMac:~/dev/ejb3_grails/src/java/com/jasonrudolph/ejb3example/entity jason$ ls
ComputerBean.java EmployeeBean.java在很长时间内,你将需要确保这些文件与这些类的正式副本保持同步(它们在你的JEE工程源码树中)。使用构建脚本,你可以很容易地做到这点。即,在构建时,将这些文件从JEE工程中复制到Grails工程中。
- Grails允许我们与任何Java类工作,但是我们需要让Grails给予这些特殊的Java类(也就是我们的实体Bean)特别的对待。我们要让Grails将这些类认为是我们的领域类,并提供Grails领域类所拥有的ORM和动态方法的全部好处。要做到这些,我们需要在应用的hibernate目录增加如下的hibernate.cfg.xml文件,注册这些类。
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE hibernate-configuration PUBLIC
"-//Hibernate/Hibernate Configuration DTD 3.0//EN"
"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd">
<hibernate-configuration>
<session-factory>
<mapping package="com.jasonrudolph.ejb3example.entity" />
<mapping class="com.jasonrudolph.ejb3example.entity.EmployeeBean" />
<mapping class="com.jasonrudolph.ejb3example.entity.ComputerBean" />
</session-factory>
</hibernate-configuration>
步骤4 —— 产生脚手架代码
现在,我们准备真正开始蓄势待发了。我们至今为止所做的大多数事情并没有被免去。(不论你的框架是多么的聪明,你总得告诉它在哪儿找到数据库。)然而,为用户界面构造一个好的、功能性的起点不再是手工活儿了。
- 确保你在工程的根目录下——在我们的例子中,它是ejb3_grails。然后,输入grails generate-controller。当询问领域类名时,输入我们第一个实体Bean的全限定类名——com.jasonrudolph.ejb3example.entity.EmployeeBean.。
jMac:~/dev/ejb3_grails jason$ grails generate-controller ... input-domain-class: [input] Enter domain class name: com.jasonrudolph.ejb3example.entity.EmployeeBean ... [java] Generating controller for domain class [com.jasonrudolph.ejb3example.entity.EmployeeBean] [java] Controller generated at ./grails- app/controllers/EmployeeBeanController.groovy BUILD SUCCESSFUL Total time: 10 seconds
- 既然有了控制器(controller),让我们产生相应的视图(view)。输入grails generate-views。当询问领域类名时,输入com.jasonrudolph.ejb3example.entity.EmployeeBean。
jMac:~/dev/ejb3_grails jason$ grails generate-views ... input-domain-class: [input] Enter domain class name: com.jasonrudolph.ejb3example.entity.EmployeeBean ... [java] Generating views for domain class [com.jasonrudolph.ejb3example.entity.EmployeeBean] [java] Generating list view for domain class [com.jasonrudolph.ejb3example.entity.EmployeeBean] [java] list view generated at /Users/jason/dev/ejb3_grails/./grails- app/views/employeeBean/list.gsp [java] Generating show view for domain class [com.jasonrudolph.ejb3example.entity.EmployeeBean] [java] Show view generated at /Users/jason/dev/ejb3_grails/./grails- app/views/employeeBean/show.gsp [java] Generating edit view for domain class [com.jasonrudolph.ejb3example.entity.EmployeeBean] [java] Edit view generated at /Users/jason/dev/ejb3_grails/./grails- app/views/employeeBean/edit.gsp [java] Generating create view for domain class [com.jasonrudolph.ejb3example.entity.EmployeeBean] [java] Create view generated at /Users/jason/dev/ejb3_grails/./grails- app/views/employeeBean/create.gsp BUILD SUCCESSFUL Total time: 11 seconds
-
对其他实体Bean(即com.jasonrudolph.ejb3example.entity.ComputerBean),重复以上过程,以产生相应的控制器和视图。
-
现在,让我们运行应用,看看通过以上那么丁点儿努力,我们得到了什么。输入grails run-app。打开浏览器,进入http://localhost:8080/ejb3_grails/。
-
很好,我们现在已有了两个控制器。并且,正如这儿的文字所建议的,我们最终会使用我们自己自定义的首页面替换它。至于现在,让我们转到EmployeeBeanController。
这儿,我们看到了大多数想要的东西。显然Computers这一列需要进行些调整,然而在别的方面,这页只需作一些装饰性的修改就可以用了。
让我们花些时间参观一下这个应用,看看我们现在得到了什么。试试创建新员工、编辑员工,接下来(如果你觉得特别有权势)终结某个可怜虫。对于计算机管理,试试类似的特性。在体验过程中,记下你想改变以及需要修改的地方。同时,一定要考虑那些已经满足了你需要的东西。它们是你“不劳而获”的内容!
......
完工了?很好,以下是一张我们所需东西的清单,然后我们可以谈谈那些“有则更好”(nice-to-have)的条目。
- 关系管理——很明显,脚手架在这个领域做了尝试,但还是不满足我们的需要。幸运的是,这非常容易修补(瞧瞧,即使是Ruby on Rails脚手架也没有给你免费的关系管理。)
- 验证——它只是被遗漏了。非常简单。我们也可以很快地添加它。
就是它了。如果我们能实现正确的关系管理和验证,我们将获得一个功能齐全的Web应用来管理我们的实体Bean。在这之后,其余的就是小菜一碟。(尽管我们确定要在结束之前尝尝一些可口的小菜。)
步骤5 —— 增加关系管理
关于关系管理,我们对应用有哪些期望?嗯,要我说,我们应该能……
- 查看分配给某个员工的所有计算机。
- 查看单个计算机的细节(包括它的分配状况)。
- 能增加、修改和删除计算机(包括它的分配状况)。
准备好了吗?让我们开始吧。
-
在员工页列出计算机没有什么意义,因此让我们把这列移除。打开grails-app/views/employeeBean/list.gsp,并移除该列。现在,刷新浏览器,验证修改。
-
接下来,点击显示(Show),查看员工的细节。
最少,我们需要整理显示每个计算机的文本。但是,可能我们根本就不愿直接在这个页面上看到计算机。与其在该页显示计算机,不如包含一个指向该员工的计算机列表的链接。
打开该页模板(即,grails-app/views/employeeBean/show.gsp),移除显示当前员工计算机列表的行。接着增加以下行,链接到显示该员工的计算机列表的单独页面。
<tr class="prop">
<td colspan="2" align="left" class="name">
<g:link controller='computerBean' action='showComputersByEmployee'
id='${employeeBean.id}' >Show Computers</g:link>
</td>
</tr>此处,我们使用了Grails标签库。link标签将产生指向ComputerBeanController的链接,并调用一个我们需要定义的新动作,showComputersByEmployee。该链接还包含了所请求员工的ID。
让我们刷新浏览器,看看变化。
很好,我们得到链接了。现在,我们需要为链接定义一个新动作。在编辑器中打开grailsapp/controllers/ComputerBeanController.groovy,因为新动作将通过员工查找计算机,我们首先需要增加引用EmployeeBean类的import语句。
import com.jasonrudolph.ejb3example.entity.EmployeeBean
接着,我们增加新动作。
def showComputersByEmployee = {
render(view:'list', model:[ computerBeanList:
ComputerBean.findAllByEmployeeBean(EmployeeBean.get(params.id)) ])
}这个动作让我们好好见识了一下Groovy(和Grails)的能力,通过简单的几行代码,你的表现力究竟有多大。在以上几行代码中,我们告诉Grails,任何showComputersByEmployee的调用应该......
- 使用params.id从request中获得员工
- 使用EmployeeBean#get方法获得员工ID对应的员工
- 使用ComputerBean#findAllByEmployeeBean方法找出与员工相关的所有计算机
- 将结果放入名为computerBeanList的对象
- 展现(render)视图,在一个名为list的模板中,使用computerBeanList对象作为模型。
记得曾在EmployeeBean中定义get方法,以及ComputerBean中定义findAllByEmployeeBean方法吗?没有?答对了。这些方法只是Grails为你的领域对象所提供的众多动态方法的一小部分而已。之后,我们将更多的探讨这些条目。现在,我们准备点击显示计算机链接了。
我们越来越接近完工了。我们仍然需要修改Employee Bean列中的文本。我们需要在此显示些更让人明白点儿的东西。
同样,我们可能更愿意标出这些计算机所属的员工。我们当前重用了list模板(作为ComputerBean的脚手架代码的一部分产生),而那个模板最初是为了列出所有计算机而设计的。另一方面,我们总能定义一个单独的模板,它用于显示计算机的子集,或能使list模板更动态一些以支持两个场景。就现在而言,我们将去掉这个特性,将其作为“有则更好”,而非必要的特性。
我们应该完成了管理员工所需的所有改变。现在,我们只需整理计算机管理的特性。
- 既然我们就在这儿,让我们整理一下计算机list模板。替换Employee Bean列的当前文本,改为显示员工的网络ID。打开grails-app/views/computerBean/list.gsp。找到在展现Employee Bean列文本的Groovy脚本……
${it.employeeBean}
……将它改为显示员工的网络ID。
${it.employeeBean.networkId}
刷新浏览器,让我们看看它的样子。(Employee列在Brand列和Model列之间显得有些不合适,所以我调换了一下它们的位置。不愿这样做也可以。)
list模板完成了,现在该show模板了。
-
点击显示(Show)链接,并访问我们需要改变的页面。
看起来,我们只需改变员工链接的文本就行了。对此,我们完全赞同。那么,打开grailsapp/views/computerBean/show.gsp,并找到展现当前链接文本的那段脚本。
${computerBean?.employeeBean}
就象我们为list模板所做的那样,改变代码以显示员工的网络ID。
${computerBean?.employeeBean.networkId}
让我们再次刷新浏览器,并验证我们的改变。(同样,Employee行在Brand行和Model行之间显得有些不合适。因此,只要觉得合适,你可以随意重新调整这些行。)
-
让我们转到编辑(edit)功能。
我们着手查看这儿的一个主题。我们需要改变选择框,以提供一组网络ID的列表。在grails-app/views/computerBean/edit.gsp中找到<g:select>标签,把它修理成以下内容:
<g:select optionKey="id"
from="${com.jasonrudolph.ejb3example.entity.EmployeeBean.list()}"
name='employeeId'
optionValue='networkId'
value='${computerBean.employeeBean?.id}'>
</g:select>通过给标签增加optionValue参数,选择框中的文本会更具有含义。
现在,视图被修正了,但是更新(update)功能还需要除了视图之外的一点努力。我们同样需要增强控制器(即ComputerBeanController.groovy)。如果用户改变关联了计算机的员工,我们需要确保正确地持久化这些关联的变化。换句话说,我们需要从当前的员工去除关联,而将它分配给新的员工。这个增强型的更新方法需要一点额外的代码行。
def update = {
def computerBean = ComputerBean.get( params.id )
if(computerBean) {
if (computerBean.employeeBean) {
computerBean.employeeBean.computers.remove(computerBean)
}
computerBean.properties = params
def employeeBean = EmployeeBean.get(params.employeeId)
employeeBean.computers.add(computerBean)
computerBean.employeeBean = employeeBean
if(computerBean.save()) {
redirect(action:show,id:computerBean.id)
}
else {
render(view:'edit',model:[computerBean:computerBean])
}
}
else {
flash.message = "ComputerBean not found with id ${params.id}"
redirect(action:edit,id:params.id)
}
}保存你的改变,我们准备试验它了。让我们改变这台计算机的品牌——现在是联想(Lenovo)了——并将它重新分配给John Doe。
-
当然,我们也需要能够给我们的库存增加新的计算机。因此,让我们点击新建计算机(New ComputerBean)。
我们经过上次更改编辑(Edit)页之后,我们已具有很好的资格来整理这一页。我们需要对选择框做些相同的调整。打开grails-app/views/computerBean/create.gsp,调整<g:select>标签,并刷新你的浏览器。
<g:select optionKey="id"
from="${com.jasonrudolph.ejb3example.entity.EmployeeBean.list()}"
name='employeeId'
optionValue='networkId'
value='${computerBean.employeeBean?.id}'>
</g:select>正如我们看到的编辑(edit)功能,我们需要对控制器进行轻微的增强。当我们创建新计算机时,我们需要在保存它之前分配给一个员工。编辑ComputerBeanController.groovy,以包含这个被更新的保存(save)方法。
def save = {
def computerBean = new ComputerBean()
computerBean.properties = params
def employeeBean = EmployeeBean.get(params.employeeId)
employeeBean.computers.add(computerBean)
computerBean.employeeBean = employeeBean
if(computerBean.save()) {
redirect(action:show,id:computerBean.id)
}
else {
render(view:'create',model:[computerBean:computerBean])
}
}回到浏览器,我们准备创建一个新计算机了。填写空的域,并创建。
现在,Jane有一台崭新的膝上电脑了。
-
7. 最后,只剩下删除(delete)功能了。这次我们不需要改变任何模板。我们只需要给控制器增加一行。当我们在ComputerBeanController.groovy中删除一台计算机时,我们同样需要移除对应的计算机与员工的关联。以下的第四行代码负责这些。
def delete = {
def computerBean = ComputerBean.get( params.id )
if(computerBean) {
computerBean.employeeBean.getComputers().remove(computerBean)
computerBean.delete()
flash.message = "ComputerBean ${params.id} deleted."
redirect(action:list)
}
else {
flash.message = "ComputerBean not found with id ${params.id}"
redirect(action:list)
}
}看起来Jane的新MacBook被回收了。我们应该删除它吗?
此时,我们完成它了!使用快捷的几步,我们现在已经有了一个功能完备的Web应用,它构建于我们的实体Bean上。当然,它还需一些打磨。但至少,作为一个可工作的原型,它已经足够了。尽管仍需改良,但它是个完全能发展成完美产品的一个原型。
步骤6 —— 定义验证规则
我们近期肯定需要的一件事就是某种验证逻辑。幸运的是,Grails提供了非常方便的声明性验证机制。对于每个实体Bean,我们仅需增加一个Groovy脚本来定义合适的约束。根据惯例,Grails以领域类名+“Constraints”为名字(如EmployeeBeanConstraints.groovy),去查找脚本。
那么,让我们为每个实体Bean来定义约束吧。最少,我们需要约束匹配我们的数据模型。我们也会加入一些基本的业务验证规则。如,数据库要求网络ID长度不超过8个字符,但是,我们也会加强我们的业务规则,要求网络ID的长度必须不小于6位字符。(译注:即长度>=6且<=8)
Grails在领域类相同的目录下查找约束声明。对于EmployeeBean类,我们需要创建名为EmployeeBeanConstraints.groovy的文件,并将它放在ejb3_grails/src/java/com/jasonrudolph/ejb3example/entity/。文件应该包含以下规则:
constraints = {
networkId(length:6..8,blank:false,unique:true)
firstName(maxLength:20,blank:false)
lastName(maxLength:20,blank:false)
startDate(nullable:false)
}
接下来,定义用于ComputerBean类的约束。同样,文件也要在相同的目录下,命名为ComputerBeanConstraints.groovy.。
constraints = {
serialNumber(maxLength:20,blank:false)
brand(maxLength:20,blank:false)
model(maxLength:20,blank:false)
}
为了使这些约束生效,我们需要重启应用。在启动应用的控制台中,输入Control-C结束应用。然后,再输入grails run-app,我们准备开始测试验证了。
现在,如果我们试图偷偷在一个新员工中输入一个无效网络ID,应用应该会拒绝它。
很自然,我们需要修改错误消息,使其更具业务含义,技术性更小一些。Grails提供了一个消息资源文件,它可让你自定义错误消息。
我们定义的约束只代表了Grails提供验证的小部分例子。请查看Grails文档以获得全部可用的约束。
步骤7 —— 获得动态能力
至今所做的任何事情都向我们展示了,我们可以比曾经所想象的更快的速度来构建Web应用,并且我们已看到了这个即将到来的框架一些令人印象深刻的特性。这才是真正魔术的开始!还记得当我们增加查看用户所分配的所有计算机功能的时候曾简单地提过动态方法吗?让我们更深入的看看这个特性吧。
一旦我们具备了基本的CRUD功能,接下来第一个要求是,“我需要一种通过____来查看所有员工的方法”,或“从序列号____开始显示所有由____制造的计算机”。这些都是合理的要求,但是一般情况下构建这些简单的报表需要花费多少努力呢?通常这需要在某个会话Bean中增加一个新方法,在我们Web框架的配置文件中增加一个新映射,可能甚至需要些SQL,等等。利用Grails,我们不仅无需那些东西就可完成,而且还为快速适应下一个变化作好了准备。
对于初学者,我们假定需要能够通过last name找到所有员工。我们将给员工列表(Employee List)页面增加新的菜单项,它将带我们到新的查询页。在grails-app/views/employeeBean/list.gsp中的菜单部分增加下列代码。
<span class="menuButton">
<g:link action="search">Search Employees</g:link>
</span>
点击这个菜单项将调用控制器中名为Search的新动作。除了展现搜索输入页,我们不需要让这个动作干别的。因此,在EmployeeBeanController.groovy中增加一个空方法来接收请求。
def search = {
}
这个空动作告诉Grails,search是该控制器的有效动作,当Grails收到关于该action的请求时,它将在grails-app/views/employeeBean/中简单地查找同名(即search.gsp)模板,并展现它的内容。
既然,我们事实上只是需要一个用于员工的包含输入框的简单表单,我们可以将create.gsp作为一个好的起点。当我们完成时,新的search.gsp模板应该是如下的样子:
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="layout" content="main" />
<title>Search Employees</title>
</head>
<body>
<div class="nav">
<span class="menuButton">
<a href="${createLinkTo(dir:'')}">Home</a></span>
<span class="menuButton">
<g:link action="list">EmployeeBean List</g:link></span>
</div>
<div class="body">
<h1>Search Employees</h1>
<g:form action="showSearchResults" method="post" >
<div class="dialog">
<table>
<tr class='prop'>
<td valign='top' class='name'>
<label for='lastName'>Last Name Like:</label>
</td>
<td valign='top' class='value'>
<input type='text' name='lastName' value='' />
</td>
</tr>
</table>
</div>
<div class="buttons">
<span class="formButton">
<input type="submit" value="Search"></input>
</span>
</div>
</g:form>
</div>
</body>
</html>
如果你认为我们不应该重复这么多的包装器内容(如<head>标签等),那么你是对的。Grails提供了各种布局机制来避免这种重复。(我们将把这作为读者的一个练习。)同时,我们的搜索页就绪了。(尽管Grails通常提供这种变化的动态部署,但一些读者已经报告,为了能成功访问搜索页需要重启应用。要这么做,在启动应用的控制台中输入Control-C。然后输入grails run-app,然后进入搜索页。)
在search.gsp中,你会注意到,我们指定表单应该将所有请求发往一个新的名为showSearchResults(够直白的)的动作。因此,我们需要在EmployeeBeanController.groovy中定义这个新的动作。
def showSearchResults = {
render(view:'list', model:[ employeeBeanList:
EmployeeBean.findAllByLastNameLike("%" + params.lastName + "%") ])
}
因为我们只想显示匹配的员工列表,所以我们可安全地使用已有的list.gsp模板。这是Grails提供的另一个以简洁命令完成重要功能的例子。所有给showSearchResults的请求将……
- 使用params.lastName获得搜索条件
- 用员工匹配lastName获得EmployeeBean对象列表
- 把结果放入名为employeeBeanList的对象
- 展现视图,使用list模板,使用employeeBeanList对象作为模型。
当我们点击搜索,我们肯定会得到匹配结果。
当然,如果我们能使用last name来搜索员工,为什么不能用first name完成同样的事?在搜索页,我们可以很容易的增加一个新的输入框。
<tr class='prop'>
<td valign='top' class='name'>
<label for='lastName'>First Name Like:</label>
</td>
<td valign='top' class='value'>
<input type='text' name='firstName' value='' />
</td>
</tr>
非常简单,但是对控制器需要做哪些改动呢?非常少,取代findAllByLastNameLike方法,现在调用findAllByLastNameLikeAndFirstNameLike。
def showSearchResults = {
render(view:'list', model:[ employeeBeanList:
EmployeeBean.findAllByLastNameLikeAndFirstNameLike("%" + params.lastName + "%",
"%" + params.firstName + "%") ])
}
Grails为你所能想到的每个查询组合自动提供动态查找器!不信试试。来自以上各域的搜索,只是我们期望给查询的变更。
步骤8 —— 构造自己的条件
随着时间的流逝,你可能发现需求变得复杂起来。我们如何处理需要组合各种条件集合的查询呢?如,想象我想查找所有的员工,根据……
- 网络ID使用大小写敏感,部分匹配一些值,或者
- first name和last name精确匹配它们各自的条件。
这种查询已经超出了我们刚刚看到的动态查找器的能力。不要担心。这不意味着你的应用必须承担任何额外的复杂性。Grails提供了非常灵活的Hibernate Criteria Builder以满足需要,并且不以牺牲我们至今已看到的任何功能为代价。
首先,让我们修改搜索页以捕获用于新需求的输入。如果我们编辑search.gsp,并使用以下域替换当前的输入域,我们将会获得所期望的东西。
<tr class='prop'>
<td valign='top' class='name'><label for='lastName'>Network ID Like:</label></td>
<td valign='top' class='value'>
<input type='text' name='networkId' value='' />
</td>
</tr>
<tr><td>-- or --</td></tr>
<tr class='prop'>
<td valign='top' class='name'><label for='lastName'>First Name Equals:</label></td>
<td valign='top' class='value'>
<input type='text' name='firstName' value='' /></td>
</tr>
<tr class='prop'>
<td valign='top' class='name'><label for='lastName'>Last Name Equals:</label></td>
<td valign='top' class='value'>
<input type='text' name='lastName' value='' />