struts2学习笔记
struts2标签
终于把struts2标签看的差不多了，不过还有好多还不是很熟悉，我是结合Max的struts2教程和struts自带的reference文档学习的！笔记中有好多都是从Max的博客中搬来的。不过也没有办法，咱水平还不行，也只能站在人家的肩膀上学习一下了！！
if，elseif， else标签
<%@ page language=
"java"
import
=
"java.util.*"
pageEncoding=
"UTF-8"
%>
<%@ taglib uri=
"/struts-tags"
prefix=
"s"
%>
<%
String path = request.getContextPath();
String basePath = request.getScheme()+
"://"
+request.getServerName()+
":"
+request.getServerPort()+path+
"/"
;
%>
<!DOCTYPE HTML PUBLIC
"-//W3C//DTD HTML 4.01 Transitional//EN"
>
<html>
<head>
<base href=
"<%=basePath%>"
>
<title>My JSP
'tags.jsp'
starting page</title>
<meta http-equiv=
"pragma"
content=
"no-cache"
>
<meta http-equiv=
"cache-control"
content=
"no-cache"
>
<meta http-equiv=
"expires"
content=
"0"
>
<meta http-equiv=
"keywords"
content=
"keyword1,keyword2,keyword3"
>
<meta http-equiv=
"description"
content=
"This is my page"
>
</head>
<body>
<!--
小技巧：#parameters.country[
1
]可以这样取值！原来Struts2是将URL传的参数封装 成一个数组的，
也就是说你可以在一个URL传两个同名的参数（即?name=a&name=b）；
-->
<%request.setCharacterEncoding(
"utf-8"
);%>
(request获取方式)country=<%=request.getParameter(
"country"
) %><br>
<s:
if
test=
"#parameters.country[1] == 'www'"
>中国</s:
if
>
<s:elseif test=
"#parameters.country[0] == '美国'"
>美国</s:elseif>
<s:
else
>其他国籍的人</s:
else
>
<br>
<!-- 为某个属性赋值 -->
<s:set name=
"country"
value=
"#parameters.country[1]"
></s:set>
country=<s:property value=
"#country"
/> <br>
<s:
if
test=
"#country == 'www'"
>中国</s:
if
>
<s:elseif test=
"#country == '美国'"
>美国</s:elseif>
<s:
else
>其他国籍的人</s:
else
>
<br>
</body>
</html>
|
这里面有个小常识，就是通过url传递参数的时候：Struts2是将URL传的同名参数封装成一个数组，也就是说我们可以在一个URL传两个同名的参数（即?name=a&name=b）；获取的时候直接#parameters.name[0], parameters.name[1]就可以分别取出两个参数的值。
include标签
被包含页面：
<%@ page language=
"java"
import
=
"java.util.*"
pageEncoding=
"UTF-8"
%>
<%@ taglib uri=
"/struts-tags"
prefix=
"s"
%>
this
is the include page!!!
|
包含页面：
<%@ page language=
"java"
import
=
"java.util.*"
pageEncoding=
"UTF-8"
%>
<%@ taglib uri=
"/struts-tags"
prefix=
"s"
%>
<%
String path = request.getContextPath();
String basePath = request.getScheme() +
"://"
+ request.getServerName() +
":"
+ request.getServerPort()
+ path +
"/"
;
%>
<!DOCTYPE HTML PUBLIC
"-//W3C//DTD HTML 4.01 Transitional//EN"
>
<html>
<head>
<base href=
"<%=basePath%>"
>
<title>My JSP
'includea.jsp'
starting page</title>
<meta http-equiv=
"pragma"
content=
"no-cache"
>
<meta http-equiv=
"cache-control"
content=
"no-cache"
>
<meta http-equiv=
"expires"
content=
"0"
>
<meta http-equiv=
"keywords"
content=
"keyword1,keyword2,keyword3"
>
<meta http-equiv=
"description"
content=
"This is my page"
>
<!--
<link rel=
"stylesheet"
type=
"text/css"
href=
"styles.css"
mce_href=
"styles.css"
>
-->
</head>
<body>
This is my JSP1 page.
<br>
<s:include value=
"include.jsp"
>
<!-- 提交表单时才会获得value的值 -->
<s:param name=
"value1"
>test1</s:param>
<s:param name=
"value2"
value=
"user"
></s:param>
</s:include>
</body>
</html>
|
当然struts的include标签静态动态页面都能包含的！
i18n标签
描述：加载资源包到值堆栈。它可以允许text标志访问任何资源包的信息，而不只当前action相关联的资源包。
<%@ page language=
"java"
import
=
"java.util.*"
pageEncoding=
"UTF-8"
%>
<%@ taglib uri=
"/struts-tags"
prefix=
"s"
%>
<%
String path = request.getContextPath();
String basePath = request.getScheme()+
"://"
+request.getServerName()+
":"
+request.getServerPort()+path+
"/"
;
%>
<!DOCTYPE HTML PUBLIC
"-//W3C//DTD HTML 4.01 Transitional//EN"
>
<html>
<head>
<base href=
"<%=basePath%>"
>
<title>My JSP
'tags3.jsp'
starting page</title>
<meta http-equiv=
"pragma"
content=
"no-cache"
>
<meta http-equiv=
"cache-control"
content=
"no-cache"
>
<meta http-equiv=
"expires"
content=
"0"
>
<meta http-equiv=
"keywords"
content=
"keyword1,keyword2,keyword3"
>
<meta http-equiv=
"description"
content=
"This is my page"
>
<!--
<link rel=
"stylesheet"
type=
"text/css"
href=
"styles.css"
mce_href=
"styles.css"
>
-->
</head>
<body>
<!-- <s:text>标签没弄明白 -->
<s:i18n name=
"I18N"
>
The i18n value is <s:text name=
"hi!!"
></s:text>
</s:i18n>
<br>
<s:debug></s:debug>
</body>
</html>
|
iterator标签
<%@ page language=
"java"
import
=
"java.util.*"
pageEncoding=
"UTF-8"
%>
<%@ taglib uri=
"/struts-tags"
prefix=
"s"
%>
<%
String path = request.getContextPath();
String basePath = request.getScheme()+
"://"
+request.getServerName()+
":"
+request.getServerPort()+path+
"/"
;
%>
<!DOCTYPE HTML PUBLIC
"-//W3C//DTD HTML 4.01 Transitional//EN"
>
<html>
<head>
<base href=
"<%=basePath%>"
>
<title>My JSP
'tags2.jsp'
starting page</title>
<meta http-equiv=
"pragma"
content=
"no-cache"
>
<meta http-equiv=
"cache-control"
content=
"no-cache"
>
<meta http-equiv=
"expires"
content=
"0"
>
<meta http-equiv=
"keywords"
content=
"keyword1,keyword2,keyword3"
>
<meta http-equiv=
"description"
content=
"This is my page"
>
<!--
<link rel=
"stylesheet"
type=
"text/css"
href=
"styles.css"
mce_href=
"styles.css"
>
-->
</head>
<%
List<String> strs =
new
ArrayList<String>();
strs.add(
"a"
);
strs.add(
"b"
);
strs.add(
"c"
);
strs.add(
"d"
);
strs.add(
"e"
);
request.setAttribute(
"strs"
, strs);
%>
<body>
<s:iterator value=
"#request.strs"
var=
"strs"
>
<s:property value=
"#strs"
/>
</s:iterator>
<s:debug></s:debug>
</body>
</html>
|
这个标签挺容易理解的。
param标签
struts2的<s: param>标签问我觉得比较复杂的。struts2的s:param标签主要有两个属性name与value, 若想在value属性中输入直接量,则可以这样写:<s:param name="some" value="%{'user'}"/>, 也可以这样写:<s:param name="some">user</s:param>。 但如果直接赋值，这个值不是由Action动态生成的，而是自己指定的一个字符串，则只能用后者。
param页面代码：
<%@ page language=
"java"
import
=
"java.util.*"
pageEncoding=
"UTF-8"
%>
<%@ taglib uri=
"/struts-tags"
prefix=
"s"
%>
<%
String path = request.getContextPath();
String basePath = request.getScheme()+
"://"
+request.getServerName()+
":"
+request.getServerPort()+path+
"/"
;
%>
<!DOCTYPE HTML PUBLIC
"-//W3C//DTD HTML 4.01 Transitional//EN"
>
<html>
<head>
<base href=
"<%=basePath%>"
>
<title>My JSP
'param.jsp'
starting page</title>
<meta http-equiv=
"pragma"
content=
"no-cache"
>
<meta http-equiv=
"cache-control"
content=
"no-cache"
>
<meta http-equiv=
"expires"
content=
"0"
>
<meta http-equiv=
"keywords"
content=
"keyword1,keyword2,keyword3"
>
<meta http-equiv=
"description"
content=
"This is my page"
>
<!--
<link rel=
"stylesheet"
type=
"text/css"
href=
"styles.css"
mce_href=
"styles.css"
>
-->
</head>
<body>
<!-- struts2的s:param标签主要有两个属性name与value,
若想在value属性中输入直接量,则可以这样写:<s:param name=
"some"
value=
"%{'user'}"
/>,
也可以这样写:<s:param name=
"some"
>user</s:param>。
但如果直接赋值，这个值不是由Action动态生成的，而是自己指定的一个字符串，则只能用后者。 -->
<s:url value=
"paramAction.jsp"
id=
"href"
>
<s:param name=
"value1"
>hello!!</s:param>
<s:param name=
"valu2"
value=
"%{'HELLO!'}"
></s:param>
</s:url>
<s:a href=
"%{href}"
mce_href=
"%{href}"
>paramAction</s:a>
<s:debug></s:debug>
</body>
</html>
|
paramAction页面：
<%@ page language=
"java"
import
=
"java.util.*"
pageEncoding=
"UTF-8"
%>
<%@ taglib uri=
"/struts-tags"
prefix=
"s"
%>
<%
String path = request.getContextPath();
String basePath = request.getScheme()+
"://"
+request.getServerName()+
":"
+request.getServerPort()+path+
"/"
;
%>
<!DOCTYPE HTML PUBLIC
"-//W3C//DTD HTML 4.01 Transitional//EN"
>
<html>
<head>
<base href=
"<%=basePath%>"
>
<title>My JSP
'paramAction.jsp'
starting page</title>
<meta http-equiv=
"pragma"
content=
"no-cache"
>
<meta http-equiv=
"cache-control"
content=
"no-cache"
>
<meta http-equiv=
"expires"
content=
"0"
>
<meta http-equiv=
"keywords"
content=
"keyword1,keyword2,keyword3"
>
<meta http-equiv=
"description"
content=
"This is my page"
>
<!--
<link rel=
"stylesheet"
type=
"text/css"
href=
"styles.css"
mce_href=
"styles.css"
>
-->
</head>
<body>
value1的值：<%=request.getParameter(
"value1"
) %><br>
value1的值：<s:property value=
"#parameters.value1"
/><br>
value2的值：<%=request.getParameter(
"value2"
) %><br/><!-- 获取不到值 -->
value2的值：${#param.value2 }<!-- 获取不到值 -->
<s:debug></s:debug>
</body>
</html>
|
经常用到的UI标签
<%@ page contentType=
"text/html; charset=UTF-8"
pageEncoding=
"UTF-8"
%>
<%@ taglib prefix=
"s"
uri=
"/struts-tags"
%>
<%@ taglib prefix=
"s"
uri=
"/struts-tags"
%>
<%@ taglib prefix=
"sx"
uri=
"/struts-dojo-tags"
%>
<html>
<head>
<title>UI Tags Example</title>
<s:head />
<sx:head parseContent=
"true"
/>
</head>
<body>
<s:actionerror/>
<s:actionmessage/>
<s:fielderror />
<s:form action=
"exampleSubmit"
method=
"post"
enctype=
"multipart/form-data"
tooltipConfig=
"#{'jsTooltipEnabled':'true'}"
>
<s:textfield
label=
"Name"
name=
"name"
tooltip=
"Enter your Name here"
/>
<s:date name=
"Select Your Birthday"
/>
<!-- 在struts2.
2.1
中<sx:datetimepicker/>的标签使用有所变化，需要引入struts2-dojo-plugin-
2.2
.
1
.jar
这个包。
-->
<sx:datetimepicker
tooltip=
"Select Your Birthday"
label=
"Birthday"
name=
"birthday"
/>
<s:textarea
tooltip=
"Enter your Biography"
label=
"Biograph"
name=
"bio"
cols=
"20"
rows=
"3"
/>
<s:select
tooltip=
"Choose Your Favourite Color"
label=
"Favorite Color"
list=
"{'Red', 'Blue', 'Green'}"
name=
"favoriteColor"
emptyOption=
"true"
headerKey=
"None"
headerValue=
"None"
/>
<s:select
tooltip=
"Choose Your Favourite Language"
label=
"Favourite Language"
list=
"#{'CN':'中文','EN':'英文','FR':'外文'}"
name=
"favouriteLanguage"
emptyOption=
"true"
headerKey=
"None"
headerValue=
"None"
/>
<s:checkboxlist
tooltip=
"Choose your Friends"
label=
"Friends"
list=
"{'Patrick', 'Jason', 'Jay', 'Toby', 'Rene'}"
name=
"friends"
/>
<s:checkbox
tooltip=
"Confirmed that your are Over 18"
label=
"Age 18+"
name=
"legalAge"
/>
<s:doubleselect
tooltip=
"Choose Your State"
label=
"State"
name=
"region"
list=
"{'North', 'South'}"
value=
"'South'"
doubleValue=
"'Florida'"
doubleList=
"top == 'North' ? {'Oregon', 'Washington'} : {'Texas', 'Florida'}"
doubleName=
"state"
headerKey=
"-1"
headerValue=
"---------- Please Select ----------"
emptyOption=
"true"
/>
<s:file
tooltip=
"Upload Your Picture"
label=
"Picture"
name=
"picture"
/>
<s:optiontransferselect
tooltip=
"Select Your Favourite Cartoon Characters"
label=
"Favourite Cartoons Characters"
name=
"leftSideCartoonCharacters"
leftTitle=
"Left Title"
rightTitle=
"Right Title"
list=
"{'Popeye', 'He-Man', 'Spiderman'}"
multiple=
"true"
headerKey=
"headerKey"
headerValue=
"--- Please Select ---"
emptyOption=
"true"
doubleList=
"{'Superman', 'Mickey Mouse', 'Donald Duck'}"
doubleName=
"rightSideCartoonCharacters"
doubleHeaderKey=
"doubleHeaderKey"
doubleHeaderValue=
"--- Please Select ---"
doubleEmptyOption=
"true"
doubleMultiple=
"true"
/>
<s:textarea
label=
"Your Thougths"
name=
"thoughts"
tooltip=
"Enter your thoughts here"
/>
<s:submit onclick=
"alert('aaaa');"
/>
<s:reset onclick=
"alert('bbbb');"
/>
</s:form>
</body>
</html>
|
这些代码是直接从Max的博文中copy过来的，本来这是一个完整的例子我只是把前台展示代码考过来了。在这里有一个要注意的地方，不过在代码中也有体现，这是struts2比较高级的版本和低版本之间的区别，具体从哪个 版本改的我也不是很清楚。这个不同的用法是关于<s: datetimepicker>的。在使用<s: datetimepicker>时，较高的版本中还必须引入struts2-dojo-plugin-2.2.1.jar，还得指明<%@ taglib prefix="sx" uri="/struts-dojo-tags" %> ，如果做实验不成功的可以考虑下是不是这个问题。
struts-tags就算是复习到这里了，如果要是配合一个具体的项目的话就会更好了，继续努力！！！
--------------------------
要在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>