Appfuse开发实践（五）—— 增加校验和列表页面
Appfuse开发实践（五）—— 增加校验和列表页面
第四部分： 增加校验和列表页面 - 增加Person对象的校验逻辑保证firstName和lastName是非空字段并且加入列表页面显示数据库中所有的person纪录。
看这个部分的指南参考上一部分的指南：创建Webwork 框架的 Actions和JSP
第四部分： 增加校验和列表页面 - 增加Person对象的校验逻辑保证firstName和lastName是非空字段并且加入列表页面显示数据库中所有的person纪录。
看这个部分的指南参考上一部分的指南：创建Webwork 框架的 Actions和JSP
内容提要
本文将展示如何使用Webwork的校验框架加入校验逻辑。并且将使用Display标签库（Tag Library)创建列表页面显示数据库中的所有Person。
内容列表
[1] 使用校验规则创建Person-validation.xml文件
[2] 察看加入了校验的JSP页面并且进行测试
[3] 在DAO、ManagerTest类中加入testGetPeople方法声明年
[4] 在PersonDAO和Manager类中增加 getPeople 方法
[5] 在Action Test中加入testSearch方法
[6] 在Action中加入search方法
[7] 创建personList.jsp和Canoo test
[8] 在菜单中加入链接
一、使用校验规则创建Person-validation.xml文件
为了利用WebWork校验框架实现数据校验有两件事情要做，第一是创建一个validation.xml文件，第二是在需要进行校验的action中加入一个校验interceptor引用。
WebWork允许两种类型的校验 —— per-action和model-based。因为所有的Action对Person引用都要使用相同的校验规则，所以本文将使用model-based类型的校验。
在src/dao/**/model目录下创建Person-validation.xml文件并加入下列内容：
<!DOCTYPE validators PUBLIC "-//OpenSymphony Group//XWork Validator 1.0//EN"
"http://www.opensymphony.com/xwork/xwork-validator-1.0.dtd">
<validators>
<field name="person.firstName">
<field-validator type="requiredstring">
<message key="errors.required"/>
</field-validator>
</field>
<field name="person.lastName">
<field-validator type="requiredstring">
<message key="errors.required"/>
</field-validator>
</field>
</validators>
在ApplicationResources_*.properties文件中的"errors.message" 键值使用字段的"name"属性以实现国际化。如果不需要提供对i18n的支持可以直接对<message>元素中指定显示内容。
errors.required=${getText(fieldName)} is a required field.
现在可以配置PersonAction使用visitor validation。为了实现这个目标，在PersonAction目录下创建一个PersonAction-validation.xml文件。加入下面的内容：
<!DOCTYPE validators PUBLIC "-//OpenSymphony Group//XWork Validator 1.0//EN"
"http://www.opensymphony.com/xwork/xwork-validator-1.0.dtd">
<validators>
<field name="person">
<field-validator type="visitor">
<param name="appendPrefix">false</param>
<message/>
</field-validator>
</field>
</validators>
糟糕的是，WebWork没有提供一个透明机制读取Person-validation.xml文件并且标记在UI上标记哪个字段时必须的。AppFuse的Struts和Spring版本使用LabelTag实现了这个目标，不过他们也只是实现了一个普通的校验。我希望有人能够为WebWork提供相同的功能实现。同时JSP tags "required" 属性实际上没有对你所指定的校验规则作任何事情，仅仅是在加入对应的字段后面加入了一个星号而已。
当然，也可以使用per-action校验。只需要拷贝Person-validation.xml文件到"webapp.action"包中并且把它重命名为PersonAction-validation.xml。
为了使在"savePerson" 操作中我们新加入的校验规则发挥作用，我们要把原来在"validator"属性上的注释去掉。确定最后在web/WEB-INF/classes/xwork.xml文件的"savePerson" <action> 部分包含以下内容：
<interceptor-ref name="validationStack"/>
说明：在Appfuse中使用的validationStack和WebWork自带的有些不同，更多的信息可以在WebWork's JIRA中查找。
二、查看加入了校验的JSP并进行测试
现在保存所有的文件。为了测试加入了校验后的JSP，运行 ant db-load deploy，启动Tomcat并且在浏览器中输入 http://localhost:8080/myApp/editPerson.html?id=1。
如果擦掉了firstName或者lastName字段的值并点击save按钮，你将看到错误提示信息（图片略）：
三、在DAO和Manager Test中加入testGetPeople方法
为了创建一个List页面(或者说是master页面)，我们需要穿件一个方法返回person表中的所有行。我们首先在PersonDAOTest和 PersonManagerTest类中创建测试方法。通常把这个方法命名为getEntities (例如getUsers)，你也可以使用 getAll 或者 search —— 这其实是同一类问题。
打开test/dao/**/dao/PersonDAOTest.java文件加入testGetPeople方法：
public void testGetPeople() {
person = new Person();
List results = dao.getPeople(person);
assertTrue(results.size() > 0);
}
我在getPeople方法中传入一个person对象是想在以后方便加入过滤(filtering)处理 (基于person对象中的属性值)。在getPeople()方法中应该说明这个参数是可选的。
现在打来test/service/**/service/PersonManagerTest.java文件加入testGetPeople方法。
public void testGetPeople() {
List results = mgr.getPeople(new Person());
assertTrue(results.size() > 0);
}
为了这两个类能够通过编译，需要在PersonDAO和PersonManager接口中加入getPeople()方法并且加入实现。
四、在DAO和Manager加入getPeople()方法
打开src/dao/**/dao/PersonDAO.java文件并且加入getPeople()方法说明：
public List getPeople(Person person);
现在在src/service/**/service/PersonManager.java文件中加入同样的方法。保存所有的文件并且在tests类中调整imports类。接下来在实现类中实现getPeople()方法。打开src/dao/**/dao/hibernate/PersonDAOHibernate.java文件加入下面的代码：
public List getPeople(Person person) {
return getHibernateTemplate().find("from Person");
}
你可以注意到现在没有对person 参数作任何处理。仅仅是占了个位置 —— 在以后你可以依靠它的属性值使用Hibernate's查询语言或者Criteria Queries加入filter。
一个使用Criteria Query的示例：
Example example = Example.create(person)
.excludeZeroes() // exclude zero valued properties
.ignoreCase(); // perform case insensitive string comparisons
try {
return getSession().createCriteria(Person.class)
.add(example)
.list();
} catch (Exception e) {
throw new DataAccessException(e.getMessage());
}
return new ArrayList();
在src/service/**/impl/PersonManagerImpl.java中实现getPeople() 方法：
public List getPeople(Person person) {
return dao.getPeople(person);
}
保存所有的变更，运行下面的测试方法：
ant test-dao -Dtestcase=PersonDAO
ant test-service -Dtestcase=PersonManager
如果一切正常可以在web层加入读取所有人员信息的功能实现了。
五、在Action Test中加入testSearch()方法
打开test/web/**/action/PersonActionTest.java文件加入下面的方法：
public void testSearch() throws Exception {
assertNull(action.getPeople());
assertEquals(action.list(), "success");
assertNotNull(action.getPeople());
assertFalse(action.hasActionErrors());
}
只有在PersonAction中加入getPeople() 和 list() 方法这个类才能通过编译。
六、在Action中加入list()和getPeople()方法
打开src/web/**/action/PersonAction.java 加入list() 方法。在此之前加入"people"变量和getPeople() 方法。
private List people;
public List getPeople() {
return people;
}
public String list() {
people = personManager.getPeople(new Person());
return SUCCESS;
}
运行ant test-web -Dtestcase=PersonAction进行测试。
好!
BUILD SUCCESSFUL
Total time: 10 seconds
七、创建personList.jsp和Canoo测试
现在在 web/pages目录下应该有了一个personList.jsp文件. If not, you can create it using viewgen. From the command-line, navigate to extras/viewgen and run ant -Dform.name=Person. This will generate a PersonList.jsp in extras/viewgen/build.
打开web/pages目录下的personList.jsp文件进行编辑。
在文件顶部有一个<ww:set>标签用来展示 "people" 信息。你需要把这个引用的值从"persons" 改成 "people"。
<ww:set name="personList" value="people" scope="request"/>
用来创建JSP的模版针对id的属性列使用了硬编码，所以XDoclet加了两次。为了在personList.jsp移出它，在文件中删除下面的部分：
<display:column property="id" sort="true" headerClass="sortable"
titleKey="personForm.id"/>
如果有人知道办法修改extras/viewgen/src/List_jsp.xdt不再包括这个列的标签，请通知我。
为了前后一致，可以把自动产生的"persons" 改变成"people"。在大约30行的位置，你可以找到下面这一行：
<display:setProperty name="paging.banner.items_name" value="persons"/>
修改成：
<display:setProperty name="paging.banner.items_name" value="people"/>
最后在to web/WEB-INF/classes/ApplicationResources_en.properties文件中加入title和heading 键值 (personList.title和 personList.heading) ：
# -- person list page --
personList.title=Person List
personList.heading=All People
需要注意的是，personList.title将会出现在浏览器的标题栏中，而personList.heading将会显示在页面中作为标题：
在web/WEB-INF/classes/xwork.xml文件中加入一个新的"people" action：
<action name="people" class="personAction" method="list">
<result name="success">/WEB-INF/pages/personList.jsp</result>
</action>
这时可以运行ant clean deploy, 启动Tomcat察看这个显示列表的页面了http://localhost:8080/myApp/people.html。
现在有了一个列表显示页面，让我们改变在新增和删除了一个Person后显示这个页面。在web/WEB-INF/classes/xwork.xml文件中，改变 savePersons的 "input" 和 "success" 结果指向"people.html"。
同时需要改变 Canoo 测试中的 "AddPerson"和"DeletePerson"部分。打开test/web/web-tests.xml文件改变"AddPerson"目标中下面的行：
<verifytitle stepid="Main Menu appears if save successful"
text="${webapp.prefix}${mainMenu.title}"/>
改变成：
<verifytitle stepid="Person List appears if save successful"
text="${webapp.prefix}${personList.title}"/>
接下来改变"DeletePerson"目标中下面行的内容：
<verifytitle stepid="display Main Menu"
text="${webapp.prefix}$(mainMenu.title}"/>
改变成：
<verifytitle stepid="display Person List" text="${webapp.prefix}${personList.title}"/>
为了测试列表页面的工作，在test/web/web-tests.xml中创建一个新的JSP：
<!-- Verify the people list screen displays without errors -->
<target name="SearchPeople"
description="Tests search for and displaying all people">
<canoo name="searchPeople">
&config;
<steps>
&login;
<invoke stepid="click View People link" url="/people.html"/>
<verifytitle stepid="we should see the personList title"
text="${webapp.prefix}${personList.title}"/>
</steps>
</canoo>
</target>
你也许希望加入"SearchPeople"目标到 "PersonTests" 目标中去，以便能够和其他相关操作一起被测试。
<!-- runs person-related tests -->
<target name="PersonTests"
depends="SearchPeople,EditPerson,SavePerson,AddPerson,DeletePerson"
description="Call and executes all person test cases (targets)">
<echo>Successfully ran all Person JSP tests!</echo>
</target>
现在可以运行 ant test-canoo -Dtestcase=SearchPeople (或者运行 ant test-jsp 如果Tomcat没有运行)。如果结果是"BUILD SUCCESSFUL"就大功告成了!
八、在菜单上加入链接
最后一步把list, add, edit和delete功能显示给用户访问最简单的办法是在web/pages/mainMenu.jsp文件中加入新的链接：
<li>
<a href="<c:url value="/people.html"/>"><fmt:message key="menu.viewPeople"/></a>
</li>
menu.viewPeople是定义在web/WEB-INF/classes/ApplicationResources_en.properties中的一个实体.。
menu.viewPeople=View People
另一个办法是改变web/WEB-INF/menu-config.xml加入下面的内容：
<Menu name="PeopleMenu" title="menu.viewPeople" forward="viewPeople"/>
确定上面的XML在<Menus> tag内，但是没有另外一个<Menu>。然后在web/pages/menu.jsp中加入新菜单 —— 现在看起来是下面的样子：
<%@ include file="/common/taglibs.jsp"%>
<div id="menu">
<menu:useMenuDisplayer name="ListMenu" permissions="rolesAdapter">
<menu:displayMenu name="AdminMenu"/>
<menu:displayMenu name="UserMenu"/>
<menu:displayMenu name="PeopleMenu"/>
<menu:displayMenu name="FileUpload"/>
<menu:displayMenu name="FlushCache"/>
<menu:displayMenu name="Clickstream"/>
</menu:useMenuDisplayer>
</div>
现在运行ant clean deploy 启动Tomcat在浏览器中输入http://localhost:8080/myApp/mainMenu.html ，你可以看到下面的界面（图片略）。
现在已经完成了一个完整的master-detail的页面开发过程！现在可以运行所有的测试而看不到任何错误了！
