Struts 的动态复选框实例（1）

look_w

在用户界面设计中，复选框组不如它的同类 —— 多行选择框那样流行。它们基本上做的是同一件事，即选择映射到单一 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 的完整代码：
清单 1. TestForm.java

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48

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 代码表示的是一个简单的表单，显示复选框中相应的框已经选中：
清单 2. 带有表单的 JSP

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33

<%@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 就是选中的。