struts2惯用标签详解

struts2常用标签详解

struts2框架是一个非常优秀的mvc框架，时至今日已有很多公司采用其作为表示层的控制转发工具，我非常喜欢struts2的拦截器特性和一整套的自定义标签。在这根据个人使用struts2的经验，与大家分享一些常用的struts2标签，希望对大家有所帮助。

实例场景假设有这样一个网站：需要用户填写个人的信息，包括：编号、姓名、密码、生日、性别、城市、爱好。其中编号需要填入整数，姓名是字符串，密码在页面中必须以密码框的形式显示，生日必须是日期格式，性别单选，城市用下拉列表选择，爱好复选框可以多选。那么用户填写完信息以后，点击“提交”按钮，到下一个页面显示用户填写的信息。需求分析这是一个非常常见的需求，里面囊括了整形、字符串和日期类型等处理，另外用到了文本框、密码框、单选、复选和下拉列表等控件。如果采用servlet/jsp的开发模式是可以实现该功能的，但是很多地方可能需要一些复杂处理，比如用户点击提交到后台需要通过request.getParameter的形式把页面的字段逐个取出来解析；单选、复选和下拉列表中的数据需要使用jsp代码逐个迭代显示；如果加上表单验证的话，这又需要花费更大的精力。struts2提供了一整套的自定义标签解决方案，其功能在原生html标签基础上做了很大的改进：控件的name属性可以采用对象图的形式定义，点击提交按钮通过拦截器自动封装属性，这样在后台就不需要用request获取每个属性字段了；struts2对的单选、复选和下拉列表等控件进行了改进，开发人员只需要用一行代码设置集合数据和key/value即可显示出与html同样功能的组件；同时它提供了独有的错误显示标签，用于显示验证不通过的错误信息，非常方便。实例效果按照我的习惯，我首先把运行的效果展示出来，再根据效果分析每个功能的具体实现。
【表单数据填写页面】
struts2惯用标签详解

?【验证不通过显示的错误消息】
struts2惯用标签详解

?【提交成功后的页面】
struts2惯用标签详解

?后台java代码为了减少大家看代码的疲惫感，我尽量将每个类的核心内容展示出来，具体的代码实现在此就省略掉，如果需要全部代码，可在附件中下载。
首先创建一个UserBean存放用户信息,这是一个javabean：

public class UserBean implements Serializable{private static final long serialVersionUID = -5808037703808170288L;private int userId;   //编号private String userName; //姓名private String password; //密码private Date birthday = new Date(); //生日：格式yyyy-MM-dd,默认为当前时间private int sex;   //性别：0男，1女private int[] hobby; //爱好,数组private int city; //所属 城市               getter、setter...}

?UserBean中的性别、爱好和所属城市均使用int表示，但是在页面中，需要用字符串来展示每个int对应的内容（key/value），所以需要分别创建它们对应的javabean，下面以SexBean为例，其它与此完全类似：

public class CityBean implements Serializable{private static final long serialVersionUID = -6562852059776509594L;private int cityId;private String cityValue;public CityBean(int cityId, String cityValue) {super();this.cityId = cityId;this.cityValue = cityValue;}        getter、setter}

?然后编写一个TagsService，用于处理业务逻辑，供action调用：

public class TagsService {/** * Function  : 获取城市的集合 */public List&lt;CityBean&gt; getCitys()/** * Function  : 获取兴趣的集合 */public List&lt;HobbyBean&gt; getHobbis()/** * Function  : 获取性别的集合 */public List&lt;SexBean&gt; getSexs()/** * Function  : 获取被选中的兴趣爱好集合 */public List&lt;HobbyBean&gt; getCheckedHobbies(int hobbies[])/** * Function  : 获取被选择的城市集合 */public CityBean getSelectedCity(int cityId)}

?最后是mvc的核心Controller-TagsAction，有经验的人看了下面代码或许会觉得有些地方不合理，因为相同功能会有多种实现，我这是做例子，随后会告诉大家哪种方式会更好。

public class TagsAction extends ActionSupport {private static final long serialVersionUID = 4361410156958515185L;private TagsService tagsService = new TagsService();//****formbean*****private List&lt;CityBean&gt; lstCityBean;private List&lt;HobbyBean&gt; lstHobbyBean;private UserBean userBean;//*******action method***********/** * 进入表单填写页面 */public String goIndex(){userBean = new UserBean();HttpServletRequest request = (HttpServletRequest) ActionContext.getContext().get(ServletActionContext.HTTP_REQUEST);request.setAttribute("lstSexBean", tagsService.getSexs());return SUCCESS;}/** * Function  : 提交表单 */public String doSubmit(){HttpServletRequest request = (HttpServletRequest) ActionContext.getContext().get(ServletActionContext.HTTP_REQUEST);request.setAttribute("lstHobby", tagsService.getCheckedHobbies(userBean.getHobby()));request.setAttribute("cityBean", tagsService.getSelectedCity(userBean.getCity()));return SUCCESS;}/** * Function  : 验证表单数据 */public void validateDoSubmit(){if(userBean.getCity()&lt;1){this.addFieldError("userBean.city", "请选择城市！");return;}}public List&lt;CityBean&gt; getLstCityBean() {return tagsService.getCitys();}public List&lt;HobbyBean&gt; getLstHobbyBean() {return tagsService.getHobbis();}        gettter、setter........}

?表单数据填写页面代码分析要使用struts2标签，必须引用struts2的taglib

&lt;%@ taglib prefix="s" uri="/struts-tags"%&gt;

?【表单数据填写页面】

&lt;body&gt;&lt;h3&gt;Debug标签&lt;/h3&gt;&lt;s:debug&gt;&lt;/s:debug&gt;&lt;hr/&gt;&lt;h3&gt;表单标签&lt;/h3&gt;&lt;form action="&lt;%=root%&gt;/doSubmit.action" method="post"&gt;&lt;s:fielderror cssStyle="color:red"&gt;&lt;/s:fielderror&gt;&lt;table&gt;&lt;tr&gt;&lt;td&gt;编号：&lt;/td&gt;&lt;td&gt;&lt;s:textfield name="userBean.userId"/&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;姓名：&lt;/td&gt;&lt;td&gt;&lt;s:textfield name="userBean.userName"&gt;&lt;/s:textfield&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;密码：&lt;/td&gt;&lt;td&gt;&lt;s:password name="userBean.password"&gt;&lt;/s:password&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;生日：&lt;/td&gt;&lt;td&gt;&lt;s:textfield name="userBean.birthday"&gt;&lt;s:param name="value"&gt;&lt;s:date name="userBean.birthday" format="yyyy-MM-dd hh:MM:ss" /&gt;&lt;/s:param&gt;&lt;/s:textfield&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;性别：&lt;/td&gt;&lt;td&gt;&lt;s:radio name="userBean.sex" list="#request.lstSexBean" listKey="sexId" listValue="sexValue"&gt;&lt;/s:radio&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;城市：&lt;/td&gt;&lt;td&gt;&lt;s:select name="userBean.city" list="lstCityBean" listKey="cityId" listValue="cityValue" headerKey="0" headerValue="--请选择--"&gt;&lt;/s:select&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;爱好：&lt;/td&gt;&lt;td&gt;&lt;s:checkboxlist name="userBean.hobby" list="lstHobbyBean" listKey="hobbyId" listValue="hobbyValue"&gt;&lt;/s:checkboxlist&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;s:hidden&gt;&lt;/s:hidden&gt;&lt;td&gt;&lt;s:submit value="提交"/&gt;&lt;/td&gt;&lt;td&gt;&lt;s:reset value="重置"/&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&lt;/form&gt;&lt;/body&gt;

?<s:textfield>标签：文本框标签，可填写文本内容，同时该标签含有很多有用的属性：readonly 只读属性disabled ?可用/不可用属性，如果设置为不可用在提交表单的时候该文本框的值不会传到后台cssClass 指定css的classcssStyle ?自定义css样式maxlength 文本框可输入的文字个数tooltip 冒泡提示上面只是一小部分属性，另外还有各种事件属性：
struts2惯用标签详解

?<s:password>标签：密码框标签，其附带的属性与textfield相似<s:textarea>标签：定义多行的文本输入控件，其核心属性cols和rows分别指定文本域的宽度和高度<s:date>标签：时间显示标签，用于显示指定格式的时间对象，很多人不知道如何在文本框中显示指定日期格式，大家可以参考通过<s:textfield>+<s:date>的形式：

&lt;s:textfield name="userBean.birthday"&gt;&lt;s:param name="value"&gt;&lt;s:date name="userBean.birthday" format="yyyy-MM-dd hh:MM:ss" /&gt;&lt;/s:param&gt;&lt;/s:textfield&gt;

?<s:radio>标签：单选按钮，该控件依然采用key/value的形式处理数据，即key值传到后台，value值显示给用户，结合上面的例子，我们知道性别男的key=0，value="男"，性别女的key=1，value="女"，这就是为什么在后台将性别以SexBean这种javabean的形式来存储。开发用struts2的<s:radio>标签展示单选按钮完全是傻瓜式的操作：设置需要显示的数据集合（collection或array），设置key和value，如下面的代码：

&lt;s:radio name="userBean.sex" list="#request.lstSexBean" listKey="sexId" listValue="sexValue"&gt;&lt;/s:radio&gt;

?注意list就是从后台获取的集合数据，listKey的值最终会赋给name="userBean.sex"，listValue用于显示给用户。从后台向页面传list数据有多种方式，第一种方法是通过request.setAttribut的形式：

request.setAttribute("lstSexBean", tagsService.getSexs());

?第二种更加好些，这也是个人推荐的：首先在action中定义一个集合formbean，设置formbean的get方法，然后重写get方法，返回集合数据：

private List&lt;SexBean&gt; lstSexBean;public List&lt;SexBean&gt; getLstSexBean(){return tagsService.getSexs();}

?其实<s:radio>最后还是转换成html的radio标签显示内容，我们可以看看通过<s:radio>转换后的代码：

&lt;input type="radio" name="userBean.sex" id="userBean_sex0" checked="checked" value="0"/&gt;&lt;label for="userBean_sex0"&gt;男&lt;/label&gt;&lt;input type="radio" name="userBean.sex" id="userBean_sex1" value="1"/&gt;&lt;label for="userBean_sex1"&gt;女&lt;/label&gt;

?<s:select>标签：下拉列表，该标签的使用方法跟<s:radio>标签完全类似，另外可以通过headerKey和headerValue属性设置下拉列表默认值和显示的内容<s:select>转换成普通html后的代码：

&lt;select name="userBean.city" id="userBean_city"&gt;    &lt;option value="0"    selected="selected"    &gt;--请选择--&lt;/option&gt;    &lt;option value="1"&gt;北京&lt;/option&gt;    &lt;option value="2"&gt;上海&lt;/option&gt;    &lt;option value="3"&gt;广州&lt;/option&gt;    &lt;option value="4"&gt;成都&lt;/option&gt;    &lt;option value="5"&gt;深圳&lt;/option&gt;&lt;/select&gt;

?<s:checkboxlist>标签：复选标签，该标签的使用方法跟<s:radio>标签完全类似<s:checkboxlist>转换成普通html后的代码：

&lt;input type="checkbox" name="userBean.hobby" value="1" id="userBean.hobby-1"/&gt;&lt;label for="userBean.hobby-1" name="userBean.hobby" value="2" id="userBean.hobby-2"/&gt;&lt;label for="userBean.hobby-2" name="userBean.hobby" value="3" id="userBean.hobby-3"/&gt;&lt;label for="userBean.hobby-3" name="userBean.hobby" value="4" id="userBean.hobby-4"/&gt;&lt;label for="userBean.hobby-4" name="userBean.hobby" value="5" id="userBean.hobby-5"/&gt;&lt;label for="userBean.hobby-5" id="__multiselect_userBean_hobby" name="__multiselect_userBean.hobby" value="" /&gt;

?<s:hidden>标签：隐藏标签，可以设置变量值，但是不在页面显示<s:submit>标签：表单提交按钮<s:reset>标签：表单重置按钮<s:debug>标签：struts2独有的调试标签，在开发中使用，可以在页面看到值栈中的所有信息，方便调试。
提交后显示的页面点击提交按钮后，经过后台处理，数据传到另一个jsp显示：

&lt;body&gt;&lt;table&gt;&lt;tr&gt;&lt;td&gt;编号：&lt;/td&gt;&lt;td&gt;&lt;s:property value="userBean.userId"&gt;&lt;/s:property&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;姓名：&lt;/td&gt;&lt;td&gt;&lt;s:property value="userBean.userName"&gt;&lt;/s:property&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;密码：&lt;/td&gt;&lt;td&gt;&lt;s:property value="userBean.password"&gt;&lt;/s:property&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;生日：&lt;/td&gt;&lt;td&gt;&lt;s:date name="userBean.birthday" format="yyyy-MM-dd hh:MM:ss" /&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;性别：&lt;/td&gt;&lt;td&gt;&lt;s:if test="userBean.sex==0"&gt;男&lt;/s:if&gt;&lt;s:else&gt;女&lt;/s:else&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;城市：&lt;/td&gt;&lt;td&gt;&lt;s:property value="#request.cityBean.cityValue"/&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;爱好：&lt;/td&gt;&lt;td&gt;&lt;s:if test="#request.lstHobby!=null"&gt;&lt;s:iterator value="#request.lstHobby" var="hobby" status="index" begin="0" end="#request.lstHobby.length-1"&gt;第[&lt;s:property value="%{#attr.index.index+1}"/&gt;]条爱好：&lt;s:property value="%{#attr.hobby.hobbyValue}"/&gt;&lt;br/&gt;&lt;/s:iterator&gt;&lt;/s:if&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&lt;/body&gt;

?<s:property>标签：用于显示变量值的标签，没有什么可说的<s:if><s:elseif><s:else>标签：这三个标签结合使用就能实现java的if...elseif...else的逻辑操作，标签中的test属性用于分之条件判断。<s:iterator>标签：迭代标签，这个标签的功能类似于java的for循环操作，value属性装的是集合对象，var属性是集合中的某一对象，status表示迭代的次数，begin和end表示循环开始位置和结束位置。最后看上面例子的代码：

&lt;s:iterator value="#request.lstHobby" var="hobby" status="index" begin="0" end="#request.lstHobby.length-1"&gt;第[&lt;s:property value="%{#attr.index.index+1}"/&gt;]条爱好：&lt;s:property value="%{#attr.hobby.hobbyValue}"/&gt;&lt;br/&gt;&lt;/s:iterator&gt;

?OGNL简介OGNL是一个功能强大的EL，通过它简单一致的表达式语法，可以存取对象的任意属性，调用对象的方法，遍历整个对象的结构图，实现字段类型转化等功能，它使用相同的表达式去存取对象的属性。

之所以命名为OGNL，就是因为它处理对象很给力，struts能够将对象层层解析，把各个对象的关系以图的样式展示出来。比如userBean.userId，之所以能找到这个对象，就是因为OGNL会先找userBean对象，然后再找userBean对象里的userId属性。假设UserBean这个类还包含了名为Role的javabean的实例，Role里面包含字段roleName，我们要找到roleName就可以直接写<s:property value="user.role.roleName">，OGNL通过对象逐级导航找到子对象。

struts2惯用标签详解

热点推荐