Raible's Wiki: ValidationAndList

Raible's Wiki

Raible Designs
Wiki Home
News
Recent Changes

AppFuse

Homepage
  - Korean
  - Chinese
  - Italian
  - Japanese

QuickStart Guide
  - Chinese
  - French
  - German
  - Italian
  - Korean
  - Portuguese
  - Spanish
  - Japanese

User Guide
- Korean
- Chinese

Tutorials
  - Chinese
  - German
  - Italian
  - Korean
  - Portuguese
  - Spanish

FAQ
- Korean

Latest Downloads

Other Applications

Struts Resume
Security Example
Struts Menu

Set your name in UserPreferences

Referenced by
Articles
Articles_cn
Articles_pt
Articles_zh
CreateActions_zh

JSPWiki v2.2.33

Hide Menu

ValidationAndList_zh	Search Wiki:
Your trail:

This is version 2. It is not the current version, and thus it cannot be edited.
[Back to current version] [Restore this version]

Part IV: 添加验证和列表页面 - 给personForm的firstName和lastName字段添加必添的验证逻辑和显示person所有记录的页面。

: 本教程依赖于Part III: 创建Actions和JSPs.

关于本教程

本教程将向你展示如何用Struts的Validator为PersonForm添加验证逻辑（客户端和服务器端），我们也要使用Display Tag Library

创建一个列表页来显示数据库中所有的人。

: 我在真实世界中实际操作的方式用蓝色斜体表示。

[1] Person.java添加XDoclet的验证标签
[2] 察看和测试添加了验证的JSP
[3] DAO和Manager的测试添加testGetPeople方法
[4] PersonDao和Manager添加getPeople方法
[5] Action添加testSearch方法
[6] Action添加search方法
[7] 创建personList.jsp和Canoo测试
[8] 菜单添加链接

Person.java添加XDoclet的验证标签[#1]

为了使用Struts的Validator,通常情况下你需要手工写validation.xml,如果你不使用AppFuse,你还需要配置Validator插件和在ApplicationResources_en.properties写错误关键字,可以到Validation Made Easy Tutorial

(Struts本身也有一套rich set of tutorials

)察看更多的信息。

由于XDoclet，事情简单多了 - 只需要给Person类添加一些@struts.validator标签，打开文件(src/dao/**/model/Person.java)修改getFirstName()和getLastName()方法使之包括@struts.validator type="required"标签。




    /**

     * @struts.validator type="required"

     * @hibernate.property column="first_name" length="50"

     */

    public String getFirstName() {

        return this.firstName;

    }



    /**

     * @struts.validator type="required" 

     * @hibernate.property column="last_name" length="50"

     */

    public String getLastName() {

        return this.lastName;

    }

你也可以修改msgkey属性来覆盖这个错误的默认属性。




@struts.validator type="required" msgkey="errors.required"

type="required"的属性的默认关键字是errors.required，所以我通常会保留默认值。这个默认值定义在web/WEB-INF/classes/ApplicationResources_*.properties，你一定会注意到我们把标签放到getters方法前，而不是XDoclet 文档里说的放到setters前，这是因为我们生成PersonForm.java的模版文件(metadata/template/struts_form.xdt)会把标签加到生成的文件里。

如果你现在保存Person.java并且运行ant clean webdoclet，就会在build/appfuse/WEB-INF/生成一个validation.xml文件，它的内容一定保存了一条关于"personForm"的条目。




      <form name="personForm">

              <field property="firstName"

                     depends="required">



                  <arg0 key="personForm.firstName"/>

              </field>

              <field property="lastName"

                     depends="required">



                  <arg0 key="personForm.lastName"/>

              </field>

      </form>

为了给personForm.jsp开启客户端的验证，一个javascript的JSP标签和一段脚本需要添加到personForm.jsp的底端，它们一定已经存在了（幸亏了appgen）- 你只需要去掉注释符号。我们去掉注释是因为，如果我们指定了formName而没有对应的验证规则存在，就会有exception抛出。

: 从个人角度讲，我认为这是一个bug，但是Struts开发者不这么认为。

<html:javascript formName="personForm" cdata="false"
    dynamicJavascript="true" staticJavascript="false"/>
<script type="text/javascript" 
    src="<html:rewrite page="/scripts/validator.jsp"/>"></script>

注意: 如果你绑定验证规则到对象，它将会被收集起来添加到validation.xml，这是因为当一个Form建立的时候，一个@struts.validator会添加到关联对象的Setter上（通过metadata/templates/struts_form.xdt）。如果你使用多对多的双向关联，这会引起一个问题，有两个解决方案，第一个是在struts_form.xdt中去掉@struts.validator标签，并且手动的修改POJO的setter，第二种方案在这里描述

。

察看和测试添加了验证的JSP[#2]

你现在有了这个form的验证配置，无论何时这个form在被调用时，如果action-mapping中的validate="true"，这些规则就会被应用，在上一个教程里，我们为PersonAction添加了"savePerson"的action-mapping，对应的XDoclet标签如下：




 * @struts.action name="personForm" path="/savePerson" scope="request"

 *  validate="true" parameter="method" input="edit"

所以现在只要你的web/pages/personForm.jsp包括了<html:form action="savePerson">，当你保存这个form时就会调用验证，运行ant db-load deploy，启动Tomcat，浏览到http://localhost:8080/appfuse/editPerson.html?id=1。

如果你清除firstName和lastName的值，你就会得到如下的JavaScript错误警告。

为了保证事情确实按照所想的工作，你可以关闭JavaScript来确定服务器端的验证正在工作，这对Mozilla Firebird（我最喜欢的浏览器）来说非常简单，只需要到Tools → Options → Web Features去掉"Enable JavaScript"，现在如果你清除字段的值并且保存form，你会看到如下信息：

如果你没有见到这些验证错误，有以下几个可能：

保存form返回成功信息，但是firstName和lastName字段是空白的。

: 这是因为web/pages/personForm.jsp的<html:form>有action="editPerson" - 确定存在action="savePerson"。

点击保存，显示一个空白页。

: 空白页标明你的"savePerson" forward的"input"属性配置不正确，确定它是和一个local或者global的action-forward关联，在这个例子里，它一定是input="edit"，指向到.personDetail的tiles定义，根据我的经验，input的值应该是一个forward，而不应该是到一个action的路径。

如果你只希望服务器端的验证（没有JavaScript），你可以删除<html:form>(在web/pages/personForm.jsp)的onsubmit属性，还有就是此页底端的JavaScript验证标签。




<html:javascript formName="personForm" cdata="false"

      dynamicJavascript="true" staticJavascript="false"/>

<script type="text/javascript" 

      src="<html:rewrite page="/scripts/validator.jsp"/>"></script>

DAO和Manager的测试添加testGetPeople方法[#3]

为了创建一个List页面(也被称作master screen)，我们需要创建返回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对象是为了以后用来过滤（根据person对象中的值），在你的getPeople()方法添加参数是可选的，但余下的教程假定你是这样做的。

打开test/service/**/service/PersonManagerTest.java添加testGetPeople方法：




    public void testGetPeople() throws Exception {

        List results = new ArrayList();

        person = new Person();

        results.add(person);



        // set expected behavior on dao

        personDao.expects(once()).method("getPeople")

            .will(returnValue(results));



        List people = personManager.getPeople(null);

        assertTrue(people.size() == 1);

        personDao.verify();

    }

为了编译通过，你必须给PersonDao和PersonManager添加getPeople()方法和方法的实现。

PersonDao和Manager添加getPeople方法[#4]

打开src/dao/**/dao/PersonDao.java添加getPeople()方法的签名：




    public List getPeople(Person person);

添加同样的方法签名到src/service/**/service/PersonManager.java，保存所有的文件并且调整测试的imports，然后需要在实现类里实现getPeople()方法，打开src/dao/**/dao/hibernate/PersonDaoHibernate.java添加如下代码：




    public List getPeople(Person person) {

        return getHibernateTemplate().find("from Person");

    }

你会注意到我们对参数person未作任何操作，这里它只是一个占位符 - 将来你会通过它的属性用Hibernate's Query Language

(HQL)或者Criteria Queries

来过滤查询。

一个Criteria Query的例子:




    // filter on properties set in the person object

    HibernateCallback callback = new HibernateCallback() {

        public Object doInHibernate(Session session) throws HibernateException {

            Example ex = Example.create(person).ignoreCase().enableLike(MatchMode.ANYWHERE);

            return session.createCriteria(Person.class).add(ex).list();

        }

    };

    return (List) getHibernateTemplate().execute(callback);

现在实现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

如果所有的事工作正常- nice job!，现在需要在web层添加retrieve all功能。

Action添加testSearch方法[#5]

打开test/web/**/action/PersonActionTest.java并且添加如下代码：




    public void testSearch() {

        setRequestPathInfo("/editPerson");

        addRequestParameter("method", "Search");

        actionPerform();



        verifyForward("list");



        assertNotNull(getRequest().getAttribute(Constants.PERSON_LIST));

        verifyNoActionErrors();

    }

这个类在对src/dao/**/Constants.java添加PERSON_LIST变量PERSON_LIST之前不可以编译。

: 我通常会拷贝一个已经存在的类似变量 - 如USER_LIST。




    /**

     * The request scope attribute that holds the person list

     */

    public static final String PERSON_LIST = "personList";

现在保存所有的修改，你还不可以运行ant test-web -Dtestcase=PersonAction，因为PersonAction.search()还不存在。

Action添加search方法[#6]

打开src/web/**/action/PersonAction.java然后在我们列表页面的顶端添加如下XDoclet标签。




 * @struts.action-forward name="list" path="/WEB-INF/pages/personList.jsp"

现在给PersonAction类添加查询方法。

: 我通常会用UserAction.search()作为此方法的模版。




    public ActionForward search(ActionMapping mapping, ActionForm form,

                                HttpServletRequest request,

                                HttpServletResponse response)

            throws Exception {

        if (log.isDebugEnabled()) {

            log.debug("Entering 'search' method");

        }



        PersonManager mgr = (PersonManager) getBean("personManager");

        List people = mgr.getPeople(null);

        request.setAttribute(Constants.PERSON_LIST, people);



        // return a forward to the person list definition

        return mapping.findForward("list");

    }

运行ant test-web -Dtestcase=PersonAction.

Nice! BUILD SUCCESSFUL
Total time: 1 minute 26 seconds

创建personList.jsp和Canoo测试[#7]

打开web/pages中的personList.jsp文件，文件的顶端是一个<bean:struts>标签，把编辑界面的forward暴露为page-scoped的一个变量，这个的值现在一定是"editPerson"。




<%-- For linking to edit screen --%>

<bean:struts id="editURL" forward="editPerson"/>

添加这些到metadata/web/global-forwards.xml，类似于list中的那些代码，如此，它们就会被包含在struts-config.xml文件中。




        <forward name="editPerson" path="/editPerson.html"/>

        <forward name="viewPeople" path="/editPerson.html?method=Search"/>

另一件你希望修改的事是改变列表中的项目为复数形式，例子里生成的名字是"persons"，它应该为people，在31行或者附近，你会看到如下的代码：

<display:setProperty name="paging.banner.items_name" value="persons"/>

修改为:

<display:setProperty name="paging.banner.items_name" value="people"/>

最后，web/WEB-INF/classes/ApplicationResources_en.properties里添加标题和题目关键字(personList.title和personList.heading)，打开文件添加如下内容：

# -- person list page --
personList.title=Person List
personList.heading=All People

提醒一下，personList.title将会出现在浏览器的标题栏(<title>标签)，而personList.heading会作为<h1>标签在页面正文内容前面。

此刻，你一定可以运行ant clean deploy，启动Tomcat，在浏览器里查看http://localhost:8080/appfuse/editPerson.html?method=Search。

现在你有了个列表页面，让我们修改添加和删除一个Person后转向的页面，在src/web/**/action/PersonAction.java修改方法save、 delete和cancel的mapping.findForward("mainMenu")为如下内容:




    return mapping.findForward("viewPeople");

你也需要修改test/web/**/action/PersonActionTest.java中testRemove方法的verifyForward("mainMenu")为verifyForward("viewPeople")，最后，需要修改Canoo测试的"AddPerson"和"DeletePerson"，打开test/web/web-tests.xml并且修改"AddPerson"目标为如下代码：

<verifytitle description="Main Menu appears if save successful" 
    text=".*${mainMenu.title}.*" regex="true"/>

改为:

<verifytitle description="Person List appears if save successful" 
    text=".*${personList.title}.*" regex="true"/>

然后对于"DeletePerson"，修改如下:

<verifytitle description="display Main Menu" 
    text=".*$(mainMenu.title}.*" regex="true"/>

改为:

<verifytitle description="display Person List" text=".*${personList.title}.*" regex="true"/>

我们使用"viewPeople"而不是"list"，是因为查询方法是要被执行的，而不是简单的转向到personForm.jsp。

为了测试这个页面已经工作了，在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">

        <webtest name="searchPeople">

            &config;

            <steps>

                &login;



                <invoke description="click View People link" url="/editPerson.html?method=Search"/>

                <verifytitle description="we should see the personList title" 

                    text=".*${personList.title}.*" regex="true"/>

            </steps>

        </webtest>

    </target>

你将会希望添加"PersonTests"目标添加"SearchPeople"目标，这样这个测试就会和所有person相关的测试一起执行。




    <!-- 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 (如果Tomcat没有运行，可以运行ant test-jsp)，很有希望的结果是"BUILD SUCCESSFUL"，如果如此 - 干得好!

菜单添加链接[#8]

最后一步是创建列表的add、edit和delete功能，最简单的方式是给web/pages/mainMenu.jsp添加一个新的链接： 注意: mainMenu.jsp中的其他链接没有使用，因此这个JSP可以在AppFuse中的多个框架之间共享(如Spring MVC和WebWork)。




    <li>

        <html:link forward="viewPeople">

            <fmt:message key="menu.viewPeople"/>

        </html:link>

    </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>标签中，而不存在于另外一个<Menu>中，然后给web/common/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/appfuse/mainMenu.html，你一定会看到如下的抓图。

注意在左边(来自mainMenu.jsp)和右边(来自menu.jsp)有了一个新的链接

就这样了!

你已经完成了使用AppFuse和Struts开发一组主控页面的整个生命周期 - 恭喜！现在是真正的测试你的应用没有错误的时候了，为了测试，停止tomcat然后运行ant clean test-all，这会运行项目里所有的测试，作为提醒，我们应该很容易的在琐碎代码中通过运行ant setup-db setup-tomcat test-all的设置和测试AppFuse，同样，如果你期望找到更稳定的例子 - 取出Struts Resume。

Happy Day!

BUILD SUCCESSFUL
Total time: 2 minutes 31 seconds

Go to top More info... Attach file...

This particular version was published on 06-Nov-2006 13:52:48 MST by rocksun.