Sung in Blog

           一些技术文章 & 一些生活杂碎
在Succeeding with Struts的前面安装部分,我间接提到了DynaForms在运行期内可以动态的控制表格大小。换句话说,就是能够根据需要得到5行、或者10行、或者15行长的表格。可能有点不明智,我把这种策略的实际实现作为一种练习留给了读者自己。在接下来的几个月内,我收到了几十个读者的请求,他们请求给出详细的实现细节,所以这个月我将用两种不同的方法来实现动态调整的表格。
第一个方法就是我在前面的栏目中提到的那个方法,将尺寸参数留给DynaForm 的form-property 属性来实现。为了演示详细过程,我们来看看一个非常简单的应用:添加关于不同Star Wars 演员的注释。在这个应用中我们感兴趣的关键事实是:演员的数量在表格配置中动态设定,而不是在struts-config.xml文件中动态设定。
首先,我们先来看看struts-config.xml 文件:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts-config PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 1.1//EN" 
                               "http://jakarta.apache.org/struts/dtds/struts-config_1_1.dtd">
<struts-config>
    <form-beans>
        <form-bean name="dynamicArrayForm" type="org.apache.struts.validator.DynaValidatorForm">
            <form-property name="people" type="demo.Person[]"/>
        </form-bean>
    </form-beans>


<action-mappings>
    <action path="/setupForm" type="demo.SetupFormAction" name="dynamicArrayForm" scope="session"
 
     validate="false">
        <forward name="success" path="/displayForm.jsp"/>
    </action>
    
<action path="/processActorComments"
type="demo.ProcessFormAction"
        name="dynamicArrayForm" scope="session" 
validate="false">
        <forward name="success" path="/displayForm.jsp"/>
    </action>
</action-mappings>
</struts-config>


如你所见,这是一个相当简单的配置文件,只定义了一个表格和两个动作。第一个动作,/setupForm,用来在初始显示之前配置表格;另一个动作,/processActorComments 用来处理用户输入的注释。
在这个文件中有两个重要的事情需要注意,它们对于事态的发展很关键:
1. people 表格属性定义为demo.Person[] 类型(即demo.Person的一个排列),但不给出任何size 参数。这就为要创建的排列产生了一个占位符,但是没有任何例示的实排列。
2. 这两个动作将表格定义在会话期范围内。这是很关键的,因为用户在填写数值之后提交表格时,数值在动作执行之前已经填充到表格内了。这就意味着没有机会手动创建具有恰当空位数的排列,正如你在表格显示之前在SetupFormAction 类中看到的情况一样。换句话说,当表格提交时,必须已经有恰当的空位来接受表格值,唯一能保证这个的方法就是在会话期范围内就已经有了这个表格。
基本上在Person bean 中是没有值的,他只是一个具有lastName、 firstName、 dateOfBirth、gender 和comment字段的普通bean。源文件包括在WAR 文件内。
现在我们来看看SetupFormAction 类,它在表格第一次显示之前调用。


package demo;

/**
 *  Copyright 2004, James M. Turner.
 * All Rights Reserved
 *
 * A Struts action that sets up a DynaForm which is globally scoped
 */

import java.io.IOException;
import javax.servlet.ServletException;
import javax.servlet.http.*;

import org.apache.struts.action.*;
import org.apache.struts.validator.DynaValidatorForm;

public class SetupFormAction extends Action {
    public ActionForward execute(ActionMapping mapping, ActionForm form, HttpServletRequest request,
                                 HttpServletResponse response)
            throws ServletException, IOException {

        DynaValidatorForm df = (DynaValidatorForm) form;
        Person[] p = new Person[3];
        p[0] = new Person();
        p[0].setDateOfBirth("07/13/1942");
        p[0].setLastName("Ford");
        p[0].setFirstName("Harrison");
        p[0].setGender("M");
        p[1] = new Person();
        p[1].setDateOfBirth("10/21/1956");
        p[1].setLastName("Fisher");
        p[1].setFirstName("Carrie");
        p[1].setGender("F");
        p[2] = new Person();
        p[2].setDateOfBirth("09/25/1951");
        p[2].setLastName("Hamill");
        p[2].setFirstName("Mark");
        p[2].setGender("M");

        df.set("people", p);

        return mapping.findForward("success");
    }
}


这一次也没有许多东西要看的。execute 方法要做的第一件事情,和任何基于DynaForm的动作所做的一样,就是将泛型ActionForm 类放到DynaValidatorForm内。这就使得我们可以在表格上使用get和set 方法。第二件事情就是,创建一个具有三个元素的类型Person 的排列。在这个方法中,尺寸是硬布线的,在实际应用中可以从数据库中选择一个尺寸。我们需要考虑的重要事情是排列应该在代码中创建,而不是由Struts引擎自己创建。这样行数可根据应用要求由代码随意指定。
一旦排列已经确定,方法将创建三个Person 类实例并赋与数值。同样,在实际的应用中可通过一个循环来实现,这个循环不断地从数据库中读取行和填充表格行。最后,动作返回成功,导致Struts转移控制到displayForm.jsp 页。

<!--
    Copyright 2004, James M Turner.
    All Rights Reserved
    
    -->

<%@ taglib uri="/WEB-INF/struts-html.tld" prefix="html" %>
<%@ taglib uri="/WEB-INF/c.tld" prefix="c" %>

<head>
<title>Star Wars Actor Fact Page</title>
</head>
<H1><center>Start Wars Actor Fact Page</title>
<html:form action="/processActorComments" >
    <table border="1" width="80%">
        <tr><th>Last Name</th><th>First Name</th><th>Date of Birth</th><th>Comment</th></tr>
        <c:forEach var="people" items="${dynamicArrayForm.map.people}">
            <tr><td><c:out value="${people.lastName}"/></td>
                <td><c:out value="${people.firstName}"/></td>
                <td><c:out value="${people.dateOfBirth}"/></td>
                <td><html:text name="people" indexed="true" property="comment"/></td>
            </tr>
        </c:forEach>
    </table>
    <P/>
    <html:submit value="Update Comments"/> 
</html:form>


同样,这里也没有很多东西要看的,他与我们上一篇文章查看固定长度的行时的代码完全一样。该页迭代行(记住在JSTL中我们必须使用map 属性来获得到DynaForm 属性的访问),显示演员的姓、名和出生日期,并提供文本域以便输入注释。
当我们聚焦我们的浏览器合请求时,http://localhost:8080/struts/setupForm.do (假设你把struts.war 文件放在你本地机器的Tomcat 内),将会出现下列页面:

Start Wars Actor Fact Page
Last Name First Name Date of Birth Comment
Ford Harrison 07/13/1942
Fisher Carrie 10/21/1956
Hamill Mark 09/25/1951


一旦表格提供,另一个简单的Struts动作来处理结果:











package demo;

/**
 *  Copyright 2004, James M. Turner.
 * All Rights Reserved
 *
 * A Struts action that sends the new comments to the console
 */

import java.io.IOException;
import javax.servlet.ServletException;
import javax.servlet.http.*;

import org.apache.struts.action.*;
import org.apache.struts.validator.DynaValidatorForm;

public class ProcessFormAction extends Action {
    public ActionForward execute(ActionMapping mapping, 
ActionForm form, 
HttpServletRequest request,
                                 HttpServletResponse response)
            throws ServletException, IOException {

        DynaValidatorForm df = (DynaValidatorForm) form;
        Person[] p = (Person[]) df.get("people");

        for (int i = 0; i < p.length; i++) {
            System.out.println(p[i].getFirstName() + " " + p[i].
getLastName() + ":" + p[i].getComment());
        }

        return mapping.findForward("success");
    }
}


在实际的应用中,这就是数据写回到数据库的地方。在这种情况下,他只将数据倒在控制台上所以我们可以看到他是正确收到的。假设我们为每个演员都填充了恰当的值,我们在控制台上会看到下列内容:

Harrison Ford:Indiana Jones
Carrie Fisher:Postcards from the Edge
Mark Hamill:Wing Commander


正如我在文章开头提到的一样,还有另一个方法可以解决这个问题,而且它不需要使用会话期范围内的表格。这个方法就是使用HashMaps 来存储行。我们来看看使用HashMaps编写的同一段代码:
首先,我们添加一个新表格到struts-config.xml:

<form-bean name="dynamicHashmapForm" type="org.apache.struts.validator.DynaValidatorForm">
            <form-property name="people" type="java.util.HashMap"/>
            <form-property name="comments" type="java.util.HashMap"/>
        </form-bean>


现在,我们不使用beans的排列,改为使用HashMap 来存储每个人的数据。另外,我们需要一个新的HashMap 来存储注释,原因我稍后再解释。我们也需要一个新的动作来填充数据:

package demo;

/**
 *  Copyright 2004, James M. Turner.
 * All Rights Reserved
 *
 * A Struts action that sets up a DynaForm which is globally scoped
 */

import java.io.IOException;
import java.util.HashMap;
import javax.servlet.ServletException;
import javax.servlet.http.*;

import org.apache.struts.action.*;
import org.apache.struts.validator.DynaValidatorForm;

public class SetupHashFormAction extends Action {
    public ActionForward execute(ActionMapping mapping, 
ActionForm form, HttpServletRequest request,
                                 HttpServletResponse response)
            throws ServletException, IOException {

        DynaValidatorForm df = (DynaValidatorForm) form;
        HashMap hm = (HashMap) df.get("people");
        Person p = new Person();
        p = new Person();
        p.setDateOfBirth("07/13/1942");
        p.setLastName("Ford");
        p.setFirstName("Harrison");
        p.setGender("M");
        hm.put("1", p);
        p = new Person();
        p.setDateOfBirth("10/21/1956");
        p.setLastName("Fisher");
        p.setFirstName("Carrie");
        p.setGender("F");
        hm.put("2", p);
        p = new Person();
        p.setDateOfBirth("09/25/1951");
        p.setLastName("Hamill");
        p.setFirstName("Mark");
        p.setGender("M");
        hm.put("3", p);
        return mapping.findForward("success");
    }
}


基本上,这段代码与前面的代码相同,除了我们将Person 对象存储到HashMap 中,而不是排列中之外。我们也不需要创建HashMap,因为它可以作为表格初始化的一部分来动态实现。
在JSP本身中相应的技巧部分为:

<!--
    Copyright 2004, James M Turner.
    All Rights Reserved
    
    -->

<%@ taglib uri="/WEB-INF/struts-html.tld" prefix="html" %>
<%@ taglib uri="/WEB-INF/struts-html-el.tld" prefix="html-el" %>
<%@ taglib uri="/WEB-INF/struts-tiles.tld" prefix="tiles" %>
<%@ taglib uri="/WEB-INF/c.tld" prefix="c" %>
<%@ taglib prefix="fmt" uri="/WEB-INF/fmt.tld" %>

<head>
<title>Star Wars Actor Fact Page</title>
</head>
<H1><center>Start Wars Actor Fact Page</title>
<html:form action="/processHashActorComments" >
    <table border="1" width="80%">
        <tr><th>Last Name</th><th>First Name</th>
<th>Date of Birth</th><th>Comment</th></tr>
        <c:forEach var="people" items="${dynamicHashmapForm.map.people}">
            <tr><td><c:out value="${people.value.lastName}"/></td>
                <td><c:out value="${people.value.firstName}"/></td>
                <td><c:out value="${people.value.dateOfBirth}"/></td>
                <td><html-el:text property="comments(${people.value.lastName},
${people.value.firstName})" /></td>
            </tr>
        </c:forEach>
    </table>
    <P/>
    <html:submit value="Update Comments"/> 
</html:form>


记住:在初始化时填充的HashMap 值,只要表格显示就会消失,因为表格是请求范围的,而不是会话期范围的。特别是对于我们来说这就意味着所有的Person 对象都会消失。所以,如果我们粘贴文本域到Person bean 的注释属性上,在提交表格时我们将得到一个空的指针异常,因为Person 对象不再位于HashMap 内(实际上,我们得到的是一个全新的空的HashMap.)。所以,我们需要将注释存储在一个单独的并行HashMap 内,它将注释当作简单的字符串来存储。
在上述的代码中还须注意几件事情。首先,因为现在正迭代HashMap条,来自c:forEach 标记的值实际上是用于堆栈条的占位符,同时具有两个属性。key 属性的值用来访问堆栈(在我们的例子中如字符"1", "2", "3"等等),value 属性的值存储在关键字之下。所以,在这种情况下,我们必须使用value 属性来得到Person bean 的实属性。
而且,我们需要构造一个用于文本框的有效的Struts属性域。在html-el 标记库中使用JSTL 扩展就可以实现。在这种情况下,我们通过一个由演员的最后一个名字、逗号和第一个名字组成的字符串来存储注释。
最后,我们需要一个新的动作来处理结果:

package demo;

/**
 *  Copyright 2004, James M. Turner.
 * All Rights Reserved
 *
 * A Struts action that sends the new comments to the console
 */

import java.io.IOException;
import java.util.HashMap;
import java.util.Iterator;
import javax.servlet.ServletException;
import javax.servlet.http.*;

import org.apache.struts.action.*;
import org.apache.struts.validator.DynaValidatorForm;

public class ProcessHashFormAction extends Action {
    public ActionForward execute(ActionMapping mapping, 
ActionForm form, HttpServletRequest request,
                                 HttpServletResponse response)
            throws ServletException, IOException {

        DynaValidatorForm df = (DynaValidatorForm) form;
        HashMap hm = (HashMap) df.get("comments");

        Iterator it = hm.keySet().iterator();
        while (it.hasNext()) {
            String key = (String) it.next();
            String comment = (String) hm.get(key);
            System.out.println(key + ":" + comment);
        }

        return mapping.findForward("success");
    }
}



同样,这里最大的差别是数据都是作为HashMaps 来存储的。代码获取关键字(lastname,firstname),然后显示关键字和在控制台注释:

Fisher,Carrie:Leia
Ford,Harrison:Han
Hamill,Mark:Luke

请注意,当控制返回到JSP页时,打印一个空白表格。这是因为我们在初始化操作中创建的HashMap 已经没有了,在处理结果时我们不能重新创建它。你可以将该数据保存在会话期变量中,但是接着你要返回到你使用第一个方案的地方。最好是选择一个关键字,在表格提交时它可以允许你在后台对象上获得,并且能够总是重新创建需要的任何其他的表格数据。
哪种方式更好?基于排列的方案允许你将所有的数据都保存在一个bean 内,而基于堆栈的方法避免了任何会话期范围的数据。你觉得哪种方案最好就采用哪种。
注意:包含运行这些例子所需的所有代码和库的WAR 文件在http://www.blackbear.com/struts.war.上可以找到。

posted on 2005-10-24 22:10 Sung 阅读(206) 评论(0)  编辑  收藏 所属分类: Struts

只有注册用户登录后才能发表评论。


网站导航: