介绍
在本教程中,我们将探索其他Struts 2表单控件。在前面的教程中,我们介绍了如何使用Struts 2表单(处理表单、表单验证和消息资源文件),我们介绍了如何使用Struts 2 head, form, textfield 控件和key属性。本教程将探索使用Struts 2 select, radio, checkbox, and checkboxlist form 控件
贴个本帖的地址,以免被爬:struts2官方 中文教程 系列九:Debugging Struts 即 http://www.cnblogs.com/linghaoxinpian/p/6916619.html
本章节将建立一个如下的页面
新建文件 edit.jsp、EditAction.java、src/model/State.java
并在/struts_basic/src/action/package.properties 添加如下内容:
后面中文被编码后的内容,Myeclipse的特性,具体是什么中文内容,参见上一张图(姓氏、名字、性别。。。)
修改struts.xml文件,添加edit的映射:
修改Person类,添加属性
1 package model; 2 3 public class Person { 4 private String firstName; 5 private String lastName; 6 private String email; 7 private int age; 8 private String sport; 9 private String residency; 10 private boolean over21; 11 private String carModel; 12 13 public String getFirstName() { 14 return firstName; 15 } 16 17 public void setFirstName(String firstName) { 18 this.firstName = firstName; 19 } 20 21 public String getLastName() { 22 return lastName; 23 } 24 25 public void setLastName(String lastName) { 26 this.lastName = lastName; 27 } 28 29 public String getEmail() { 30 return email; 31 } 32 33 public void setEmail(String email) { 34 this.email = email; 35 } 36 37 public int getAge() { 38 return age; 39 } 40 41 public void setAge(int age) { 42 this.age = age; 43 } 44 45 public String toString() { 46 return "First Name: " + getFirstName() + " Last Name: " + getLastName() + 47 " Email: " + getEmail() + " Age: " + getAge() ; 48 } 49 50 public String getSport(){ 51 return "football"; 52 } 53 54 public void setSport(String sport) { 55 this.sport = sport; 56 } 57 58 public String getResidency() { 59 return "zh"; 60 } 61 62 public void setResidency(String residency) { 63 this.residency = residency; 64 } 65 66 public boolean isOver21() { 67 return true; 68 } 69 70 public void setOver21(boolean over21) { 71 this.over21 = over21; 72 } 73 74 public String getCarModel() { 75 return "Ford"; 76 } 77 78 public void setCarModel(String carModel) { 79 this.carModel = carModel; 80 } 81 82 }
edit.jsp
1 <%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%> 2 <%@ taglib uri="/struts-tags" prefix="s" %> 3 <!DOCTYPE> 4 <html> 5 <head> 6 <title>edit.jsp</title> 7 </head> 8 <body> 9 <s:form action="edit"> 10 <s:textfield key="personBean.firstName"/> 11 <s:textfield key="personBean.lastName"/> 12 <s:textfield key="personBean.gender"/> 13 <s:select key="personBean.sport" list="sports"></s:select> 14 <s:radio key="personBean.gender" list="genders" /> 15 <s:select key="personBean.residency" list="states" listKey="stateAbbr" listValue="stateName"/> 16 <s:checkbox key="personBean.over21" /> 17 <s:checkboxlist key="personBean.carModel" list="carModelAvailable" /> 18 </s:form> 19 </body> 20 </html>
EditAction.jsp
1 package action; 2 3 import java.util.ArrayList; 4 import java.util.List; 5 6 import com.opensymphony.xwork2.ActionSupport; 7 8 import model.Person; 9 import model.State; 10 11 public class EditAction extends ActionSupport { 12 13 private Person personBean; 14 public String execute(){ 15 personBean=new Person(); 16 return SUCCESS; 17 } 18 //----------getter-setter start------------ 19 public Person getPersonBean() { 20 return personBean; 21 } 22 23 public void setPersonBean(Person personBean) { 24 this.personBean = personBean; 25 } 26 //----------getter-setter end------------ 27 28 //获取 "运动列表" 29 public List<String> getSports(){ 30 List<String> list=new ArrayList<String>(); 31 list.add("basketball"); 32 list.add("baseball"); 33 list.add("football"); 34 return list; 35 } 36 37 //获取 "性别类表" 38 public String[] getGenders(){ 39 return new String[]{"男","女","保密"}; 40 } 41 42 //获取 "居住地列表" 43 public List<State> getStates(){ 44 List<State> list=new ArrayList<State>(); 45 list.add(new State("zh","中国")); 46 list.add(new State("en", "English")); 47 48 return list; 49 } 50 51 //是否检查 "满21岁" 52 public boolean getOver21(){ 53 return true; 54 } 55 56 //获取"汽车模型列表" 57 public List<String> getCarModelAvailable(){ 58 List<String> list=new ArrayList<String>(); 59 list.add("Ford"); 60 list.add("Chrysler"); 61 return list; 62 } 63 }
Struts2 select 标签
<s:select key="personBean.sport" list="sports"></s:select>
我们使用了在第七章的教程中讨论的key属性。key属性由Struts 2框架用于生成其他属性的值(例如name和label)。我们还使用与EditAction类相关联的属性文件(这里我们使用的是包级别的属性文件package.properties)
注意,Struts 2表单标记有很多属性,其中大部分都反映了与标记相关的HTML属性。您可以通过查阅Struts 2的文档来了解Struts 2表单标记的所有属性。
list属性的值被框架用来确定要调用的操作类的方法,以便创建选项值。在我们的示例应用程序中,“sports”的list属性值在调用类EditAction的getSports方法得到结果。该方法返回一个包含“football”, “baseball”, and “basketball”的字符串数组。这些值用于在select标签中创建选项标签。
Struts 2框架决定通过使用key属性的值来调用personBean对象上的方法来预先选择哪个选项。因为key属性的值是“personBean.sport”。这个框架调用了personBean对象的getSport方法()。如果该方法返回的值匹配一个选项值(我们返回的是football),那么该选项将被标记为“选中”。
Struts2 Radio标签
<s:radio key="personBean.gender" list="genders" />
同样,key属性的值决定了name和label性的值。标签的文本来自于属性文件(package.properties)。就像Struts 2的select标签一样,Struts 2 Radio标签的list属性使框架调用了EditAction类的genders方法。返回的字符串对象数组用于创建单独的单选按钮。
Struts 2 select标签-对象支持
您可能需要创建一个Struts 2 select标签,其中显示给用户的值与实际的值是不同的(即key-value)。在示例应用程序中,用户的居住地存储为两个字母的缩写(如value=“zh”),在页面上应该显示完整的名称(中国),即如下效果:
<tr> <td class="tdLabel"> <label for="save_personBean_residency" class="label">State resident:</label> </td> <td> <select name="personBean.residency" id="save_personBean_residency"> <option value="zh">中国</option> <option value="en">English</option> </select> </td> </tr>
要在Struts 2中创建这样一个选择框,您可以使用以下代码:
<s:select key="personBean.residency" list="states" listKey="stateAbbr" listValue="stateName" />
list值告诉框架调用EditAction类的getStates方法。该方法返回State象的ArrayList。每个State对象都有getStateAbbr和getStateName方法。listKey属性告诉框架使用调用getStateAbbr方法返回的值作为HTML选项标签的value属性的值,以及通过调用getStateName方法返回给用户显示的值。
State类
package model; public class State { private String stateAbbr; //实际值 private String stateName; //显示值 public State(String stateAbbr,String stateName){ this.stateAbbr=stateAbbr; this.stateName=stateName; } public String getStateAbbr() { return stateAbbr; } public void setStateAbbr(String stateAbbr) { this.stateAbbr = stateAbbr; } public String getStateName() { return stateName; } public void setStateName(String stateName) { this.stateName = stateName; } }
通过调用personBean对象的getResidency 方法返回的值,确定选择标记的选项标记中哪些是被选中的。在我们的例子中,由于getresi等号返回“KS”,所以其value属性等于“zh”的选项标记被标记为被选中。
Struts 2 Checkbox 标签
<s:checkbox key="personBean.over21" />
Struts 2复选框标签用于创建HTML复选框标签。key属性的值告诉框架需要调用什么方法来确定复选框是否被选中。这个方法是isOver21(第66行)
当表单被提交并且复选框没有选中时,复选框将没有任何值(这是HTML表单的工作方式)。由于Struts 2框架需要更新personBean的over21实例字段的值,因为检查框没有值null,所以框架需要一种方法来确定在表单提交之后复选框是否被选中。如果您查看由Struts 2 checkbox标签创建的HTML代码,您将看到它创建了一个与 personBean.over21 相关联的隐藏字段。当Struts 2框架拦截该表单的提交时,它将使用这个隐藏的表单字段来检查相关的复选框字段是否存在于表单数据中。如果该复选框字段不存在,那么Struts 2框架将知道将personBean对象的over21实例变量的值更新为false。
struts2 Checkboxlist(复选框)标签
<s:checkboxlist key="personBean.carModels" list="carModelsAvailable" />
checkboxlist标签中的list属性值告诉Struts 2框架,要调用哪个方法来获得汽车模型列表。在这个示例应用程序中,框架将调用EditAction类的getCarModelsAvailable方法。该方法返回一个字符串数组。对于数组的每个元素,Struts 2框架创建一个复选框(包括上面所描述的相关隐藏字段)。checkboxlist标签中的key属性值告诉Struts 2框架调用personBean对象的getCarModels方法(与前面都一样),list属性值是调用EditAction类的getCarModelsAvailable方法(第57行),同理上面的标签无区别。
总结
还有其他一些Struts 2表单控件,您应该研究一下。如果您需要更多关于Struts 2表单标记的信息,请参考Struts 2的文档,http://stru.apache.org。