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

[RSS]


Hide Menu

ValidationAndList_zh


This is version 1. 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,第二种方案在&#36825;&#37324;&#25551;&#36848;

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

你现在有了这个form的验证配置,无论何时这个form在被调用时,如果action-mapping中的validate="true",这些规则就会被应用,在&#19978;&#19968;&#20010;&#25945;&#31243;里,我们为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错误警告。

validation-required.png

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

validation-required-nojs.png

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

  • 保存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 sessionthrows HibernateException {
            Example ex = Example.create(person).ignoreCase().enableLike(MatchMode.ANYWHERE);
            return session.createCriteria(Person.class).add(ex).list();
        }
    };
    return (ListgetHibernateTemplate().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 = (PersonManagergetBean("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修改方法savedeletecancelmapping.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,你一定会看到如下的抓图。

new-menu-item.png

注意在左边(来自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.