struts2学习――标签库

目录

1、Struts2标签库

2、Struts2的OGNL标签

  1）OGNL中的集合(List/Map)

3、控制标签

4、数据标签

5、表单标签

  1）、表单标签的通用属性

  2）、表单标签的name和value属性

  3）、 checkboxlist标签

  4）、 doubleselect标签

6、非表单标签

1、Struts2标签库

Struts2可以将所有标签分成3类：

lUI标签：主要用于生成HTML元素的标签。

l非UI标签：主要用于数据库访问，逻辑控制等标签。

lAjax标签：用于Ajax支持的标签。

对于UI标签，则有可以分为两类：

表单标签：表单标签主要用与生成HTML页面的from元素，以及普通表单元素的标签。

非表单标签：非表单标签主要用于生成页面的树、Tab页等。

流程控制标签：主要包含用于实现分页、循环等流程的标签。

数据访问标签：主要包含用于输出ValueStack中的值，完成国际化等功能的标签。

Struts2标签库分类图：

2、Struts2的OGNL标签

OGNL是ObjectGraphic Navigation Language的缩写，它是一个开源项目。Struts2框架使用OGNL作为默认的表达式语言。

在传统的OGNL表达式求值中，系统会假设系统只要一个根对象，但Struts2的Stack Context需要多个“根”对象，其中ValueStacke只是多个“根”对象的其中之一。

假设：使用标签OGNL表达式求值，不是用Struts2的OGNL表达式是求之。如果系统的Context中包含两个对象：foo对象，它在Context中的名字为foo;bar对象, 并且它在Context中的名为bar。将foo对象设置成Context的根对象。

返回foo.getBlah()方法的返回值#foo.blah

返回bar.getBlah()方法的返回值#bar.blah

可以看出ONGL表达式的语法非正常简洁。

Struts2不知根据表达式从ValueStack中取的对象，还可以直接从对象中获取属性。Struts2提供了一个特殊的OGNL ProperAccessories(属性访问器)，它可以自动搜寻栈内的所有实体(从上到下)，直接找到求值表达式匹配的属性。

Struts2使用标准的Context来进行OGNL表达式求值，OGNl处理的顶级对象是一个Context，这个Context对象就是一个Map类型实例，在该OGNL的Context中，有一个对象，这个根对象就是OGNL ValueStack，如果需要访问ValueStack里的属性,例如：#取出Valuestack中的bar属性：${bar}；

除此之外：Struts2还提供了一些命名对象，这些命名对象与根对象无关，它们只是存在于Stack Context中。所以，访问这些对象实现需要使用#前缀来指明。

1、paramenters对象：用于访问HTTP请求参数，

2、request对象：用于访问HttpServletRequset的属性(Attribute)的Map。例如#request.userName

3、Session对象：用于访问HttpSession的属性。例如#session.userName

4、Application对象：用于访问ServletContext的属性。例如#application.userName

5、Attr对象：如果可以访问到，则访问PageContext，否则将依次搜索HttpServletRequset，HttpSession，ServletContext中的属性。

值得注意的是：当系统创建Action实例后，该Action实例已经被保存到ValueStack中，故无需书写#即可访问Action属性。

1）OGNL中的集合(List/Map)

直接生成一个List类型的集合，该List对象中包含三个元素，都个元素之间以英文逗号隔开；

例：<s:setname="list" value="{'song','li','xing'}" />

直接生成一个Map类型的集合，该Map对象中每个Key-value对象之间以英文冒号隔开：多项之间以英文逗号隔开。

例：<s:setname="foobar" value="#{'1':'song', '2':'li', '3':'xing'}" />

Set标签用于蒋某个值放入指定范围：

Scope：指定变量被放置的范围，该属性可以接受aplication、session、requset、page、action。如果该属性，则默认在OGNL Context中。

Value：赋给变量的值，如果没有设置该属性，则将ValueStack栈顶的值付给变量。

对于集合，OGNL提供了两个与元素：in和not in，其中in判断某个元素是否在指定集合中；not in则用于判断某个元素是否不在指定集合中。

in表达式：

<s:iftest="'foo' in {'foo','bar'}"> 在</s:if><s:else>不在</s:else>  

not in表达式：

<s:iftest="'foo' not in {'foo','bar'}">     不在  </s:if> <s:else>     在 </s:else>

OGNL还允许通过某个规则取得集合的自己，取得集合子集有三个操作符：

a、?:取出所有符合选择逻辑的元素

b、^:取出符合集合逻辑的第一个元素

c、$:取出符合选择逻辑的最后一个元素

例：<s:iterator value="books. {?#this.price >35}">      

<s:property value="title" /> - $<s:propertyvalue="price" /><br>

</s:iterator>

在上面代码中，直接在集合后紧跟.{}运算符表明用于取出该集合的子集，{}内的表达式用于获取符合集合的元素，this指的是为了从大集books刷选数据到小集合，需要对大集合books进行迭代，this代表当前迭代的元素。表达式用于获取集合中价格大于35的书的集合。

3、控制标签

Struts2的非UI标签包括控制标签和数据标签，主要用于完成流程控制，以及对ValueStack的控制，数据标签主要用于访问ValueStack中的数据；控制标签可以完成输出流程控制，例如分支，循环等操作，也可以对集合的合并，排列。

控制标签有：

1)、if：用于控制选择器输出的标签；

2)、else if: 与if标签结合使用，用于控制选择输出的标签；

3)、else:与if标签结合使用，用于控制选择输出的标签；

4)、append:将多个集合拼接成一个新的集合；

5)、generator：字符解析器，用于将一个字符串解析成一个集合；

6)、Iterator：这是一个迭代器，用于将集合迭代输出；

7)、merge：用于多个集合拼接陈一个新的集合。但与appernd的拼接方式有所不同。

8)、sort：用于对集合进行排序；

9)、Subset：截取集合的部分元素，形成新的子集；

If/elseif/else标签：

这三个标签都是用于进行分支控制的，他们都是用于根据一个Boolean表达式的值，来确定是否计算、输出标签体的内容。

例：<s:set name="age" value="21" />

<s:if test="#age==23">23</s:if><s:elseif test="#age==21">21</s:elseif><s:else> 都不等</s:else>

iterator标签：

用于对集合进行迭代，这里集合包含List、Set和数组，也可对Map类型的对象进行迭代输出。Value、id、Status三个属性都是可选属性，如果没有指定value属性，则使用ValueStack栈顶的集合。

例：

<s:iterator var="u"value="users" status="sts">

   <s:property value="#sts"/>

   <s:property value="#u"/><br/>

</s:iterator>

如果为<s:iterator/>标签指定status属性，即每次迭代时都会有一个IteratorStatus实例，该实例的方法包含如下几个：

2Int getCount():返回当前迭代了几个元素；

2Int getIndex():返回当前元素的索引；

2Boolean isEven(): 当前元素的索引是否是偶数；

2Boolean isFirst()：当前元素是否是第一个元素；

2Boolean isLast()：当前元素是否是最后一个元素；

2Boolean isOdd()：当前元素的索引是否是奇数；

append标签：

用于将多个集合拼接起来，组成一个新的集合，通过阵中的拼接，从而允许通过一个<s:iterator …./>标签就完成对多个集合的迭代。

merge标签的用法看起来很像append标签，也是用于将多个集合拼接成一个集合但是采用的拼接方式与append不同，append是以集合位顺序的拼接，merge是以元素位顺序拼接；

generator标签：

指定字符串按指定分隔符分隔成多个子串，临时生成多个子串可以使用iterator标签来迭代输出。可以理解我generator将一个字符串转化成一个集合，在该标签的标签体内，整个临时生成的集合将位于Valuestack的顶端，但一旦该标签结束，该集合将被移除Valuestack。

属性有：

count：指定生成集合中元素的总数；

separator：指定用于解析字符串的分隔符；

val：指定被解析的字符串；

converter：制定一个转化器，该转化器负责将集合中的每个字符串转化成对象；

id：可选属性，制定了该属性，则将生成的集合放在pageContext属性中；

Subset标签：

用于取得集合的子集，该标签的底层通过org.apache.Struts2.util.Subset.IteratorFilter类提供实现。属性有：

count：指定生成集合中元素的总数，如果不指定该属性，默认取得源集合的全部元素。还有source，start，decider属性；

subset标签生成的子集放在ValueStack的栈顶，如果该标签结束后，该标签生成的子集将被移除出ValueStack栈。

Sort标签：

指定集合元素进行排序，进行排序是=时，必须提供自己的排序规则，即使实现自己的Comparator，自己的Comparator需要实现java.util.Comparator接口。属性有：

Comparator：该属性指定进行排序的Comparator实例；

source：该属性指定排序的集合。如果不指定该属性，则对ValueStack栈顶的集合进行排序。

4、数据标签

数据标签主要用于提供各种数据范文相关的功能，包含显示一个Action里的属性，以及生成国际化输出等功能，数据标签主要包含：action，bean，date，debug，i18n，include，param，push，set，text，url，property；

1） action:用于直接在JSP页面直接调用一个Action，通过指定executeResult参数，还可以将该Action的处理结果包含到本页面中来。如果指定了executeResult参数的属性值为true，该标签还会把Action的处理结果包含到本页面中来。属性有：

2id：该属性会作为该Action的应用ID

2name：指定该标签调用哪个Action

2nameSpace：指定该标签调用的Action所在的namespace

2executeResult：该是属性指定是否要将action 的处理结果页面包含到本页面。默认值为false，即不包含。

2ignoreContextParams：指定该页面中的参数是否需要转入调用Action，该参数的默认值是false，即将本页面的请求参数传入被调用的Action。

2）bean：用于创建一个JavaBEan实例，如果指定id属性，则可以将创建的JavaBean实例放入StackContext中。属性：

name：指定要实例化的JavaBean的实现类；

id：该属性是个可选属性，指定该属性后该实例JavaBean实例会被放入到Stack Context中(并不是ValueStack) ，从而允许直接通过该id属性来访问该JavaBean实例；

3）date：用于格式化输出一个日期。属性有：

format：根据该属性指定的格式来个事化日期；

nice：该属性只能为true或false，它用于指定是否输出指定日期和当前时刻之间的时差

name指定要格式化的日期值；

id：制定引用该元素的id值。

4）debug：主要用于辅助调试，在页面上生成一个调试链接，通过该链接到ValueStack和Stack Context中的所有的值信息；

例：<s:debug />

5）i18n：用于制定国际化资源的文件的baseName

6）include：用于JSP页面中包含其他的JSP或Servlet资源，属性：

value：指定需要被包含的JSP页面或者Servlet；

id指定该标签的ID引用

例：<s:includevalue=”include-file.jsp”>

<s:param name=”author” value=”yeeku”/>

</s:inlcude>

7）  param：通常用作bean标签，url标签的子标签，属性：

Name：指定需要设置参数的参数名；

value：指定需要设置参数的参数值；

id：指定引用该元素的ID。

例：<s:param name=”color”>blue</param>

或<s:paramname=”color” value=”blue”/>

8）push：用于将某个值放到ValueStack的栈顶。属性有：

value：该属性指定需要放到ValueStack栈顶的值；

id：指定引用该元素的ID

例：<s:pushvalue=”#p”>

<s:property value=”name”/><br>

</s:push>

9）set：用于设置一个新变量，并可以将新变量放入到指定的范围内，属性有

name：重新生成的新变量的名字；

scope：可选属性，指定新变量被放置的范围，属性值有application、session、requset、page、action，没有指定属性，则默认为放置到Stack Context中；

value：指定将赋值给变量的值，如果没有制定该属性，则将ValueStack栈顶的支付给行变量；

id：指定该元素的引用ID。

例：<s:set value=”#p” name=”xxx”/>

10）text：用于输出国际化消息

11）url：用于生一个URL地址，属性有：

includeParams该属性指定包含的参数，属性值只能为none，get，all；

scheme用于设置scheme属性；

value指定生成URL的地址值，如果value不提供就有action属性指定的Action作为URL地址；

action指定生成URL的地址为那个Action，如果不提供，就用valuezuoweiURL的地址值namespace/method；

encode指定是否需要encode指定是否需要encode请求属性；includeContext：指定是否需要将上下文包含在URL地址中；anchor指定URL的锚点id;

12）property：用于生成输出某个值，包括输出ValueStack，Stack，Context和Action Context中得值。属性：

default如果需要输出的属性值为null，则显示的default属性指定的值；

espcape指定是否escapeHTML代码；

value 到指定需要输出的属性值，如果没有指定该属性，则默认输出ValueStack栈顶的值；

id指定该元素的标识。

5、表单标签

Struts2的表单标签，可分为两种：form表单本身和单个表单元素的标签。Form标签本身的行为不同于表单元素的标签。Struts2的表单元素标签都包含了非常多的属性，但有很多属性完全是通用的。

1）、表单标签的通用属性

所有表单标签处理类都继承了UIBean类，UIBean包含了一些通用属性，分为3种：

2模板相关属性

2JavaScript相关属性

2通用属性

除此之外，所有表单元素标签都存在一个特殊属性：form,通过该属性可以实现表单元素和表单之间的交互。例如，我们可以通过${parameters.form.id}来取得表单元素所在表单的ID。

下面是表单标签的通用属性。

模板相关的通用属性如下：

2templateDir：指定该表单所用的模板文件目录。

2theme：指定该表单所用的主题

2template：指定该表单所用的模板

JavaScript相关的通用属性如下：

2onclick：指定鼠标在该标签生成的表单元素上单击时触发的JavaScript函数。

2ondbclick：指定鼠标在该标签生成的表单元素上双击时触发的JavaScript函数。

2onmousedown：指定鼠标在该标签生成的表单元素上按下时触发的JavaScript函数。

2onmouseup：指定鼠标在该标签生成的表单元素上松开时触发的JavaScript函数。

2onmouseover：指定鼠标在该标签生成的表单元素上悬停时触发的JavaScript函数。

2onmouseout：指定鼠标移除该标签生成的表单元素时触发的函数。

2onfocus：指定该标签生成的表单元素得到焦点时触发的函数。

2onblur：指定该标签生成的表单元素失去焦点时触发的函数。

2onkeypress：指定单击键盘上某个键时触发的函数。

2onkeyup：指定松开键盘上某个键时触发的函数。

2onkeydown：指定按下键盘上某个键时触发的函数。

2onselect：对下拉列表项等可以选择表单的元素，指定选中该元素时触发的JavaScript函数。

2onchange：对于文本框等可以接受输入的表单元素，指定当值改变时触发的javaScript函数。

因为Html本身的限制，并不是每个Html元素都可以触发以上的所有函数。因此，上面的属性并不是对Struts2 的每个标签都有效。

Struts2还允许为表单元素设置提示，单鼠标在这些元素上停悬时，系统将出现提示。Struts2将这种特性称为Tooltip。相关的通用属性如下：

2tooltip：设置此组件的Tooltip。

2tooltipIcon：设置Tooltip图标的URL路径。

2tooltipAboveMousePointer：是否在光标位置上显示Toopltip。也可以通过设置tooltipOffseY属性，设置Tooltip与光标位置的垂直位移。

2tooltipBgColor：设置Tooltip的背景色。

2tooltipBgImg：设置Tooltip的背景图片。

2tooltipBorderWidth：设置Tooltip边框的宽度

2）、表单标签的name和value属性

Name和value属性之间存在一个独特的关系：因为表单元素的name属性会映射到Action的属性当对应的Action已经被实例化，且对应属性有值时，表单元素会显示出该属性的值，该值就是表单元素的value值。

3）、 checkboxlist标签

checkboxlist标签可以一次创建多个复选框，要根据list属性指定的集合。还有两个常用的属性。

a、 listKey：该属性指定集合元素中的某个属性作为复选框的value值

b、 listValue：该属性指定集合元素中的某个属性作为复选框的标签。

4）、 doubleselect标签

doubleselect标签会生成一个级联列表框（会生成两个下拉列表框），当选第一个列表框时，第二个的内容也会随之改变。常用属性如下：

2list：指定用于输出第一个下拉列表框中选项的集合

2listKey：该属性指定集合元素中的某个属性作为复选框的value值

2listValue：该属性指定集合元素中的某个属性作为复选框的标签。

2doubleList：指定用于输出的第一个下拉列表框中选项的集合

2doubleList key：该属性指定集合元素中的某个属性作为复选框的value值

2doubleList Value：该属性指定集合元素中的某个属性作为复选框的标签。

2doubleName：指定第二个下拉列表框的name属性。

5）、 head标签

6）、optiontransferseselect标签

7）、 select标签

8）、 radio标签

9）、 optgroup标签

10）、 token标签

11）、 updownselect标签

6、非表单标签

1）、 actionerror和actionmessage标签

2）、 component标签

3）、 tree和treenode