Struts2讲义31
7.1.2 List 集合类型数据类型转换功能
技术要点
本节代码具体介绍包含多个 Java 对象的 List 集合类型如何进行类型转换。
List 集合类型类型转换 Action 中使用方式。
List 集合类型类型转换在视图界面的使用方式。
演示代码
使用的 Action 文件:
<!----------------文件名:AddMaterialAction.java------------------>
public class AddMaterialAction extends ActionSupport {
private List<Material> materialList;
public String execute() throws Exception {
return SUCCESS;
}
public List<Material> getMaterialList() {
return materialList;
}
public void setMaterialList(List<Material> materialList) {
this.materialList = materialList;
}
}
配置文件中的导航定义:
<!-----------------文件名:struts.xml----------------->
<!-- Action所在包定义 -->
<package name="C07.1.2" extends="struts-default" >
<action name="addMaterial"
class="com.action.AddMaterialAction">
<result name="input">/jsp/addMaterial.jsp</result>
<result name="success">/jsp/showMaterial.jsp</result>
</action>
</package>
指定 List 类型中元素是具体何种对象属性文件
<!----------文件名:AddMaterialAction-conversion.properties--------------->
#集合属性-List类型
Element_materialList=com.model.Material
类型转换的数据输入 JSP 文件:
<!-------------------文件名:addMaterial.jsp-------------------->
…………
<!-- 材料输入表单 -->
<table>
<s:form id="materialForm" action="addMaterial" theme="simple">
<table>
<tr>
<td>材料名</td>
<td>价格</td>
<td>库存量</td>
<td>过期日期</td>
</tr>
<s:iterator value="new int[4]" status="m">
<tr>
<td><s:textfield name="%{'materialList['+#m.index+'].material'}" /></td>
<td><s:textfield name="%{'materialList['+#m.index+'].bid'}" /></td>
<td><s:textfield name="%{'materialList['+#m.index+'].mount'}" /></td>
<td><s:datetimepicker name="%{'materialList['+#m.index+'].expireDate'}" /></td>
</tr>
</s:iterator>
<tr>
<td colspan="4"><s:submit value="提交"></s:submit>
</tr>
</table>
</s:form>
</table>
…………
类型转换的显示数据 JSP 文件:
<!--------------------文件名:showMaterial.jsp---------------->
…………
<!-- 材料数据显示 -->
<table>
<tr>
<td>材料名</td>
<td>价格</td>
<td>库存量</td>
<td>过期日期</td>
</tr>
<s:iterator value="materialList" status="m">
<tr>
<td><s:property value="material" ></s:property></td>
<td><s:property value="bid" ></s:property></td>
<td><s:property value="mount" ></s:property></td>
<td><s:property value="expireDate" ></s:property></td>
</tr>
</s:iterator>
</table>
…………
数据输入如图 7.3 。
图 7.3 多个 material 对象数据输入(组合成 List 集合类型)
显示数据如图 7.4 。请注意各种 Java 类型数据在显示页面和输入页面的格式和显示不同之处。
图 7.4 多个 material 对象数据显示
代码解释
( 1 )和上一小节示例相比。本示例虽然输入的也是 Material 对象,不过却是多个 Material 对象输入。这里页面上显示的是一共 4 个 Material 对象输入。将这些 Material 对象组装成 List 集合类型,然后也可以让 Struts2 自带的类型转换器进行类型转换。
首先笔者在 Action 代码中定义了 List 类型变量。并且运用 Java5 中的泛型来表明该 List 集合类型变量中的元素都是 Material 对象。当然,也可以在 Action 代码中不使用泛型来标明是何种对象作为 List 集合类型的元素。另一种方法就是示例中写明的在属性文件中指定 List 集合类型的元素是何种对象。
注意:该属性文件属于局部类型转换属性定义文件。文件名要以 ActionName 打头,然后以“ --conversion.properties ”结尾。这表示是对该 Action 中的 List 集合类型指定元素类型。而且该属性文件一定要和 Action 放在同一目录下。否则运行系统时候 Struts2 是不会知道该 Action 的 List 集合类型变量元素是何种类型对象。
( 2 )试设想有一种情况,多个 Action 都需要将某一变量的类型进行转换。此时可以像之前所述使用属性文件来定义被转换类型的变量。但是 1 个 Action 定义 1 个属性文件则太浪费时间。因此 Struts2 中还有个全局类型转换属性定义文件,这样所有需要类型转换的 Action 都可以调用该文件中定义的需要类型转换的变量。全局属性文件名字必须为“ xwork-conversiion.properties ”。文件中定义的内容其实和局部属性文件中大同小异,只是这些被定义的变量可以在所有 Action 中进行类型转换。全局属性文件没必要和具体 Action 代码文件放在一起,只需要放在源代码根目录下即可。也就是说全局属性文件直接放在“ src ”文件夹下即可。
( 3 )在页面输入的 JSP 中,千万不能将 List 集合类型的变量名写错,否则 Action 是得不到具体在页面上输入的值。而且因为是 List 类型,所以可以利用 OGNL 来循环遍历。这样在页面上可依次输入数据。数据显示的 JSP 页面上没有什么特别需要注意的,读者可以看到只是利用 Struts2 的标签来显示这些数据。
( 4 )读者可由图 7.3 、图 7.4 看出,批量的 Material 对象数据输入其实和单个 Material 对象输入本质上没有多大区别。在视图界面上只是利用 OGNL 、 Struts2 标签来保证数据可以输入和显示。在 Action 这一层和普通的 Struts2 的 Action 导航没有多大区别。最重要的是全局和局部类型转换属性文件的定义。让系统明白集合类型中包含的元素是何种对象。不过也请读者不要误解,以为 Set 集合类型转换也是如此。接下来笔者将讲解 Set 集合类型数据类型转换的注意点。