原文:struts2标签库详解
源代码下载地址:http://www.zuidaima.com/share/1781606927846400.htm
要在jsp中使用Struts2的标志,先要指明标志的引入。通过jsp的代码的顶部加入以下的代码:
<%@taglib prefix="s" uri="/struts-tags" %>
If elseif else
描述:
执行基本的条件流转。
参数:
名称 | 必需 | 默认 | 类型 | 描述 | 备注 |
test | 是
|
| boolean
| 决定标志里的内容是否显示的表达式 | else标志没有这个参数 |
id | 否 |
| Object/String | 用来标识元素的id。在UI和表单中为HTML的id属性 |
|
例子:
<s:set name="age" value="61"/> <s:if test="${age > 60}"> 老年人 </s:if> <s:elseif test="${age > 35}"> 中年人 </s:elseif> <s:elseif test="${age > 15}" id="wawa"> 青年人 </s:elseif> <s:else> 少年 </s:else> <s:set name="name" value="<%="'"+ request.getParameter("name")+"'" %>"/> <% System.out.println(request.getParameter("name")); %> <s:if test="#name=='zhaosoft'"> zhaosoft here </s:if> <s:elseif test="#name=='zxl'"> zxl here </s:elseif> <s:else> other is here </s:else>
Iterator(迭代)
描述:用于遍历集合(java.util.Collection)或枚举值(java.util.iterator)
参数
名称 | 必需 | 默认 | 类型 | 描述 |
status
| 否
|
| String | 如果设置此参数,一个IteratorStatus的实例将会压入每一个遍历的堆栈 |
value
| 否 |
| Object/String
| 要遍历的可枚举的(iteratable)数据源,或者将放入的新列表(List)的对想 |
id
| 否 |
| Object/String
| 用来标识元素的id。在ui和表单中为HTML的id属性 |
I18n(国际化操作)
描述:
加载资源包到值堆栈。它可以允许text标志访问任何资源包的信息。而不只当前的action相关联的资源包。
名称 | 必需 | 默认 | 类型 | 描述 |
name
| 是
|
| Object/String
| 资源包的类路径(如com.xxxx.resources.AppMsg) |
id
| 否
|
| Object/String
| 用来标识元素的id。在ui和表单中为HTML的id属性 |
Include
描述:包含一个servlet的输出(servlet或jsp的页面)
名称 | 必需 | 默认 | 类型 | 描述 |
value | 时 |
| String | 要包含的jsp页面或servlet |
id | 否 |
| Object/String | 用来标识元素的id。在ui和表单中为HTML的id属性 |
param
描述:属性是可选的,如果提供,会调用Component的方法,addParameter(String,Object),如果不提供,则外层嵌套标签必须实现UnnamedParametric接口。
Value的提供有两种方式,通过value属性或者标签中间的text,不同之处:
<s:param name="name">zhaosoft</s:param>
参数会以String的格式放入statck
<s:param name="name" value="zhaosoft"/>
该值会以java.lang.Object的格式放入statck
名称 | 必需 | 默认 | 类型 | 描述 |
name
| 否
|
| String
| 参数名
|
value | 时 |
| String | value表达式 |
id
| 否
|
| Object/String
| 用来标识元素的id。在ui和表单中为HTML的id属性 |
set
描述:set标签赋予变量一个特定范围内的值。当希望给一个变量赋一个复杂的表达式,每次访问该变量而不是复杂的表达式时用到。其在两种情况下非常有用:复杂的表达式很耗时(性能提升)或者很难理解(代码的可读性提高)
参数:
名称 | 必需 | 默认 | 类型 | 描述 |
name | 是 |
| String | 变量名字 |
scope | 否 |
| String | 变量作用域,可以为application,session,request,page,action |
value | 否 |
| Object/String | 将会赋给变量的值 |
id | 否 |
| Object/String | 用来标识元素的id。在ui和表单中为HTML的id属性 |
Text
描述:支持国际化信息的标签。国际化信息必须放在一个和当前action同名的resource bundle中,如果没有找到相应message,tag body将被当作默认的message,如果没有tag body,message的name会被作为默认message.
名称 | 必需 | 默认 | 类型 | 描述 |
name | 是 |
| String | 资源属性的名字 |
id | 否 |
| Object/String | 用来标识元素的id。在ui和表单中为HTML的id属性 |
url
描述:该标签用于创建url,可以通过”param”标签提供request参数。
当includeParams的值是all或get,param标签中定义的参数将有优先权,也就是说其会覆盖其他同名参数的值。
UI标志
单行文本框
Textfield标签输出一个HTML单行文本输入控件,等价于HTML代码<input type=”text”>
名称 | 必需 | 默认 | 类型 | 描述 |
maxlength | 否 | 无 | Integer | 文本输入控件可以输入字符的最大长度 |
readonly | 否 | false | Boolean | 当该属性为true时,不能输入 |
size | 否 | 无 | Integer | 指定可视尺寸 |
id | 否 |
| Object/String | 用来标识元素的id。在ui和表单中为HTML的id属性 |
例子:
<s:form action="register" method="post">
<s:textfield name="username" label="用户名"></s:textfield>
</s:form>
文本框区
Textarea标签输出一个HTML多行文本输入控件,等价于HTML代码:<textarea />
名称 | 必需 | 默认 | 类型 | 描述 |
cols | 否 | 无 | Integer | 列数 |
rows | 否 | 无 | Integer | 行数 |
readonly | 否 | false | Boolean | 当该属性为true时,不能输入 |
wrap | 否 | false | Boolean | 指定多行文本输入控件是否应该换行 |
id
| 否
|
| Object/String
| 用来标识元素的id。在ui和表单中为HTML的id属性
|
例子:
<s:textarea name="personal" cols="10" rows="5" label="个人简历"></s:textarea>
下拉列表
s:select 标签输出一个下拉列表框,相当于HTML代码中的<select/>
名称 | 必需 | 默认 | 类型 | 描述 |
list | 是 | 无 | Cellection Map Enumeration Iterator array | 要迭代的集合,使用集合中的元素来设置各个选项,如果list的属性为Map则Map的key成为选项的value,Map的value会成为选项的内容 |
listKey | 否 | 无 | String | 指定集合对象中的哪个属性作为选项的value |
listValue | 否 | 无 | String | 指定集合对象中的哪个属性作为选项的内容 |
headerKey | 否 | 无 | String | 设置当用户选择了header选项时,提交的的value,如果使用该属性,不能为该属性设置 空值 |
headerValue | 否 | 无 | String | 显示在页面中header选项内容 |
emptyOption
| 否
| false
| Boolean
| 是否在header选项后面添加一个空选项 |
multiple | 否 | false | Boolean | 是否多选 |
size | 否 | 无 | Integer | 显示的选项个数 |
例子:
<%@ page contentType="text/html;charset=GBK" %> <%@ taglib prefix="s" uri="/struts-tags" %> <h3>使用name和list属性,list属性的值是一个列表</h3> <s:form> <s:select label="最高学历" name="education" list="{'高中','大学','硕士','博士'}"/> </s:form> <h3>使用name和list属性,list属性的值是一个Map</h3> <s:form> <s:select label="最高学历" name="education" list="#{1:'高中',2:'大学',3:'硕士',4:'博士'}"/> </s:form> <h3>使用headerKey和headerValue属性设置header选项</h3> <s:form> <s:select label="最高学历" name="education" list="{'高中','大学','硕士','博士'}" headerKey="-1" headerValue="请选择您的学历"/> </s:form> <h3>使用emptyOption属性在header选项后添加一个空的选项</h3> <s:form> <s:select label="最高学历" name="education" list="{'高中','大学','硕士','博士'}" headerKey="-1" headerValue="请选择您的学历" emptyOption="true"/> </s:form> <h3>使用multiple属性设置多选</h3> <s:form> <s:select label="最高学历" name="education" list="{'高中','大学','硕士','博士'}" headerKey="-1" headerValue="请选择您的学历" emptyOption="true" multiple="true"/> </s:form> <h3>使用size属性设置下拉框可显示的选项个数</h3> <s:form> <s:select label="最高学历" name="education" list="{'高中','大学','硕士','博士'}" headerKey="-1" headerValue="请选择您的学历" emptyOption="true" multiple="true" size="8"/> </s:form> <h3>使用listKey和listValue属性,利用Action实例的属性(property)来设置选项的值和选项的内容</h3> <s:form> <s:select label="最高学历" name="education" list="educations" listKey="id" listValue="name"/> </s:form>
doubleselect标签
doubleselect标签输出关联的两个HTML列表框,产生联动效果。
名称 | 必需 | 默认 | 类型 | 描述 |
list | 是 | 无 | Cellection Map Enumeration Iterator array | 要迭代的集合,使用集合中的元素来设置各个选项,如果list的属性为Map则Map的key成为选项的value,Map的value会成为选项的内容 |
listKey
| 否
| 无
| String
| 指定集合对象中的哪个属性作为选项的value,该选项只对第一个列表框起作用 |
listValue
| 否
| 无
| String
| 指定集合对象中的哪个属性作为选项的内容,该选项只对第一个列表框起作用 |
headerKey
| 否
| 无
| String
| 设置当用户选择了header选项时,提交的的value,如果使用该属性,不能为该属性设置空值 |
headerValue | 否 | 无 | String | 显示在页面中header选项内容 |
emptyOption | 否 | false | Boolean |
|
multiple | 否 | false | Boolean | 是否多选 |
size | 否 | 无 | Integer | 显示的选项个数,该选项只对第一个列表框起作用 |
doubleId | 否 | 无 | String | 指定第二个列表框的ID |
doubleList
| 是
| 无
| Cellection Map Enumeration Iterator array | 要迭代的集合
|
doubleListKey
| 否
| 无
| String
| 指定集合对象中的哪个属性作为选项的value,该选项只对第二个列表框起作用 |
doubleListValue
| 否
| 无
| String
| 指定集合对象中的哪个属性作为选项的内容,该选项只对第二个列表框起作用 |
doubleSize | 否 | 无 | Integer | 选项个数 |
doubleName | 否 | 无 | String | 指定第二个列表框的name映射 |
doubleValue | 否 | 无 | Object | 第二个列表框的初始选种项 |
实例:
<s:form name="test"> <s:doubleselect label="请选择所在省市" name="province" list="{'四川省','山东省'}" doubleName="city" doubleList="top == '四川省' ? {'成都市', '绵阳市'} : {'济南市', '青岛市'}" /> </s:form> <s:form action="doubleselectTag"> <s:doubleselect label="请选择所在省市" name="province" list="provinces" listKey="id" listValue="name" doubleList="cities" doubleListKey="id" doubleListValue="name" doubleName="city" headerKey="-1" headerValue="---------- 请选择 ----------" emptyOption="true" /> </s:form>
复选框
名称 | 必需 | 默认 | 类型 | 描述 |
fieldValue
| 是
| true
| String
| 指定在复选框选中时,实际提交的值
|
复选框组,对应Action中的集合
名称 | 必需 | 默认 | 类型 | 描述 |
list
| 是
| 无
| Cellection Map Enumeration Iterator array | 要迭代的集合,使用集合中的元素来设置各个选项,如果list的属性为Map则Map的key成为选项的value,Map的value会成为选项的内容 |
listKey | 否 | 无 | String | 指定集合对象中的哪个属性作为选项的value |
listValue
| 否
| 无
| String
| 指定集合对象中的哪个属性作为选项的内容
|
例子:checkboxlistTag.jsp
<%@ page contentType="text/html;charset=GBK" %> <%@ taglib prefix="s" uri="/struts-tags" %> <s:form> <s:checkboxlist name="interest" list="{'足球','篮球','排球','游泳'}" label="兴趣爱好"/> </s:form>
文件选择组建
file标签输出一个HTML文件选择框。
名称 | 必需 | 默认 | 类型 | 描述 |
accept
| 否
| input
| String
| HTML accept属性,指出接受文件的MIME类型
|
按钮
Submit标签输出一个按钮,submit标签和form标签使用可以提供异步表单提交功能。Submit标签可以输出以下三种类型的提交按钮:
Input: 等价于 HTML代码<input type=”submit”>
Image: 等价于 HTML代码 <input type="image">
Button:<button type="submit"></button>
名称 | 必需 | 默认 | 类型 | 描述 |
type
| 否
| input
| String
| 要使用的提交按钮的类型,有效值:input button image |
src
| 否
| 无
| String
| 为image类型的提交按钮设置图片地址。该属性对input和button类型的提交按钮无效 |
action | 否 | 无 | String | 指定处理提交请求的action |
method | 否 | 无 | String | 指定处理提交请求的action的方法 |
实例
实例1.
<s:submit type="image" method="login" src="images/login.jpg"></s:submit>
页面输出:
<input type="image" alt="Submit" src="images/login.jpg" id="user__login" name="method:login" value="Submit"/>
实例2.<s:submit type="button" action="selectTag" method="login" label="登陆"></s:submit>
页面输出:
<button type="submit" id="user_selectTag_login" name="action:selectTag!login" value="Submit">登陆</button>
Struts2预定义的前缀:
1。method method:login
使用method前缀,来取代action默认的execute()方法的执行。
<s:form action="user"> <s:textfield name="user.username" label="用户名"></s:textfield> <s:textfield name="user.password" label="密码"></s:textfield> <s:submit value="登陆" name="method:login"></s:submit> <s:submit value="注册" name="method:register"></s:submit> </s:form>
注意:1。input类型的按钮,不能用label设置按钮上的文本,只能用value
2、action前缀
使用action前缀,取代form标签指定的action,导向到另一个action进行处理。
<s:form action="login"> <s:textfield name="user.username" label="用户名"></s:textfield> <s:textfield name="user.password" label="密码"></s:textfield> <s:submit value="登陆"></s:submit> <s:submit value="注册" name="action:register"></s:submit> </s:form>
2、redirect前缀
使用redirect前缀请求重定向到其他的url,甚至可以是web英语程序外部的url。
<s:form action="login"> <s:textfield name="user.username" label="用户名"></s:textfield> <s:textfield name="user.password" label="密码"></s:textfield> <s:submit value="登陆"></s:submit> <s:submit value="搜索" name="redirect:www.google.com"></s:submit> </s:form>
2、redirect-action前缀
使用redirect-action前缀请求重定向到其他的action.
<s:form action="login"> <s:textfield name="user.username" label="用户名"></s:textfield> <s:textfield name="user.password" label="密码"></s:textfield> <s:submit value="登陆"></s:submit> <s:submit value="搜索" name="redirect-action:register"></s:submit> </s:form>
reset标签
reset标签输出一个重置按钮
名称 | 必需 | 默认 | 类型 | 描述 |
type | 否 | input | String | 要使用的重置按钮的内容,input、button |
<s:reset value="重置"></s:reset>
<s:reset type="button" label="重置"></s:reset>
updownselect标签
updownselect标签创建一个带有上下移动的按钮的列表框,可以通过上下移动按钮来调整列表框的选项的位置。
名称 | 必需 | 默认 | 类型 | 描述 |
list
| 是
| 无
| Cellection Map Enumeration Iterator array | 要迭代的集合,使用集合中的元素来设置各个选项,如果list的属性为Map则Map的key成为选项的value,Map的value会成为选项的内容 |
listKey | 否 | 无 | String | 指定集合对象中的哪个属性作为选项的value |
listValue | 否 | 无 | String | 指定集合对象中的哪个属性作为选项的内容 |
headerKey | 否 | 无 | String | 设置当用户选择了header选项时,提交的的value,如果使用该属性,不能为该属性设置空值 |
headerValue | 否 | 无 | String | 显示在页面中header选项内容 |
emptyOption
| 否
| false
| Boolean
| 是否在header选项后面添加一个空选项 |
multiple | 否 | false | Boolean | 是否多选 |
size | 否 | 无 | Integer | 显示的选项个数 |
moveUplabel | 否 |
| String | 设置向上移动按钮上的文本 |
moveDownLabel | 否 |
| String | 设置向下移动按钮上的文本 |
selectAllLabel | 否 |
| String | 设置向全部选择按钮上的文本 |
allowMoveUp | 否 | 无 | Boolean | 设置是否使用向上移动按钮 |
allowMoveDown | 否 | 无 | Boolean | 设置是否使用向下移动按钮 |
allowSelectAll | 否 | 无 | Boolean | 设置是否使用全部选择按钮 |
实例:
<s:form> <!-- 使用简单集合来生成可上下移动选项的下拉选择框 --> <s:updownselect name="a" label="请选择您喜欢的图书" labelposition="top" moveUpLabel="向上移动" list="{'Spring2.0宝典' , '轻量级J2EE企业应用实战' , 'JavaScript: The Definitive Guide'}"/> <!-- 使用简单Map对象来生成可上下移动选项的下拉选择框 且使用emptyOption="true"增加一个空选项--> <s:updownselect name="b" label="请选择您想选择出版日期" labelposition="top" moveDownLabel="向下移动" list="#{'Spring2.0宝典':'2006年10月' , '轻量级J2EE企业应用实战':'2007月4月' , '基于J2EE的Ajax宝典':'2007年6月'}" listKey="key" emptyOption="true" listValue="value"/> <s:bean name="com.zhaosoft.ui.formtag.BookService" id="bs"/> <!-- 使用集合里放多个JavaBean实例来可上下移动选项的生成下拉选择框 --> <s:updownselect name="c" label="请选择您喜欢的图书的作者" labelposition="top" selectAllLabel="全部选择" multiple="true" list="#bs.books" listKey="author" listValue="name"/> </s:form>
package com.zhaosoft.ui.formtag;
public class BookService
{
public Book[] getBooks()
{
return new Book[]
{
new Book("Spring2.0宝典","zhaosoft"),
new Book("轻量级J2EE企业应用实战","zhaosoft"),
new Book("基于J2EE的Ajax宝典","zhaosoft")
};
}
}
optiontransferselect标签
optiontransferselect标签创建一个选项转移列表组建,它由两个<select>标签以及它们之间的用于将选项在两个<select>之间相互移动的按钮组成。表单提交时,将提交两个列表框中选中的选项。
名称 | 必需 | 默认 | 类型 | 描述 |
list
| 是
| 无
| Cellection Map Enumeration Iterator array
| 要迭代的集合,使用集合中的元素来设置各个选项,如果list的属性为Map则Map的key成为选项的value,Map的value会成为选项的内容,该选项只对第一个列表框起作用 |
listKey
| 否
| 无
| String
| 指定集合对象中的哪个属性作为选项的value,该选项只对第一个列表框起作用 |
listValue
| 否
| 无
| String
| 指定集合对象中的哪个属性作为选项的内容,该选项只对第一个列表框起作用 |
headerKey
| 否
| 无
| String
| 设置当用户选择了header选项时,提交的的value,如果使用该属性,不能为该属性设置空值 |
headerValue | 否 | 无 | String | 显示在页面中header选项内容 |
multiple | 否 | false | Boolean | 是否多选 |
size
| 否
| 无
| Integer
| 显示的选项个数,该选项只对第一个列表框起作用 |
doubleId | 否 | 无 | String | 指定第二个列表框的ID |
doubleList
| 是
| 无
| Cellection Map Enumeration Iterator array | 要迭代的集合,使用集合中的元素来设置各个选项,如果doubleList的属性为Map则Map的key成为选项的value,Map的value会成为选项的内容,该选项只对第二个列表框起作用 |
doubleListKey
| 否
| 无
| String
| 指定集合对象中的哪个属性作为选项的value,该选项只对第二个列表框起作用 |
doubleListValue
| 否
| 无
| String
| 指定集合对象中的哪个属性作为选项的内容,该选项只对第二个列表框起作用 |
doubleHeaderKey
| 否
| 无
| String
| 设置当用户选择了header选项时,提交的的value,如果使用该属性,不能为该属性设置空值 |
doubleHeaderVale | 否 | 无 | String | 显示在页面中header选项内容 |
doubleEmptyOption
| 否
| 无
| String
| 是否在第二列表框的header后面添加一个空选项 |
doubleMultiple | 否 | true | Boolean | 是否多选 |
doubleSize | 否 | 无 | Integer | 选项个数 |
doubleName | 否 | 无 | String | 指定第二个列表框的name映射 |
doubleValue | 否 | 无 | Object | 第二个列表框的初始选种项 |
leftTitle | 否 | 无 | String | 左边列表框的标题 |
rightTitle | 否 | <- | String | 右边列表框的标题 |
addToLeftLable | 否 |
| String |
|
addToRightLable |
|
|
|
|
addAllToLeftLable |
|
|
|
|
addAllToRightLable |
|
|
|
|
leftUpLabel |
|
|
|
|
leftDownLabel |
|
|
|
|
rightUpLabel |
|
|
|
|
rightDownLabel |
|
|
|
|
allowAddToLeft |
|
|
|
|
allowAddToright |
|
|
|
|
allowAddAllToLeft |
|
|
|
|
allowAddAllToRight |
|
|
|
|
allowSelectAll | 否 | 无 | Boolean | 设置是否使用全部选择按钮 |
allowUpdownOnLeft |
|
|
|
|
allowUpDownOnRight |
|
|
|
|
例子:
<s:head/> <s:form> <s:optiontransferselect label="最喜爱的图书" name="javaBook" list="{'《Java Web开发详解》', '《Struts 2深入详解》', '《Java快速入门》'}" doubleName="cBook" doubleList="{'《VC++深入详解》', '《C++ Primer》', '《C++程序设计语言》'}"/> </s:form> --------------------------- <s:form> <s:optiontransferselect label="最喜爱的图书" name="book1" leftTitle="Java图书" rightTitle="C/C++图书" list="{'《Java Web开发详解》', '《Struts 2深入详解》', '《Java快速入门》'}" headerKey="-1" headerValue="--- 请选择 ---" emptyOption="true" doubleName="book2" doubleList="{'《VC++深入详解》', '《C++ Primer》', '《C++程序设计语言》'}" doubleHeaderKey="-1" doubleHeaderValue="--- 请选择 ---" doubleEmptyOption="true" addToLeftLabel="向左移动" addToRightLabel="向右移动" addAllToLeftLabel="全部左移" addAllToRightLabel="全部右移" selectAllLabel="全部选择" leftUpLabel="向上移动" leftDownLabel="向下移动" rightUpLabel="向上移动" rightDownLabel="向下移动"/> </s:form>