Struts 1.x中批量封装对象,多行数据处理两种方法

Struts 1.x中批量封装对象

在我早前的文章《转换器（Converter）——Struts 2.0中的魔术师》（以下简称为《转》）中，提及在Struts 1.x中实现批量封装对象，并不是一件容易的事，这需要一些技巧。昨天，有一位同事又和我讨论起这个问题，所以鉴于此场景（scenario）较为普遍，我决定写一篇有关的文章。

应用场景

本文使用《转》中的最后一个例子作为应用场景，即是批量发布产品信息。页面输出如下图所示：

图1 发布产品

图2 查看产品

具体实现

首先创建代表产品的类tipsAndTricks.Product，代码如下：

package tipsAndTricks;

import java.sql.Date;

public class Product {
    private String name;
    private double price;
    private Date dateOfProduction;
   
    public Date getDateOfProduction() {
        return dateOfProduction;
   }
   
    public void setDateOfProduction(Date dateOfProduction) {
        this .dateOfProduction = dateOfProduction;
   }
   
    public String getName() {
        return name;
   }
   
    public void setName(String name) {
        this .name = name;
   }
   
    public double getPrice() {
        return price;
   }
   
    public void setPrice( double price) {
        this .price = price;
   }    
}

与《转》例中的Product不同的是，本例子中的dateOfProduction属性使用了java.sql.Date，而不是java.util.Date。这是因为Struts 1.x不支持请求参数到java.util.Date的转换，归根到底是由于org.apache.commons.beanutils.ConvertUtilsBean.convert()不支持关于java.util.Date的转换。另外，值得注意的是common-beanutils是通过java.sql.Date.valueOf（）方法工作的，所以在页面输入的字符串的格式必须为“yyyy-MM-dd”。

实现上述功能大概有三种方法，下面我会分别对这三种方法进行详细的讲述。

方法一、动态表单（Dynamic Actoin Form）+ 数组

首先，让我们来看一下Struts的配置文件WEB-INF/struts-config.xml，内容如下：

<? xml version="1.0" encoding="UTF-8" ?>
<! DOCTYPE struts-config PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 1.2//EN" "http://struts.apache.org/dtds/struts-config_1_2.dtd" >

< struts-config >
    < data-sources />
    < form-beans >
        < form-bean name ="dynaProductsForm"
            type ="org.apache.struts.action.DynaActionForm" >
            < form-property name ="products"
                type ="tipsAndTricks.Product[]" size ="3" />
        </ form-bean >

    </ form-beans >

    < global-exceptions />
    < global-forwards />
    < action-mappings >
        < action attribute ="dynaProductsForm" input ="/addProducts.jsp"
            name ="dynaProductsForm" path ="/batchWrappingWithArray"
            scope ="request" type ="tipsAndTricks.BatchWrappingWithArrayAction"
            validate ="false" >
            < forward name ="success" path ="/viewProducts.jsp" />
        </ action >

    </ action-mappings >

    < message-resources parameter ="tipsAndTricks.ApplicationResources" />
</ struts-config >

我想这些配置应该用不着怎么解释了，有Struts 1.x验证的朋友对此都不会陌生。因此，接下来创建/addProducts.jsp文件，代码如下：

<% @ page language = " java " pageEncoding = " utf-8 " %>

<% @ taglib uri = " http://struts.apache.org/tags-html " prefix = " html " %>
<% @ taglib uri = " http://java.sun.com/jsp/jstl/core " prefix = " c " %>

<! DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" >
< html >
< head >
< title > Add Products </ title >
</ head >
< body >
< html:form action ="/batchWrappingWithArray" method ="post" >
    < table border ="0" >
        < tr style ="background-color:powderblue; font-weight:bold;" >
            < td > Product Name </ td >
            < td > Price </ td >
            < td > Date of production </ td >
        </ tr >
        < c:forEach var ="products" items ="${dynaProductsForm.map.products}" >
            < tr >
                < td >< html:text indexed ="true" name ="products" property ="name" /></ td >
                < td >< html:text indexed ="true" name ="products" property ="price" /></ td >
                < td >< html:text indexed ="true" name ="products" property ="dateOfProduction" /></ td >
            </ tr >
        </ c:forEach >
        < tr >
            < td colspan ="3" >< html:submit /></ td >
        </ tr >
    </ table >
</ html:form >
</ body >
</ html >

例中，我使用了JSTL 1.1，如果大家还没有尝试过使用JSP 2.0的JSTL和EL，建议大家去看看相关文章。上面的<c:forEach />的作用是到dynaProductsForm的map属性中取出products数组，并对其进行遍历，再依靠<html:text />标志将products的元素的属性以输入框的形式输出。<html:text />标志的属性indexed="true"则表示在输出HTML时，将<input>的命名为类似products[0].name的名字。

然后，再创建/viewProducts.jsp页面，内容如下：

<% @ page language = " java " pageEncoding = " utf-8 " %>

<% @ taglib uri = " http://java.sun.com/jsp/jstl/core " prefix = " c " %>

<! DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" >
< html >
< head >
< title > View Products </ title >
</ head >
< body >
< table border ="0" >
    < tr style ="background-color:powderblue; font-weight:bold;" >
        < td > Product Name </ td >
        < td > Price </ td >
        < td > Date of production </ td >
    </ tr >
    < c:forEach var ="product" items ="${products}" >
        < tr >
            < td > ${product.name} </ td >
            < td > ${product.price} </ td >
            < td > ${product.dateOfProduction} </ td >
        </ tr >
    </ c:forEach >
</ table >
</ body >
</ html >

我想这份也不多作说明。不过大家可以通过上述代码看出使用JSTL + EL的确比Struts 1.x的logic + bean要方便和简洁。不仅如此，EL还支持一定的运算符和函数操作。

最后是建立Action文件tipsAndTricks.BatchWrappingWithArrayAction，代码如下：

package tipsAndTricks;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.apache.struts.action.Action;
import org.apache.struts.action.ActionForm;
import org.apache.struts.action.ActionForward;
import org.apache.struts.action.ActionMapping;
import org.apache.struts.action.DynaActionForm;

public class BatchWrappingWithArrayAction extends Action {
    public ActionForward execute(ActionMapping mapping, ActionForm form,
                 HttpServletRequest request, HttpServletResponse response) {
           DynaActionForm dynaProductsForm = (DynaActionForm) form;
           request.setAttribute( " products " , dynaProductsForm.get( " products " ));
        return mapping.findForward( " success " );
   }
}

此Action将动态表单传过来的products数组放到request中，转到/viewProducts.jsp。发布运行应用程序，在浏览器的地址栏中输入：http://localhost:8080/Struts1_Batch/addProducts.jsp。效果请参考如图1、图2。

在/addProducts.jsp的“Date of production”必须以（yyyy-MM-dd）的形式正确填写，且不能为空。

方法二、表单（Actoin Form）+ 列表（List）

方法一虽然简单，但是有一个明显的缺点——数组的长度已经固定，故我们不能在运行时通过程序设置对象数量。下面将要介绍的方法可以很好地解决这个问题。

首先，我们要创建类tipsAndTricks.AutoInitArrayList，代码如下：

package tipsAndTricks;

import java.util.ArrayList;

public class AutoInitArrayList < T > extends ArrayList < T > {
    private static final long serialVersionUID = 1L ; 
   
    private Class < T > t = null ;
   
    public AutoInitArrayList(Class < T > t) {
        this .t = t;
   }
   
   @Override
    public T get( int index) {
        try {
            while (index >= size()) {
               add(t.newInstance());
           }
       } catch (Exception e) {
           e.printStackTrace();
       }
        return super .get(index);
   }    
}

AutoInitArrayList继承ArrayList并重载get()方法，作用就是在Struts 1.x框架调用这个方法时，如果index超出列表大小，则会实例化新项放到列表中，避免出现(IndexOutOfBoundsException)异常。

接着，让我们看Struts的配置，内容如下：

<? xml version="1.0" encoding="UTF-8" ?>
<! DOCTYPE struts-config PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 1.2//EN" "http://struts.apache.org/dtds/struts-config_1_2.dtd" >

< struts-config >
    < data-sources />
    < form-beans >
        < form-bean name ="dynaProductsForm"
            type ="org.apache.struts.action.DynaActionForm" >
            < form-property name ="products"
                type ="tipsAndTricks.Product[]" size ="3" />
        </ form-bean >
        < form-bean name ="normalProductsForm"
            type ="tipsAndTricks.NormalProductsForm" />

    </ form-beans >

    < global-exceptions />
    < global-forwards />
    < action-mappings >
        < action attribute ="dynaProductsForm" input ="/addProducts.jsp"
            name ="dynaProductsForm" path ="/batchWrappingWithArray"
            scope ="request" type ="tipsAndTricks.BatchWrappingWithArrayAction"
            validate ="false" >
            < forward name ="success" path ="/viewProducts.jsp" />
        </ action >
        < action attribute ="normalProductsForm" input ="/addProducts.jsp"
            name ="normalProductsForm" path ="/batchWrappingNormal" scope ="request"
            type ="tipsAndTricks.BatchWrappingNormalAction" validate ="false" >
            < forward name ="success" path ="/viewProducts.jsp" />
        </ action >

    </ action-mappings >

    < message-resources parameter ="tipsAndTricks.ApplicationResources" />
</ struts-config >

然后，创建表单类tipsAndTricks.NormalProductsForm，代码如下：

package tipsAndTricks;

import java.util.List;

import org.apache.struts.action.ActionForm;

public class NormalProductsForm extends ActionForm {
    private List products = new AutoInitArrayList < Product > (Product. class );

    public List getProducts() {
        return products;
   }

    public void setProducts(List products) {
        this .products = products;
   }    
}

接下来是Action类tipsAndTricks.BatchWrappingNormalAction，代码如下：

/**/ /*
* Generated by MyEclipse Struts
* Template path: templates/java/JavaClass.vtl
*/
package tipsAndTricks;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.apache.struts.action.Action;
import org.apache.struts.action.ActionForm;
import org.apache.struts.action.ActionForward;
import org.apache.struts.action.ActionMapping;

public class BatchWrappingNormalAction extends Action {
    public ActionForward execute(ActionMapping mapping, ActionForm form,
           HttpServletRequest request, HttpServletResponse response) {
       NormalProductsForm normalProductsForm = (NormalProductsForm) form;
       request.setAttribute( " products " , normalProductsForm.getProducts());
        return mapping.findForward( " success " );
   }
}

基本上与方法一的Action一样。下面，再看看新的输入文件/addProducts2.jsp，内容如下：

<% @ page language = " java " pageEncoding = " utf-8 " %>

<% @ taglib uri = " http://struts.apache.org/tags-html " prefix = " html " %>
<% @ taglib uri = " http://java.sun.com/jsp/jstl/core " prefix = " c " %>

<! DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" >
< html >
< head >
< title > Add Products </ title >
</ head >
< body >
< html:form action ="/batchWrappingNormal" method ="post" >
    < table border ="0" >
        < tr style ="background-color:powderblue; font-weight:bold;" >
            < td > Product Name </ td >
            < td > Price </ td >
            < td > Date of production </ td >
        </ tr >
        < c:forEach begin ="0" end ="2" var ="i" >
            < tr >
                < td >< input name ="products[${i}].name" /></ td >                
                < td >< input name ="products[${i}].price" /></ td >
                < td >< input name ="products[${i}].dateOfProduction" /></ td >
            </ tr >
        </ c:forEach >
        < tr >
            < td colspan ="3" >< html:submit /></ td >
        </ tr >
    </ table >
</ html:form >
</ body >
</ html >

/addProducts2.jsp主要作用组装<input>的元素名称，Struts 1.x对名称格式类似“xxx[9].xx”的请求，会进行封装。发布运行应用程序，在浏览器的地址栏中输入：http://localhost:8080/Struts1_Batch/addProducts2.jsp。效果请参考如图1、图2。

总结

两种方法各有优缺点，选择原则是如果不需要动态设置元素个数，则使用方法一，否则请使用方法二。