struts2标签库详解

要在jsp中使用Struts2的标志,先要指明标志的引入。通过jsp的代码的顶部加入以下的代码:

<%@taglib prefix="s" uri="/struts-tags" %>

If elseif  else

描述:

执行基本的条件流转。

参数:

 

名称

必需

默认

类型

描述

备注

test

是

 

 

boolean

 

决定标志里的内容是否显示的表达式

else标志没有这个参数

id

否

 

Object/String

用来标识元素的id。在UI和表单中为HTML的id属性

 

 

例子:

01 <s:set name="age" value="61"/>
02  
03 <s:if test="${age > 60}">
04  
05 老年人
06  
07 </s:if>
08  
09 <s:elseif test="${age > 35}">
10  
11 中年人
12  
13 </s:elseif>
14  
15 <s:elseif test="${age > 15}" id="wawa">
16  
17 青年人
18  
19 </s:elseif>
20  
21 <s:else>
22  
23 少年
24  
25 </s:else>
26  
27 <s:set name="name" value="<%="'"+ request.getParameter("name")+"'" %>"/>
28  
29 <%
30  
31 System.out.println(request.getParameter("name"));
32  
33 %>
34  
35 <s:if test="#name=='zhaosoft'">
36  
37 zhaosoft here
38  
39 </s:if>
40  
41 <s:elseif test="#name=='zxl'">
42  
43 zxl here
44  
45 </s:elseif>
46  
47 <s:else>
48  
49 other is here
50  
51 </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

显示的选项个数

例子:

01 <%@ page contentType="text/html;charset=GBK" %>
02  
03 <%@ taglib prefix="s" uri="/struts-tags" %>
04  
05 <h3>使用name和list属性,list属性的值是一个列表</h3>
06  
07 <s:form>
08  
09     <s:select label="最高学历" name="education" list="{'高中','大学','硕士','博士'}"/>
10  
11 </s:form>
12  
13 <h3>使用name和list属性,list属性的值是一个Map</h3>
14  
15 <s:form>
16  
17     <s:select label="最高学历" name="education" list="#{1:'高中',2:'大学',3:'硕士',4:'博士'}"/>
18  
19 </s:form>
20  
21 <h3>使用headerKey和headerValue属性设置header选项</h3>
22  
23 <s:form>
24  
25    <s:select label="最高学历" name="education" list="{'高中','大学','硕士','博士'}"
26  
27        headerKey="-1" headerValue="请选择您的学历"/>
28  
29 </s:form>
30  
31 <h3>使用emptyOption属性在header选项后添加一个空的选项</h3>
32  
33 <s:form>
34  
35     <s:select label="最高学历" name="education" list="{'高中','大学','硕士','博士'}"
36  
37        headerKey="-1" headerValue="请选择您的学历"
38  
39        emptyOption="true"/>
40  
41 </s:form>
42  
43 <h3>使用multiple属性设置多选</h3>
44  
45 <s:form>
46  
47     <s:select label="最高学历" name="education" list="{'高中','大学','硕士','博士'}"
48  
49        headerKey="-1" headerValue="请选择您的学历"
50  
51        emptyOption="true"
52  
53        multiple="true"/>
54  
55 </s:form>
56  
57 <h3>使用size属性设置下拉框可显示的选项个数</h3>
58  
59 <s:form>
60  
61     <s:select label="最高学历" name="education" list="{'高中','大学','硕士','博士'}"
62  
63        headerKey="-1" headerValue="请选择您的学历"
64  
65        emptyOption="true"
66  
67        multiple="true" size="8"/>
68  
69 </s:form>
70  
71 <h3>使用listKey和listValue属性,利用Action实例的属性(property)来设置选项的值和选项的内容</h3>
72  
73 <s:form>
74  
75     <s:select label="最高学历" name="education" list="educations"
76  
77        listKey="id" listValue="name"/>
78  
79 </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

第二个列表框的初始选种项

实例:

01 <s:form name="test">
02  
03 <s:doubleselect label="请选择所在省市"
04  
05    name="province" list="{'四川省','山东省'}" doubleName="city"
06  
07    doubleList="top == '四川省' ? {'成都市', '绵阳市'} : {'济南市', '青岛市'}" />
08  
09 </s:form>
10  
11 <s:form action="doubleselectTag">
12  
13 <s:doubleselect
14  
15         label="请选择所在省市"
16  
17         name="province"
18  
19         list="provinces"
20  
21         listKey="id"
22  
23         listValue="name"
24  
25         doubleList="cities"
26  
27         doubleListKey="id"
28  
29         doubleListValue="name"
30  
31         doubleName="city"
32  
33         headerKey="-1"
34  
35         headerValue="---------- 请选择 ----------"
36  
37         emptyOption="true" />
38  
39 </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

1 <%@ page contentType="text/html;charset=GBK" %>
2  
3 <%@ taglib prefix="s" uri="/struts-tags" %>
4  
5 <s:form>
6  
7     <s:checkboxlist name="interest" list="{'足球','篮球','排球','游泳'}" label="兴趣爱好"/>
8  
9 </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()方法的执行。

01 <s:form action="user">
02  
03    <s:textfield name="user.username" label="用户名"></s:textfield>
04  
05    <s:textfield name="user.password" label="密码"></s:textfield>
06  
07    <s:submit value="登陆" name="method:login"></s:submit>
08  
09    <s:submit value="注册" name="method:register"></s:submit>
10  
11 </s:form>

注意:1。input类型的按钮,不能用label设置按钮上的文本,只能用value

2、action前缀

使用action前缀,取代form标签指定的action,导向到另一个action进行处理。

01 <s:form action="login">
02  
03    <s:textfield name="user.username" label="用户名"></s:textfield>
04  
05    <s:textfield name="user.password" label="密码"></s:textfield>
06  
07    <s:submit value="登陆"></s:submit>
08  
09    <s:submit value="注册" name="action:register"></s:submit>
10  
11 </s:form>

 

 

 

2、redirect前缀

使用redirect前缀请求重定向到其他的url,甚至可以是web英语程序外部的url。

01 <s:form action="login">
02  
03    <s:textfield name="user.username" label="用户名"></s:textfield>
04  
05    <s:textfield name="user.password" label="密码"></s:textfield>
06  
07    <s:submit value="登陆"></s:submit>
08  
09    <s:submit value="搜索" name="redirect:www.google.com"></s:submit>
10  
11 </s:form>

 

 

 

2、redirect-action前缀

使用redirect-action前缀请求重定向到其他的action.

01 <s:form action="login">
02  
03    <s:textfield name="user.username" label="用户名"></s:textfield>
04  
05    <s:textfield name="user.password" label="密码"></s:textfield>
06  
07    <s:submit value="登陆"></s:submit>
08  
09    <s:submit value="搜索" name="redirect-action:register"></s:submit>
10  
11 </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

设置是否使用全部选择按钮

 

实例:

01 <s:form>
02  
03 <!-- 使用简单集合来生成可上下移动选项的下拉选择框 -->
04  
05 <s:updownselect name="a" label="请选择您喜欢的图书" labelposition="top"
06  
07     moveUpLabel="向上移动"
08  
09     list="{'Spring2.0宝典' , '轻量级J2EE企业应用实战' , 'JavaScript: The Definitive Guide'}"/>
10  
11    
12  
13 <!-- 使用简单Map对象来生成可上下移动选项的下拉选择框
14  
15      且使用emptyOption="true"增加一个空选项-->
16  
17 <s:updownselect name="b" label="请选择您想选择出版日期" labelposition="top"
18  
19     moveDownLabel="向下移动"
20  
21     list="#{'Spring2.0宝典':'2006年10月' , '轻量级J2EE企业应用实战':'2007月4月' , '基于J2EE的Ajax宝典':'2007年6月'}"
22  
23     listKey="key"
24  
25     emptyOption="true"
26  
27     listValue="value"/>
28  
29     
30  
31 <s:bean name="com.zhaosoft.ui.formtag.BookService" id="bs"/>
32  
33 <!-- 使用集合里放多个JavaBean实例来可上下移动选项的生成下拉选择框 -->
34  
35 <s:updownselect name="c" label="请选择您喜欢的图书的作者" labelposition="top"
36  
37     selectAllLabel="全部选择" multiple="true"
38  
39     list="#bs.books"
40  
41     listKey="author"
42  
43     listValue="name"/>
44  
45 </s:form>

 

01 package com.zhaosoft.ui.formtag;
02  
03 public class BookService
04 {
05  
06     public Book[] getBooks()
07  
08     {
09  
10        return new Book[]
11  
12        {
13  
14            new Book("Spring2.0宝典","zhaosoft"),
15  
16            new Book("轻量级J2EE企业应用实战","zhaosoft"),
17  
18            new Book("基于J2EE的Ajax宝典","zhaosoft")
19  
20        };
21  
22     }
23  
24 }

 

 

 

 

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

 

 

 

 

 

例子:

01 <s:head/>
02  
03 <s:form>
04  
05     <s:optiontransferselect
06  
07     label="最喜爱的图书"
08  
09         name="javaBook"
10  
11         list="{'《Java Web开发详解》', '《Struts 2深入详解》', '《Java快速入门》'}"
12  
13         doubleName="cBook"
14  
15         doubleList="{'《VC++深入详解》', '《C++ Primer》', '《C++程序设计语言》'}"/>
16  
17 </s:form>
18  
19 ---------------------------
20  
21 <s:form>
22  
23     <s:optiontransferselect
24  
25     label="最喜爱的图书"
26  
27         name="book1"
28  
29         leftTitle="Java图书"
30  
31         rightTitle="C/C++图书"
32  
33         list="{'《Java Web开发详解》', '《Struts 2深入详解》', '《Java快速入门》'}"
34  
35         headerKey="-1"
36  
37         headerValue="--- 请选择 ---"
38  
39         emptyOption="true"
40  
41         doubleName="book2"
42  
43         doubleList="{'《VC++深入详解》', '《C++ Primer》', '《C++程序设计语言》'}"
44  
45         doubleHeaderKey="-1"
46  
47         doubleHeaderValue="--- 请选择 ---"
48  
49         doubleEmptyOption="true"
50  
51         addToLeftLabel="向左移动"
52  
53         addToRightLabel="向右移动"
54  
55         addAllToLeftLabel="全部左移"
56  
57         addAllToRightLabel="全部右移"
58  
59         selectAllLabel="全部选择"
60  
61         leftUpLabel="向上移动"
62  
63         leftDownLabel="向下移动"
64  
65         rightUpLabel="向上移动"
66  
67         rightDownLabel="向下移动"/>
68  
69 </s:form>
posted @ 2016-10-17 19:13  LKBaby  阅读(279)  评论(0)    收藏  举报