第四章 Tablib Struts标签库

技术2022-05-20 55

Struts2 Taglib抽象了不同表示技术，现在Struts2主要支持三种表示技术：JSP,FreeMarker和Velocity。但部分的Tag在三种表示技术下都可以使用，但是也有部分只能在某一种情况下使用。

Tab可以分为两类：通用标签和UI标签。

4.1节通用标签

通用标签用来在页面表示的时候控制代码执行的过程，这些标签也允许从Action或者值堆栈中取得数据。例如地域，JavaBeans，URLs，和action。

控制标签控制程序执行，例如：if，else,iterator

数据标签管理数据的取得和创建，例如：bean，push,i18n

控制标签

if标签

描述

If标签用来控制基本的条件处理流程，通常和else标签或者elseif标签连用。

参数

名字

是否必须

默认值

可否使用表达式

类型

描述

否

是

String

用来表示该元素，对于UI和Form标签来说直接转变为HTML id属性

test

是

Boolean

用来决定是否显示标签内部内容的表达式

例子

<s:if test="%{false}">

<div>Will Not Be Executed</div>

</s:if>

<s:elseif test="%{true}">

<div>Will Be Executed</div>

</s:elseif>

<s:else>

<div>Will Not Be Executed</div>

</s:else>

elseIf 标签

参考if标签

else 标签

参考if标签

append标签

描述

用来做iterator标签的辅助，将不同iterator中的内容合在一个iterator中。

参数

名字

是否必须

默认值

可否使用表达式

类型

描述

否

是

String

用来保存结果iterator的对象在value context中的名字。

例子

Action类

public class AppendIteratorTagAction extends ActionSupport {

private List myList1;

private List myList2;

private List myList3;

public String execute() throws Exception {

myList1 = new ArrayList();

myList1.add("1");

myList1.add("2");

myList1.add("3");

myList2 = new ArrayList();

myList2.add("a");

myList2.add("b");

myList2.add("c");

myList3 = new ArrayList();

myList3.add("A");

myList3.add("B");

myList3.add("C");

return "done";

}

public List getMyList1() { return myList1; }

public List getMyList2() { return myList2; }

public List getMyList3() { return myList3; }

标签使用

<s:append id="myAppendIterator">

<s:param value="%{myList1}" />

<s:param value="%{myList2}" />

<s:param value="%{myList3}" />

</s:append>

<s:iterator value="%{#myAppendIterator}">

<s:property />

</s:iterator>

generator 标签（JSP Tag）

描述

从val属性生成一个iterator。

参数

例子

例1:

生成一个简单的iterator，并且使用iterator标签打印出内容。

<s:generator val="%{'aaa,bbb,ccc,ddd,eee'}">

<s:iterator>

<s:property /><br/>

</s:iterator>

</s:generator>

例2:

生成一个iterator，使用count属性。因为count属性值为3，所以只有前三个内容（aaa,bbb,ccc）在生成的iterator中。

Generate an iterator with count attribute

<s:generator val="%{'aaa,bbb,ccc,ddd,eee'}" count="3">

<s:iterator>

<s:property /><br/>

</s:iterator>

</s:generator>

例3:

生成iterator，使用了id属性，之后生成的对象放在pageContext中，可以通过指定的id来访问。

<s:generator val="%{'aaa,bbb,ccc,ddd,eee'}" count="4" separator="," id="myAtt" />

Iterator i = (Iterator) pageContext.getAttribute("myAtt");

while(i.hasNext()) {

String s = (String) i.next();

<%= s %> <br/>

}

例4:

生成iterator，使用converter属性，这里的convertor仅仅将每一个对象添加了一个"converter-"前缀。

<s:generator val="%{'aaa,bbb,ccc,ddd,eee'}" converter="%{myConverter}">

<s:iterator>

<s:property /><br/>

</s:iterator>

</s:generator>

public class GeneratorTagAction extends ActionSupport {

....

public Converter getMyConverter() {

return new Converter() {

public Object convert(String value) throws Exception {

return "converter-"+value;

}

};

}

...

}

iterator 标签

描述

迭代处理一个java.util.Connection或者java.util.Iterator对象

参数

名字

是否必须

默认值

可否使用表达式

类型

描述

否

是

String

Id，

status

否

是

Boolean

如果指定，在循环的过程中会保留一个IteratorStatus类型的变量，该变量用来查询当前迭代的状态

value

否

是

String

被迭代的对象

例子

例1：

<s:iterator value="days">

</s:iterator>

例2：

<s:bean name="org.apache.struts2.example.IteratorExample" id="it">

<s:param name="day" value="'foo'"/>

<s:param name="day" value="'bar'"/>

</s:bean>

<p/>

<tr>

</tr>

<p/>

<s:iterator value="#it.days" status="rowstatus">

<tr>

<s:if test="#rowstatus.odd == true">

</s:if>

<s:else>

</s:else>

</tr>

</s:iterator>

</table>

例3：

<s:iterator value="groupDao.groups" status="groupStatus">

<tr

class="<s:if test="#groupStatus.odd == true ">odd</s:if><s:else>even</s:else>">

<td>

<s:iterator value="users" status="userStatus">

<s:property value="fullName" />

<s:if test="!#userStatus.last">,</s:if>

</s:iterator>

</td>

</tr>

</s:iterator>

merge 标签（同append？）

描述

参数

例子

sort 标签（JSP-Tag）

描述

对一个可以迭代的对象进行排序操作。

参数

名字

是否必须

默认值

可否使用表达式

类型

描述

Comparator

是

java.util.Comparator

排序用的比较器

Source

否

是

String

排序对象

例子

例1:

<s:sort comparator="myComparator" source="myList">

<s:iterator>

<s:property value="..." />

</s:iterator>

</s:sort>

例2:

<s:sort id="mySortedList" comparator="myComparator" source="myList" />

Iterator sortedIterator = (Iterator) pageContext.getAttribute("mySortedList");

for (Iterator i = sortedIterator; i.hasNext(); ) {

// do something with each of the sorted elements

}

subset

描述

递归iterator的一部分

参数

名字

是否必须

默认值

可否使用表达式

类型

描述

count

False

是

Integer

Iterator中被递归的一部分的item的数量

Decider

否

是

org.apache.struts2.util.

SubsetIteratorFilter.Decider

用来判断iterator中的item是否包含在最终的subset内部

Source

否

是

String

Iterator的对象

Start

否

是

Integer

开始位置

例子

Java类

public class MySubsetTagAction extends ActionSupport {

public String execute() throws Exception {

l = new ArrayList();

l.add(new Integer(1));

l.add(new Integer(2));

l.add(new Integer(3));

l.add(new Integer(4));

l.add(new Integer(5));

return "done";

}

public Integer[] getMyArray() {

return a;

}

public List getMyList() {

return l;

}

public Decider getMyDecider() {

return new Decider() {

public boolean decide(Object element) throws Exception {

int i = ((Integer)element).intValue();

return (((i % 2) == 0)?true:false);

}

};

}

<s:subset source="myList">

<s:iterator>

<s:property />

</s:iterator>

</s:subset>

<s:subset source="myList" count="3">

<s:iterator>

<s:property />

</s:iterator>

</s:subset>

<s:subset source="myList" count="13" start="3">

<s:iterator>

<s:property />

</s:iterator>

</s:subset>

<s:subset id="mySubset" source="myList" count="13" start="3" />

Iterator i = (Iterator) pageContext.getAttribute("mySubset");

while(i.hasNext()) {

<%=i.next() %>

<% } %>

<s:subset source="myList" decider="myDecider">

<s:iterator>

<s:property />

</s:iterator>

</s:subset>

数据标签

@TODO 完成如下数据标签

数据标签包括

action

bean

date

debug

i18n

include

param

push

set

text

url

property

4.2节 UI标签

UI标签主要是指Form相关的标签，UI标签又分为两部分：form标签和构成form内部字段的其他标签。

每一个UI标签都是基于模板的，即：每一个标签都有一个对应的模板用来生成UI标签的样式，详细内容参看模板节。

所有的UI标签都有着共通的祖先UIBean，UIBean提供了这些UI标签的一系列共通的属性，这些属性可以分为三类：模版相关的属性，JavaScript相关的属性和其他通用属性。

模版相关属性：

属性

主题

数据类型

说明

templateDir

n/a

String

定义模版目录

theme

n/a

String

定义主题的名字

template

n/a

String

定义模版名字

JavaScript相关属性：

属性

主题

数据类型

说明

onclick

simple

String

html javascript onclick 属性

ondbclick

simple

String

html javascript ondbclick属性

onmousedown

simple

String

html javascript onmousedown属性

onmouseup

simple

String

html javascript onmouseup属性

onmouseover

simple

String

html javascript onmouseover属性

onmouseout

simple

String

html javascript onmouseout属性

onfocus

simple

String

html javascript onfocus属性

onblur

simple

String

html javascript onblur属性

onkeypress

simple

String

html javascript onkeypress属性

onkeyup

simple

String

html javascript onkeyup属性

onkeydown

simple

String

html javascript onkeydown属性

onselect

simple

String

html javascript onselect属性

onchange

simple

String

html javascript onchange属性

Tooltip相关属性：

属性

数据类型

默认值

说明

tooltip

String

none

为指定的组件设置Tooltip

jsTooltipEnabled

String

false

使用js表示tooltip

tooltipIcon

String

/struts/static/tooltip/tooltip.gif

指向tooltip图表的URL

tooltipDelay

String

500

多长时间后显示Tooltip

key

simple

String

这个输入字段对应的属性，用来自动设置name，label和value

通用属性：

属性

主题

数据类型

说明

cssClass

simple

String

定义html class 属性

cssStyle

simple

String

定义html style属性

title

simple

String

定义html title属性

disabled

simple

String

定义html disabled属性

label

xhtml

String

定义form字段的标签

labelPosition

xhtml

String

定义标签在Form中的位置，从左从上计算

requiredPosition

xhtml

String

定义必须的标签在Form中的位置，从左从上计算

name

simple

String

定义form字段的name映射

required

xhtml

Boolean

在label上添加一个*

tabIndex

simple

String

定义 html tabIndex属性

value

simple

Object

定义form字段的值

对于name和value的说明：

name用来说明Form字段的名字，和Action类的属性对应。

value用来记录Form字段的值，和Action类中属性的值对应。

所以在修改一个字段的内容的时候应该使用如下的标签：

<s:form action="updateAddress">

<s:textfield label="Postal Code" name="postalCode" value="%{postalCode}"/>

...

</s:form>

但是，由于name和value的关系，struts2标准标签可以自动对应，所以也可以使用如下标签：

<s:form action="updateAddress">

<s:textfield label="Postal Code" name="postalCode" />

...

</s:form>

UI标签说明：

Form部分

autocompleter

checkbox

checkboxlist

combobox

datetimepicker

doubleselect

head

file

form

hidden

label

optiontransferselect

optgroup

password

radio

reset

select

submit

textarea

textfield

token

updownselect

非Form部分：

actionerror

actionmessage

component

div

fielderror

table

tabbedPanel

tree

treenode

4.3节主题和模板

概念说明：

标签（tag）：一小段代码，在JSP，Velocity或者FreeMarker中执行。程序开发的最小单位，用来生成HTML对应的元素。

模板（template）：一些代码，通常使用FreeMarker写成，可以被某些Tag表示出来（通常是UI Tag）。

主题（theme）：一组模板打包在一起，提供通用功能的模版

主题和模板主要针对可视化的标签（Tag）而言，使用以下例子来说明三者之间的关系。

假如我们要开发如下的一个画面：

我们使用如下的代码：

<s:url action="login" id="loginUrl"></s:url>

<s:form action="%{loginUrl}">

<s:textfield label="Name" name="name"/>

<s:password label="Password" name="password" />

<s:submit></s:submit>

<s:reset></s:reset>

</s:form>

这里<s:form>，<s:textfield>，<s:password>，<s:submit>，<s:reset>每一个都是一个标签（tag）。

我们在看看这些标签在一起生成的HTML源代码：

<form id="login" onsubmit="return true;"

action="/login/login/login.action" method="post">

<tr>

Name:

</label>

</td>

<td>

<input type="text" name="name"

value="" id="login_name" />

</td>

</tr>

<tr>

Password:

</label></td>

<td>

<input type="password"

name="password" id="login_password" />

</td>

</tr>

<tr>

<div align="right"><input type="submit" id="login_0"

value="Submit" /></div>

</td>

</tr>

<tr>

<div align="right"><input type="reset"

value="Reset" /></div>

</td>

</tr>

</table>

</form>

在由标签生成HTML代码的时候，例如：

<s:textfield label="Name" name="name"/>

生成的代码为：

<tr>

Name:

</label>

</td>

<td>

</td>

</tr>

我们可以看到，<s:textfield>标签提供的有效信息只有Name和name，而其余的部分，例如<tr>，<td>，<label>等代码都根据一个固定的模板文件生成，这个模板文件为：

标签使我们开发JSP画面的时候使用的最小组件单元，我们根据客户的需要组合各种Tag达到客户的需求。模板是生成这些Tag时候使用的，使用模板可以定义Tag的基本形式，在使用tag的时候，我们只需要指定该Tag的不同属性，即可根据Tag指定的特殊属性，结合模板的基本属性生成可视化的HTML元素。主题是不同tag结合在一起而形成的。

name="${parameters.name?default("")?html}"<#rt/>

<#if parameters.get("size")?exists>

size="${parameters.get("size")?html}"<#rt/>

</#if>

<#if parameters.maxlength?exists>

maxlength="${parameters.maxlength?html}"<#rt/>

</#if>

<#if parameters.nameValue?exists>

value="<@s.property value="parameters.nameValue"/>"<#rt/>

</#if>

<#if parameters.disabled?default(false)>

disabled="disabled"<#rt/>

</#if>

<#if parameters.readonly?default(false)>

readonly="readonly"<#rt/>

</#if>

<#if parameters.tabindex?exists>

tabindex="${parameters.tabindex?html}"<#rt/>

</#if>

<#if parameters.id?exists>

id="${parameters.id?html}"<#rt/>

</#if>

<#if parameters.cssClass?exists>

class="${parameters.cssClass?html}"<#rt/>

</#if>

<#if parameters.cssStyle?exists>

style="${parameters.cssStyle?html}"<#rt/>

</#if>

<#if parameters.title?exists>

title="${parameters.title?html}"<#rt/>

</#if>

<#include "/${parameters.templateDir}/simple/scripting-events.ftl" />

<#include "/${parameters.templateDir}/simple/common-attributes.ftl" />

我们考虑标签（Tag）使用模板（Template）生成HTML的过程，根据不同的模板，坑顶可以生成不同的HTML画面，这样我们可以把不同tag的，视觉效果一致的模板放在一起：

例如：

<s:form> TemplateForm_A, TemplateForm_B

<s:textfield> TemplateTextField_A, TemplateTextField_B

<s:password> TemplatePassword_A, TemplatePassword_B

<s:submit>， TemplateSubmit_A, TemplateSubmit_B

<s:reset> TemplateReset_A, TemplateReset_B

这样将_A的模板放在一起叫做A主题（Theme），将_B的模板放在一起叫B主题。这样我们在分别使用A主题，B主题的时候可以得到同一个Tag的不同的视觉效果。

模版和主题的概念处在Struts Tag的核心位置。

Struts2默认提供了四种主题：

Simple 主题：最简单的主题

XHTML 主题：默认主题，使用常用的HTML技巧

CSS XHTML主题：使用CSS实现的XHTML主题

AJAX 主题：基于XHTML主题，但是同工了AJAX功能

专利

最新回复(0)