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> 现在有了一个列表显示页面，让我们改变在新增和删除了一个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}”/>
<!– 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的页面开发过程！现在可以运行所有的测试而看不到任何错误了！
}
最新评论