Struts2 标签库 [Tablib]
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标签连用。
参数
|
名字
|
是否必须
|
默认值
|
可否使用表达式
|
类型
|
描述
|
|
id
|
否
|
|
是
|
String
|
用来表示该元素，对于UI和Form标签来说直接转变为HTML id属性
|
|
test
|
是
|
|
是
|
Boolean
|
用来决定是否显示标签内部内容的表达式
|
例子
<s:if test="%{false}"></s:if>
Will Not Be Executed
<s:elseif test="%{true}"></s:elseif>
Will Be Executed
<s:else></s:else>
Will Not Be Executed
elseIf
标签
参考if标签
else
标签
参考if标签
append
标签
描述
用来做iterator标签的辅助，将不同iterator中的内容合在一个iterator中。
参数
|
名字
|
是否必须
|
默认值
|
可否使用表达式
|
类型
|
描述
|
|
id
|
否
|
|
是
|
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:append>
<s:param value="%{myList1}">
<s:param value="%{myList2}">
<s:param value="%{myList3}">
<s:iterator value="%{#myAppendIterator}"></s:iterator>
<s:property></s:property>
generator
标签（JSP Tag）
描述
从val属性生成一个iterator。
参数
例子
例1:
生成一个简单的iterator，并且使用iterator标签打印出内容。
<s:generator val="%{'aaa,bbb,ccc,ddd,eee'}"></s:generator>
<s:iterator></s:iterator>
<s:property></s:property>
例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:generator>
<s:iterator></s:iterator>
<s:property></s:property>
例3:
生成iterator，使用了id属性，之后生成的对象放在pageContext中，可以通过指定的id来访问。
<s:generator id="myAtt" val="%{'aaa,bbb,ccc,ddd,eee'}" count="4" separator=","></s:generator>
<!---->
<!---->
<!---->
例4:
生成iterator，使用converter属性，这里的convertor仅仅将每一个对象添加了一个"converter-"前缀。
<s:generator val="%{'aaa,bbb,ccc,ddd,eee'}" converter="%{myConverter}"></s:generator>
<s:iterator></s:iterator>
<s:property></s:property>
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对象
参数
|
名字
|
是否必须
|
默认值
|
可否使用表达式
|
类型
|
描述
|
|
id
|
否
|
|
是
|
String
|
Id
，
|
|
status
|
否
|
否
|
是
|
Boolean
|
如果指定，在循环的过程中会保留一个IteratorStatus类型的变量，该变量用来查询当前迭代的状态
|
|
value
|
否
|
|
是
|
String
|
被迭代的对象
|
例子
例1：
<s:iterator value="days"></s:iterator>
day is: <s:property></s:property>
例2：
<s:bean id="it" name="org.apache.struts2.example.IteratorExample"></s:bean>
<s:param name="day" value="'foo'">
<s:param name="day" value="'bar'">