【IT168技术文档】 
    在用户界面设计中，复选框组不如它的同类 —— 多行选择框那样流行。它们基本上做的是同一件事，即选择映射到单一 name 属性的一组选项。当在组中使用时，复选框执行的功能实际与多行选择框一样，但是它们占据的屏幕空间更多。当希望用户在选择一个或多个选项之前能够看到所有选项的时候，这会很有好处。 

    虽然在选项不多的时候，多行选择框通常提供更好的观感，但是当选择框必须动态呈现而且包含预选功能时，对企业应用程序来说复选框组会是更好的选择。幸运的是，使用 Struts 框架可以很容易地创建动态复选框组。 

    在这篇文章中，我将介绍一个简单的诀窍：用 Struts 的 <html:multibox/> 和 <logic:iterate/> 标记在应用程序的视图层呈现大量条目，在本例中是 Java™ Server Page（JSP）。 

    我先从使用复选框元素显示简单的 String[] 数组开始，数组中包含喜玛拉雅山的顶峰高度。然后，我将创建另外一个 String[] 数组，包含 selectedMountains ，代表已经选中的复选框。复选框的预选情况会在两个数组的交叉中产生。如果 selectedMountains 的初始数组为空，那么所有复选框最初都会显示为未选中。 

    请参阅 下载 获得完整的示例源代码。应当拥有跟随本文所需要的每样东西。如果需要下载 Struts 框架，请参阅 参考资料。 
    创建动态复选框 

    创建动态复选框的诀窍包含三个主要部分： 

    一个表单 bean，容纳复选框的 String[] 数组和表示选中复选框的 String[] 数组。 

    一个 JSP，带有一个表单，在需要的时候显示复选框。 

    一个简单的 Action 类，从表单页面转到显示页面。 
    请注意 “Himalayas” 示例非常简单。用来填充复选框的字段应当来自更复杂的模型，比如这样的模型，它能够标识用户，并选择要显示的字段，然后把业务对象认为需要的选项预先选中。我采用简单的模型是为了更好地演示 Struts 的用户界面功能。代码示例使用 JSP 脚本语言是为了表示清楚。 


    第 1 步. 创建表单 bean 

    我先从创建 Struts 表单 bean 开始，它包含填充复选框所需要的信息。请注意清单 1 中的 TestForm.java 包含了两个示例 String[] 数组变量的 getter 和 setter。数组 mountains 代表示例复选框的 全部选项，数组 selectedMountains 代表预选的在浏览器中显示为选中的元素。 

    除了代表初始选中的复选框，selectedMountains 还代表处理表单时，由用户选中的复选框。（它只代表最终选中的元素。）当请求页面时，会显示复选框。当我在它们之间迭代时，与 selectedMountains 匹配的复选框元素就是选中的元素。 

    清单 1 显示了 TestForm.java 的完整代码：

package com.strutsrecipes;
import javax.servlet.http.HttpServletRequest;
import org.apache.struts.action.ActionError;
import org.apache.struts.action.ActionErrors;
import org.apache.struts.action.ActionForm;
import org.apache.struts.action.ActionMapping;
public final class CheckboxTestForm
extends ActionForm ...{
// Instance Variables
/**//*Mountains "pre-selected"...*/
private String[]
selectedMountains
=
...{"Everest","K2","Lhotse"};
/**//*the ten tallest Mountains to iterate through*/
private String[]
mountains
=
...{"Everest","K2","Kangchenjunga","Lhotse",
"Makalu","Kangchenjunga South",
"Lhotse Middle","Kangchenjunga West",
"Lhotse Shar","Cho Oyu"};
/**//*Getter for selectedMountains*/
public String[] getSelectedMountains() ...{
return this.selectedMountains;
}
/**//*Setter for selectedMountains*/
public void setSelectedMountains(String[] selectedMountains) ...{
this.selectedMountains = selectedMountains;
}
/**//*Getter for the mountains*/
public String[] getMountains() ...{
return this.mountains;
}
/**//*Setter for the mountains*/
public void setMountains(String[] mountains) ...{
this.mountains = mountains;
}
}

     第 2 步. 编写 JSP 代码 

    接下来，我要编写页面的 JSP 代码，把 TestForm.java 的信息传递给视图层。在编写这个代码时，关键是要把对应的 Struts 标记库导入 JSP。清单 2 的 JSP 代码表示的是一个简单的表单，显示复选框中相应的框已经选中：

<%@taglib uri="http://jakarta.apache.org/struts/tags-html" prefix="html"%>
<%@taglib uri="http://jakarta.apache.org/struts/tags-bean" prefix="bean"%>
<%@taglib uri="http://jakarta.apache.org/struts/tags-logic" prefix="logic"%>
<%-- html code, etc... -->
<html:form
action="/FormAction"
name="testForm"
type="com.strutsrecipes.CheckboxTestForm">
<h4><bean:message key="testForm.instruction"/></h4>
<logic:iterate name="testForm"
property="mountains"
id="mountain">
<%-- create the checkbox and selected attribute -->
<html:multibox property="selectedMountains">
<bean:write name="mountain"/>
</html:multibox>
<%-- create the label, note that "br" tag will format it vertically -->
<bean:write name="mountain"/><br/>
</logic:iterate>
<br/>
<html:submit/><html:reset/>
</html:form>
<%-- some more html code, etc... -->

    注意，我用 Struts <bean:message/> 标记表示文本，用 <html:multibox/> 表示 HTML 复选框，用 <logic:iterate/> 标记在数组中迭代并创建相应内容。我的表单在 JSP 中通过 <html:form/> 标记被实例化。 

    下一步是对 <logic:iterate/> 标记中的 mountains 字段进行迭代。在这么做的时候，我创建了一个变量（mountain），用它来填充复选框，并用 <bean:write/> 标记给它一个标签。要在复选框中创建 selected 属性，我要再次使用 <logic:iterate/> 和 <html:multibox/> 标记。<html:multibox/> 标记中的 property 属性由 selectedMountains 字段填充。当 selectedMountains 等于 mountain 时，selectBox 就是选中的。 

    第 3 步. 编写 Action 类 

    最后一步是编写 Action 类。清单 3 比起其他清单，做的事并不多。我做的只是得到 selectedMountains 的 String[] 数组，并使它可以用于页面：

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 javax.servlet.ServletException;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import javax.servlet.http.HttpSession;
/**//**
* A simple Action for Checkbox test.
*
* @author Danilo Gurovich
*/
public final class CheckboxTestAction
extends Action ...{
// -------------------------- OTHER METHODS --------------------------
/**//**
* The execute method
*
* @param mapping ActionMapping
* @param form CheckboxTestForm
* @param request HttpServletRequest
* @param response HttpServletRespons
* @return success to the confirmation page
* @throws ServletException not thrown, but could be!
* @throws Exception ditto.
*/
public ActionForward execute(ActionMapping mapping,
ActionForm form,
HttpServletRequest request,
HttpServletResponse response)
throws ServletException, Exception ...{
// Extract attributes needed
String[] selectedMountains =
((CheckboxTestForm) form).getSelectedMountains()
;
System.out.println("htmlString RETURNED*\n" +
selectedMountains.toString());
//Save the htmlString in the session for later...
HttpSession session = request.getSession();
session.setAttribute(CheckboxConstants.MOUNTAINS, selectedMountains);
return (mapping.findForward("success"));
}
}