`

struts标签库

 
阅读更多
  1. Struts2 标签库概述
    • Struts2 标签库的组成
    • Struts2 框架的标签库可以分为以下三类:
      • 用户界面标签 (UI 标签 ) :主要用来生成 HTML 元素的标签。
        • 表单标签:主要用于生成 HTML 页面的 FORM 元素,以及普通表单元素的标签。
        • 非表单标签:主要用于生成页面上的 tree , Tab 页等。
      • 非用户界面标签 ( 非 UI 标签 ) :主要用于数据访问,逻辑控制。
        • 数据访问标签:主要包含用于输出值栈 (ValueStack) 中的值,完成国际化等功能的标签。
        • 流程控制标签:主要包含用于实现分支,循环等流程控制的标签。
      • AJAX 标签 : 用于支持 Ajax 效果
  2. Struts2 标签库
    • 在早期的 WEB 开发中, JSP 视图控制和显示技术主要依靠 Java 脚本来实现,这样一来, JSP 页面重新嵌入了大量的 Java 脚本代码,给开发带来了极大的不方便。
    • 从 JSP1.1 规范后, JSP 增加了自定义标签库的支持。标签库是一种组件技术,通过标签库,可以将复杂的 Java 脚本代码封装在组件中,开发者只需要使用简单的代码就可以实现复杂的 Java 脚本功能。提供了 Java 脚本的复用性,提高了开发者的开发效率。
    • Struts2 标签库相对 struts1.x 进行了巨大的改进,支持 OGNL 表达式,不再依赖任何表现层技术。
  3. Struts2 标签的使用
    • 我们可以在 struts2-core-2.0.11.jar 压缩文件的 META-INF 目录下找到 struts-tags.tld 文件,这个文件里定义了 Struts2 的标签。
    • 要在 jsp 中使用 Struts2 的标志,先要指明标志的引入。通过 jsp 的代码的顶部加入以下的代码:
    • <%@taglib prefix=&quot;s&quot; uri=&quot;/struts-tags&quot; %>
  4. Struts2 标签语法 ( 一 )
    • Struts2 的标签都支持动态数据的访问,标签的属性都可以使用 OGNL 表达式, struts2 标签的属性具有类型,这些类型可以简单地分为字符串类型和非字符串类型,对于字符串类型的属性,如果要访问动态数据,需要使用 %{… } 这样的语法,
      • 例如: <s:include value=“%{ url }” />
    • Include 标签的 value 属性是字符串类型, Struts2 将对这个属性进行解析,查找符合 %{…} 样式的字符串,然后将花括号之间的内容作为 OGNL 表达式进行求值。如果属性中没有 %{…} 样式的字符串,那么属性的值将被直接看成是字符串数据。
      • 例如: <s:include value=“urlTag.action” />
    • 对于非字符串类型的属性值,将直接作为 OGNL 表达式进行求值。
      • 例如: <s:property value=“username”/>
    • property 标签的 value 属性是 Object 类型,它的值 username 将作为 OGNL 表达式进行求值,结果是值栈中位于栈顶的对象的 username 属性的值。如果要为非字符串类型的属性直接指定字符串数据,那么需要使用 OGNL 中的字符串常量,即用单引号(‘)或双引号(“)将字符串括起来。
      • 例如: <s:property value=“’zhangsan‘”/>
      • value 属性的值‘ zhangsan’ 作为字符串常量,计算结果就是 zhangsan ,因此输出 zhangsan 。
  5. Struts2 标签语法 ( 二 )
    • 除上述用法之外,也可以使用 %{…} 这样的语法来指定字符串常量。
    • 例如: <s:property value=“%{ ‘zhangsan’ }”/>
    • 在这种情况下, %{ } 将被忽略,花括号中的内容将作为表达式被计算。
    • 总结一下, struts2 标签的属性按照下列的三个规则进行计算。
      • (1) 所有的字符串属性类型都会解析“ %{…}” 这样的语法。
      • (2) 所有的非字符属性类型都不会被解析,而是直接被看作一个 OGNL 表达式进行求值
      • (3) 对于第二个规则的例外情况是,如果非字符串属性使用了“ %{…}” 语法,那么 %{…} 将被忽略,花括号中的内容将作为表达式计算。
    • 如果大家在使用标签时, 忘记了某个属性是字符串类型,还是非字符串类型,那么有一个简单的方法,那就是不考虑它是什么类型,统一使用“ %{…}” 语法。
  6. Struts2 通用标签
    • Struts2 中通用标签可以分为二类:控制标签和数据标签 。控制标签用于呈现页面时控制执行流程,数据标签用于访问值栈中的数据。
    • 数据标签: 用于访问 ActionContext 和值栈中的数据。数据标签包括:
      • property set push param bean action include
      • url a i18n text date debug
    • 控制标签: 用于在呈现结果页面时控制程序的执行流程,根据程序执行的状态输出不同的结果,控制标签包括下列标签:
      • if/elseif/else iterator append merge
      • generator subset sort
  7. 数据标签 -----property 标签
    • property 标签用于输出值栈中的对象的属性 (property) 值,使用 value 属性来指定要输出的对象属性,如果没有指定 value 属性,那么默认输出栈顶对象。
            • property 标签属性
    • 在前面的章节中,我们已经使用过了 property 标签,我们再看一个例子:
    • <s:property value=“username” default=“ 游客” />
    • 取出栈顶对象 ( 通常是 action) 的 username 属性并输出,如果没有找到 username 属性,那么输出”游客”。
  8. 数据标签 -----set 标签
    • Set 标签将一个值赋给指定范围内变量。 Set 标签在某些情况下是比较有用的,例如在页面中多次引用一个复杂的表达式,我们可以将这个表达式赋给一个变量,然后直接引用变量。带来的好处就是:
      • 提升了性能 ( 表达式的计算只有一次 )
      • 提高了代码的可读性。
            • set 标签属性
    • Set 标签以 name 属性的值作为键 (key) ,将 value 属性的值保存到指定的范围对象中。属性 scope 取值中的 page,request,session,application 同 JSP 的 4 种范围,如果指定了 action 范围 ( 默认值 ) , value 属性的值将被同时保存到 request 范围和 OgnlContext 中。
  9. 示例:访问地址: http://localhost:8080/.../setTag.action
  10. 数据标签 -----push 标签
    • push 标签用于把一个值压入值栈 ( 位于栈顶 ) ,注意和 set 标签的区别, set 标签是将值放到 action 上下文中。当 push 标签结束后, push 标签放入值栈中的对象将被删除,换句话说,要访问 push 标签压入栈中的对象,需要在标签内部去访问。
            • push 标签的属性
    public class User { private String username; private String email; private String sex; 省略 set/get 方法 }
  11. Push 标签示例 访问: http://localhost:8080/...../pushTag.action
  12. 数据标签 -----param 标签
    • param 标签被用作其他标签的子标签,用于为其他标签提供参数,例如:为 bean 标签和 include 标签提供参数。
            • param 标签的属性
    • 当使用 param 标签时, 参数的值可以通过 value 属性给出,也可以在标签体中给出 ( 开始标签和结束标签之间的文本 ) 。这二种用法有一些区别。我们看下面的例子:
    • <param name=“color”>blue</param> <!-- (1) -->
    • <param name=“color” value=“blue” /> <!-- (2) -->
    • 在第 (1) 种情形中,参数值将作为 java.lang.String 对象 ( 即字符串 ) 被放入栈中;
    • 在第 (2) 种情形中,参数值将作为表达式进行计算,如果 blue 不存在,则 color 参数的值为 null 。
    • 在第 (1) 种情形中,要为 color 指定字符串值,可以写为:
    • <param name=“color” value=“ ‘ blue ‘ ”/> 或者 <param name=“color” value=“%{‘ blue ‘ }“/>
    • 使用单引号包围字符串,表明这是一个字符串常量
  13. 数据标签 -----bean 标签
    • bean 标签用于实例化一个 JavaBean 对象 ( 必须遵照 JavaBean 规范 ) , bean 标签的标签体内可以包含多个 param 标签,用于设置 Bean 的属性 ( 必须有相应的 setter 方法 ) 。如果指定了 id 属性,则创建的 Bean 实例将被放入到 OgnlContext 中。
            • bean 标签的属性
    • 注意:
      • id 属性是可选的,无论是否指定 id 属性, bean 标签创建的 JavaBean 实例都会被压入到值栈的顶部,在 bean 标签内部可以直接访问创建的对象,无须使用” #” 标记,当 bean 标签结束的时候, bean 标签创建的实例将从值栈中删除。
      • 如果指定了 id 属性,那么 bean 标签创建的 JavaBean 实例还将被放到 OgnlContext 中,这样在 bean 标签的外部,也可以访问创建的对象了,不过此时就要使用” #” 标记了。
  14. bean 标签示例
  15. bean 标签示例说明
    • 在没有指定 id 属性的情况下,创建的 User 对象只被压入值栈,在 bean 标签的内部使用 property 标签可以直接访问 User 对象的属性。在 bean 标签外部,由于值栈中的 User 对象已被删除,所以无法访问到 User 对象的属性了。
    • 在指定了 id 属性的情况下,创建的 User 对象除了被放到值栈中外,还被放到 action 上下文中,因此在标签的内部和外部都可以访问 User 对象属性,只不过在标签外部访问时需要添加 #user 前缀 ,
    • 访问路径: http://localhost:8080/..../beanTag.action
    • 通过指定 action 的名字和可选的名称空间, action 标签允许你在 JSP 中直接调用 action 。如果将标签的 excuteResult 属性设为 true, 那么 action 对应的结果输出也将被包含到本页面中。
    • 在 action 标签的标签体中可以嵌套 param 标签,向 action 传递参数。
            • action 标签的属性
    数据标签 -----action 标签
    • 如果指定了 id 属性,则 action 将被放到 OgnlContext 中,在 action 标签结束后,可以通过 #id 来引用 action.
  16. ActionTagAction.java actionTagSuccess.jsp
  17. actionTag.jsp
  18. 示例说明
    • 在第一个 action 标签调用中,执行了结果,但没有设置 ActiontagAction 的 username 和 email 属性,所以结果页面中的这两项输出为空。
    • 在第二个 action 标签调用中,不执行结果,调用 ActionTagAction 的 doDefault() 方法,在这个方法中,我们在请求对象中设置了 greeting 属性,在页面中使用 property 标签,通过表达式 #attr.greeting 来获取 greeting 属性。
    • 在第三个 action 标签调用中,执行了结果,并通过 param 标签设置了 ActionTagAction 的 username 和 email 属性,在结果页面中通过 property 标签输出这两个属性的值。
    • 访问路径: http://localhost:8080/....actionTag.jsp
  19. 数据标签 -----include 标签
    • include 标签类似于 JSP 的 <jsp:include> 标签,用于包含一个 Servlet 或 JSP 页面。 include 标签的标签体内可以包含多个 param 标签,用于向被包含的页面传递请求参数
    • include 标签的属性
  20. include 标签示例说明
    • 在 jsp2.jsp 中,我们使用 JSP 的 EL 表达式来获取传的请求参数。注意:在 include 标签内部使用 param 标签向被包含的页面传递的请求参数, 不能使用如下的 property 标签来访问: <s:property value=“#parameters.username” />
    • #parameters 引用的实质是一个 Map 对象,并不等同于 HttpServletRequest 对象。
    • 在包含页面时,如果页面中有中文,将会出现乱码,要解决这个问题,可以在 struts.xml 文件中配置 struts.i18n.encoding 属性,如下:
      • <constant name=“struts.i18n.encoding” value=“gbk” />
    • 访问路径: http://localhost:8080/.../includeTag.jsp
  21. 数据标签 -----i18n 和 text 标签
    • i18n 和 text 标签用于对国际化提供支持 .i18n 标签用于将一个资源包放入值栈, text 标签用于从资源包中获取消息。例如
      • <s:i18n name=“ApplicationResources”>
      • <s:text name=“title”/>
      • </s:i18n>
    • i18n 标签将基名为 ApplicationResources 的资源包放入到值栈中, text 标签从资源包中获取键为 title 的文本消息。
    • 注意: i18n 标签放入值栈的资源包只能在 i18n 标签的标签体内访问,一旦 i18n 标签结束,值栈中的资源包将被删除。
    • text 标签也可以单独使用,在这种情况下,它将首先查找资源包的基名与调用的 Action 类名相同的资源包。这意味着你可以在 Action 类所在的包中创建与 Action 类名相同的资源文件,例如:在 com.ibm.action 包中有一个名为 LoginAction 的类, 你可以在 com.ibm.action 包括中创建名为 LoginAction.properties 、 LoginAction_zh.properties 、 LoginAction_en.properties 等资源文件 ( 名字中的 LoginAction 部分称为基名 ) ,当执行完 LoginAction 后,在转向的结果页面中使用单独的 text 标签获取本地化的文本消息,那么 text 标签将从 com.ibm.action.LoginAction_xx.properties( 根据当前的语言环境选择某个资源文件 ) 中读取 name 属性值对应的文本消息。
  22. 数据标签 -----i18n 和 text 标签
    • 如果找不到与 Action 类名相同的资源包,那么就从默认资源包中获取消息;如果默认资源包不存在,或者默认资源包中也没有找到对应的消息,那么 text 标签的标签体内容将作为默认消息被输出;如果没有标签体,那么 name 属性的值将直接被输出。
    • text 标签内部还可以使用嵌套的 param 标签,来指定消息文本中的参数, param 标签的顺序对应了消息文本中参数的索引顺序。
            • i18n 标签的属性
            • text 标签的属性
  23. i18n 和 text 标签示例
    • 第一步
    • 在项目的 src 下新建包: com.ibm.action, 在这个包中新建 TextTagAction 类,继承自 ActionSupport 类,注意:你的 Action 类一定要继承 ActionSupport 类,因为 ActionSupport 类对国际化提供了支持,这样 text 标签才能访问到资源包的基名与你的 Action 类名相同的资源包。
    • TextAction 类没有任何代码,这主要是因为 ActionSupport 基类已经实现了 execute() 方法,该方法返回 Action.SUCCESS, 这就足够了,我们编写 TextAction 类的目的是为了通过这个 Action 来访问使用了 text 标签的结果页面。
  24. i18n 和 text 标签示例
    • 第二步
    • 在 com.ibm.action 包中新建 TextTagAction.properties, 内容如下:
      • username= lisi
      • email= lisi @163. com
      • now=Now is {0} . {1} , welcome you.
      • 键为 now 的消息有两个参数,分别用 {0} 和 {1} 来表示。
    • 第三步
    • 新建 ApplicationResources.properties, 内容如下:
      • username=zhangsan
      • email=zhangsan@sina.com
  25. i18n 和 text 标签示例
    • 第四步
  26. 数据标签 -----date 标签
    • date 标签用于格式化输出日期值,也可用于输出当前日期值与指定日期值之间的时差
    • date 标签的属性
    • 注意:
    • 1 、 format 属性用于指定日期的格式化样式,具体的样式规则可以参看 java.text.SimpleDateFormat 类的 API 文档。
    • 2 、将 nice 属性设为 true ,可以输出指定日期值和当前日期值之间的时差,此时 format 属性失效,也就是说,当 nice 属性为 true 时,即使你指定了 format 属性,它也不会起作用
    • 3 、如果没有使用 nice 属性,也没有指定 format 属性,那么 date 标签将会在国际化资源包中查找 struts.date.format 键,并以这个键的值作为日期的格式化样式;如果这个键不存在,那么默认将会使用 DateFormat.MEDIUM 格式化样式。
    • 4 、如果找不到 name 属性指定的 Date 对象,那么将返回空。
  27. date 标签示例
    • 第一步
    • 在 ApplicationResources.properties 文件中添加 struts.date.format 键
    • struts.date.format=yyyy/MM/dd hh:mm:ss
    • 第二步、
    • 可以使用 struts2 的 struts.custom.i18n.resources 属性来设置默认的资源包,编辑 struts.xml 文件,使用 constant 元素来配置 struts.custom.i18n.resources 属性,内容如下
    • <constant name=“struts.custom.i18n.resources” value=“ApplicationResources”/>
  28. 测试: http://localhost:8080/...../dateTag.jsp
    • 第三步
  29. 控制标签
    • 控制标签用于完成流程控制,例如分支,循环等操作。控制标签包含下面几个:
      • if: 用于控制选择输出。
      • elseif: 同 if 标签结合使用,用来控制选择输出。
      • else: 同 if 标签结合使用,用来控制选择输出。
      • append: 用来将多个集合拼接为一个新的集合。
      • generator: 为一个字符串解析器,用来将一个字符串解析为一个集合。
      • iterator: 迭代器,用来迭代输出集合数据。
      • merge: 用来将多个集合拼接为一个新的集合 , 同 append 有所区别。
      • sort: 用来对集合排序。
      • subset :用来截取集合的部分集合,开成新的集合子集合。
  30. 控制标签 -----if/elseif/else 标签
    • if/elseif 标签属性 test: 为必填属性,是一个 Boolean 类型值,决定是否显示 if 标签内容。该标签标准格式如下:
        • <s:if test=“ 表达式” >
        • …… ..
        • </s:if>
        • <s:elseif test=“ 表达式” >
        • …… ..
        • </s:elseif>
        • <s:else>
        • ……… ..
        • </s:else>
  31. 控制标签 ----- if/elseif/else 标签举例
    • <%@ taglib prefix=&quot;s&quot; uri=&quot;/struts-tags&quot;%>
    • <!-- 定义一个 testname 属性 -->
    • <s:set name=&quot;testname&quot; value=&quot;%{'Java'}&quot; />
    • <!-- 使用 if 标签判断 -->
    • <s:if test=&quot;%{#testname=='Java'}&quot;>
    • <div>
    • <s:property value=&quot;%{# testname}&quot; />
    • </div>
    • </s:if>
    • <s:elseif test=&quot;%{#testname=='Jav'}&quot;>
    • <div>
    • <s:property value=&quot;%{# testname}&quot; />
    • </div>
    • </s:elseif>
    • <s:else>
    • <div>
    • testname 不是“ Java”
    • </div>
    • </s:else>
  32. 控制标签 ----- if/elseif/else 标签举例
      • <%@ taglib prefix=&quot;s&quot; uri=&quot;/struts-tags&quot;%>
      • <s:set name=&quot;age&quot; value=&quot;61&quot;/>
      • <s:if test=&quot;${age > 60}&quot;>
      • 老年人
      • </s:if>
      • <s:elseif test=&quot;${age > 35}&quot;>
      • 中年人
      • </s:elseif>
      • <s:elseif test=&quot;${age > 15}&quot; id=&quot;wawa&quot;>
      • 青年人
      • </s:elseif>
      • <s:else>
      • 少年
      • </s:else>
  33. 控制标签 ----- if/elseif/else 标签举例
      • <%@ taglib prefix=&quot;s&quot; uri=&quot;/struts-tags&quot;%>
      • <s:set name=&quot;name&quot; value=&quot;<%=&quot;'&quot;+ request.getParameter(&quot;name&quot;)+&quot;'&quot; %>&quot;/>
      • <%
      • System.out.println(request.getParameter(&quot;name&quot;));
      • %>
      • <s:if test=&quot;#name=='zhaosoft'&quot;>
      • zhaosoft here
      • </s:if>
      • <s:elseif test=&quot;#name=='zxl'&quot;>
      • zxl here
      • </s:elseif>
      • <s:else>
      • other is here
      • </s:else>
  34. 控制标签 ----- iterator (迭代标签)
    • Iterator (迭代)
    • 描述:用于遍历集合( java.util.Collection ) List,Map, 数组或枚举值 (java.util.iterator) 。该标签的属性如下表:
  35. IteratorStauts 实例包含方法
    • int getCount(): 返回当前迭代过元素的总数。
    • int getIndex(): 返回当前迭代元素的索引。
    • boolean isEven(): 判断当前迭元素是否为偶数。
    • boolean isOdd(): 判断当前迭元素是否为奇数。
    • boolean isFirst(): 判断当前迭元素是否为第一个元素。
    • boolean isLast(): 判断当前迭元素是否为最后一个元素
    • IteratorStauts 的这些方法分别对应了 count,index,even,odd,first,last 属性
  36. 控制标签 ----- iterator 标签示例
  37. 控制标签 ----- iterator (迭代标签)举例
      • <s:iterator value =&quot;{' 第一个元素 ',' 第二个元素 '}&quot; >
      • <p>day is: <s:property/></p>
      • </s:iterator>
      • private List myList;
      • private Map myMap;
      • public String execute() throws Exception {
      • myList = new ArrayList();
      • myList.add(&quot; 第一个元素 &quot;);
      • myList.add(&quot; 第二个元素 &quot;);
      • myList.add(&quot; 第三个元素 &quot;);
      • myMap = new HashMap();
      • myMap.put(&quot;key1&quot;, &quot; 第一个元素 &quot;);
      • myMap.put(&quot;key2&quot;, &quot; 第二个元素 &quot;);
      • myMap.put(&quot;key3&quot;, &quot; 第三个元素 &quot;);
      • return SUCCESS ;
      • }
      • 省略生成 setter/getter 方法
      • <table>
      • <s:iterator value=&quot;{' 第一个元素 ',' 第二个元素 '}&quot; status=&quot;st&quot;>
      • <tr>
      • <td><s:property value=&quot;#st.getIndex()&quot; /></td>
      • <td><s:property /></td>
      • </tr>
      • </s:iterator>
      • </table>
      • <h2> 显示 List 属性 </h2>
      • <table>
      • <s:iterator value=&quot;myList&quot; status=&quot;st&quot;>
      • <tr>
      • <td><s:property value=&quot;#st.getIndex()&quot; /></td>
      • <td><s:property /></td>
      • </tr>
      • </s:iterator>
      • </table>
      • <h2> 显示 Map</h2>
      • <table>
      • <s:iterator value=&quot;#{'key1':' 第一个元素 ','key2':' 第二个元素 '}&quot; status=&quot;st&quot;>
      • <tr>
      • <td><s:property value=&quot;#st.getIndex()&quot; /></td>
      • <td><s:property /></td>
      • </tr>
      • </s:iterator>
      • </table>
      • <h2> 显示 Map 属性 </h2>
      • <table>
      • <s:iterator value=&quot;myMap&quot; status=&quot;st&quot;>
      • <tr>
      • <td><s:property value=&quot;#st.getIndex()&quot; /></td>
      • <td><s:property /></td>
      • </tr>
      • </s:iterator>
      • </table>
  38. 控制标签 ----- append 标签
    • append: 用来将多个集合拼接为一个新的集合。这样拼接的目的就是可以将多个集合使用一个 <iterator /> 标签完成迭代。标签属性 id: 指定了集合元素的 ID 。
    • private List myList1, myList2;
    • private Map myMap1, myMap2;
    • public String execute() throws Exception {
    • myList1 = new ArrayList();
    • myList2 = new ArrayList();
    • myList1.add(&quot; 第一个集合 # 第一个元素 &quot;);
    • myList1.add(&quot; 第一个集合 # 第二个元素 &quot;);
    • myList1.add(&quot; 第一个集合 # 第三个元素 &quot;);
    • myList2.add(&quot; 第二个集合 # 第一个元素 &quot;);
    • myList2.add(&quot; 第二个集合 # 第二个元素 &quot;);
    • myList2.add(&quot; 第二个集合 # 第三个元素 &quot;);
    • myMap1 = new HashMap(); myMap2 = new HashMap();
    • myMap1.put(&quot;key1&quot;, &quot; 第一个集合 # 第一个元素 &quot;);
    • myMap1.put(&quot;key2&quot;, &quot; 第一个集合 # 第二个元素 &quot;);
    • myMap1.put(&quot;key3&quot;, &quot; 第一个集合 # 第三个元素 &quot;);
    • myMap2.put(&quot;key1&quot;, &quot; 第二个集合 # 第一个元素 &quot;);
    • myMap2.put(&quot;key2&quot;, &quot; 第二个集合 # 第二个元素 &quot;);
    • myMap2.put(&quot;key3&quot;, &quot; 第二个集合 # 第三个元素 &quot;);
    • return SUCCESS;
    • } // 省略 setter/getter 方法
    • <h1><span style=&quot;background-color: #FFFFcc&quot;>Append 标签示例 </span></h1>
    • <h2> 拼接 List 属性 </h2>
    • <table>
    • <s:append id=&quot;newList&quot;>
    • <s:param value=&quot;myList1&quot; />
    • <s:param value=&quot;myList2&quot; />
    • </s:append>
    • <s:iterator value=&quot;#newList&quot; id=&quot;name&quot; status=&quot;st&quot;>
    • <tr>
    • <td><s:property value=&quot;#st.getIndex()&quot; /></td>
    • <td><s:property /></td>
    • </tr>
    • </s:iterator>
    • </table>
    • <h2> 拼接 Map 属性 </h2>
    • <table>
    • <s:append id=&quot;newMap&quot;>
    • <s:param value=&quot;myMap1&quot; />
    • <s:param value=&quot;myMap2&quot; />
    • </s:append>
    • <s:iterator value=&quot;#newMap&quot; status=&quot;st&quot;>
    • <tr>
    • <td><s:property value=&quot;#st.getIndex()&quot; /></td>
    • <td><s:property /></td>
    • </tr>
    • </s:iterator>
    • </table>
  39. 控制标签 ----- generator 标签
    • generator 标签用来将指定的字符串按规定的分隔符分解为多个子字符串,生成的多个子字符串可以使用 iterator 标签输出。
    • 该标签的属性如下:
      • id: 指定了集合元素的 ID 。
      • count :可选属性,为一个 Integer 类型值,指定生成集合中元素的总数。
      • separator: 必填属性,为一个 String 类型值,指定用来分解字符串的分隔符。
      • val :必填属性,为一个 String 类型值,指定被分解的字符串。
      • converter :可选属性,为一个 Converter 类型实例,指定一个转换器,该转换器负责将集合中的每个字符串转换为对象。
  40. 控制标签 ----- generator 标签举例
    • private String msg;
    • public String getMsg() {
    • return msg;
    • }
    • public void setMsg(String msg) {
    • this.msg = msg;
    • }
    • public String execute() throws Exception {
    • setMsg(&quot; 第一个元素 ; 第二个元素 ; 第三个元素 &quot;);
    • return SUCCESS;
    • }
  41. 控制标签 ----- generator 标签举例
    • <h1>
    • <span style=&quot;background-color: #FFFFCC&quot;>Generator 标签示例 </span>
    • </h1>
    • <table>
    • <s:generator separator=&quot;;&quot; val=&quot;msg&quot; id=&quot;temp&quot; count=&quot;2&quot;></s:generator>
    • <s:iterator status=&quot;st&quot; value=&quot;#attr.temp&quot;>
    • <tr>
    • <td><s:property value=&quot;#st.getIndex()&quot; /></td>
    • <td><s:property /></td>
    • </tr>
    • </s:iterator>
    • </table>
    • 注意:如果在 generator 标签中指定了 count 属性,则该集合中最多只能有 count 个元素,多余的元素将会被忽略。
  42. 控制标签 ----- append 标签
    • append: 用来将多个集合拼接为一个新的集合。
  43. 控制标签 ----- merge 标签
    • Merge 标签用于合并迭代器,其用法与 append 相似,区别就是对合并后的迭代器中的元素迭代的顺序不一样。
  44. 控制标签 ----- subset 标签
    • Subset 标签用于截取一个迭代器的子集,其内部实现是通过 org.apache.struts2.util.SubsetIteratorFilter 类来完成的。
  45. Subset 标签示例
  46. subset 标签示例
    • 除了上面的用法之外,还可以使用 subset 属性指定一个 Decider ,用于过滤某些元素。要编写一个 Decider 类,需要实现 org.apache.struts2.util.SubsetIteratorFilter.Decider 接口,该接口只有一个方法, public boolean decide(Object element) throw Exception, 如果该方法返回 true ,表明参数 element 表示的元素应该被包含到子集中。
    • 我们编写一个 Decider 类,选取集合中含有“ java” 子串的元素,代码如下:
    首先使用 bean 标签实例化 MyDecider 对象,并将这个对象放入到 OgnlContext 中。在 subset 标签的 decider 属性中,通过 OGNL 表达式 #myDecider 来引用 MyDecider 对象。
  47. 控制标签 ----- sort 标签
    • Sort 标签根据 comparator 属性指定的比较器对集合进行排序,并将排序后的迭代器压入值栈的栈顶。在 sort 标签的内部,你可以使用 iterator 标签取出栈顶的迭代器对排序后的元素进行迭代。当 sort 标签结束时,栈顶的迭代器将被删除。
  48. sort 标签示例
  49. 表单标签
    • Struts2 的表单标签可以分为两类, form 标签本身和包装 HTML 表单元素的其他标签。 form 标签本身的行为不同于它内部的元素。
    • Struts2 表单标签包括下列标签:
      • form textfield password radio checkbox checkboxlist select
      • doubleselect combobox optiontransferselect optgroup updownselect
      • textarea hidden file label reset submit token head
  50. 表单标签
  51. 表单标签的 name 和 value 属性
    • 很多表单标签( form 标签除外)的 name 属性和 value 属性之间存在一个独特的关系。 name 属性除了为 HTML 表单元素指定名字,在表单提交时作为请求参数的名字外,同时它还映射到 Action 的属性。
    • 在大多数情况下, name 属性映射到一个简单的 JavaBean 属性,例如 name 属性的值为” postalCode”, 在表单提交后, struts2 框架将会调用 Action 的 setPostalCode() 方法来设置属性。
    • 有的时候你希望在表单元素中显示 Action 属性的数据,这时就轮到 value 属性登场了,为 value 属性指定表达式” %{postalCode}”, 这将会调用 Action 的 getPostalCode() 方法,并在表单中显示返回的数据,之后, 用户可以编辑这个值,然后重新提交它。
  52. form 标签
    • form 标签输出一个 HTML 输入表单,此外, xhtml 主题的 form 标签还输出表单元素外围的表格。
    • 1) 通常情况下,当前输出表单的请求和提交表单的请求属于同一个命名空间。例如:请求 /admin/updateCategory!default.action 输出的表单,命名空间会被假设为 /admin ,因此在使用 form 标签时,可以不使用 namespace 属性。如下:
      • <s:form action=“updateCategory” >
      • 如果输出表单的请求和提交表单的请求分属于不同的名称空间,那么可以通过
      • namespace 属性指定处理表单提交的 action 所属的名称空间。
    • 2) 若通过 action 的一个非 execute 方法输出表单,然后将表单提交给 action 默认的 execute 方法执行,那么 form 标签的 action 属性可以忽略。例如:对于下面的表单:
      • <s:form >
      • <s:textfield name=“username” label=“ 用户名” />
      • <s:submit />
      • </s:form>
      • 当访问 /register!default.action 时, 输出上表单, form 标签会自动将 action 属性设为
      • register ,这样在表单提交后就会执行 action 的 execute 方法。
    • 3)method 和 enctype 是 HTML form 标签的属性。
    • 4) 当使用验证框架时,将 form 标签的 validate 属性设为 true ,将自动生成客户端的 JavaScript 验证代码。
    • <s:form action=“register” method=“post” />
    • struts2 默认的主题是 xhtml, 上述代码在客户端浏览器中的输出如下:
    • <s:form id=“register” onsubmit=“return true” action=“register” method=“post”>
    • <table class=“wwFormTable”></table>
    • </s:form>
    • 可以看到 form 标签内部输出了一个 table 元素。
  53. textfield 标签
    • textfield 标签输出一个 HTML 单行文本输入控件,等价于 HTML 代码: <input type=“text” …/>
    • 看下面的代码:
      • <s:form action=“register” method=“post”>
      • <s:textfield name=“username” label=“ 用户名” />
      • </s:form>
  54. password 标签
    • password 标签输出一个 HTML 口令输入控件,等价于 HTML 代码: <input type=“password” ../>
    • 例子: <s:password name=“password” label=“ 密码” />
  55. textarea 标签
    • textarea 标签输出一个 HTML 多行文本输入控件,等价于 HTML 代码: <textarea …./>.
    • 例子:
    • <s:textarea name=“personal” cols=“30” rows=“5” label=“ 个人简历” />
  56. select 标签
    • select 标签输出一个 HTML 列表框,等价于 HTML 代码:
    • <select …><option..></option></select>
  57. select 标签示例
    • 示例一:
      • <s:form>
      • <s:select label=“ 最高学历” name=“education” list=“{‘ 高中’,‘大学’,‘硕士’ }” />
      • </s:form>
      • 在 select 标签的 list 属性中直接使用 OGNL 表达式创建了一个列表,列表中的每一项都将作为 HTML 列表框的一个选项。
    • 示例二:
      • <s:form>
      • <s:select label=“ 最高学历” name=“education” list=“#{1:‘ 高中’, 2:‘ 大学’, 3:‘ 硕士’ }” />
      • </s:form>
      • 在 select 标签的 list 属性中直接使用 OGNL 表达式创建了一个 Map 。在这里要注意的是, Map 的 key 是作为列表框选项的值,而 Map 中的 value 是作为列表框选项的内容。
  58. select 标签示例
    • 示例三:
      • <s:form>
      • <s:select label=“ 最高学历” name=“education” list=“{‘ 高中’,‘大学’,‘硕士’ }” headerKey=“-1” headerValue=“ 请选择你的学历” />
      • Header 选项主要用来越提示作用,因此应该将 header 选项的值 ( 通过 headerKey 属性设置 ) 设为无意义的值,例如此处的 -1.
    • 示例四:
      • <s:form>
      • <s:select label=“ 最高学历” name=“education” list=“{‘ 高中’,‘大学’,‘硕士’ }” headerKey=“-1” headerValue=“ 请选择你的学历” emptyOption=“true” multiple=“true” / >
    • 使用 emptyOption 属性在 header 选项后添加一个空的选项。
    • multiple 属性设为 false ,则只能从下拉列表中选择一个选项,如果设为 true ,则可以多选。
  59. optgroup 标签
    • optgroup 标签作为 select 标签的子标签使用,用于创建选项组。你可以在 select 标签的标签体中使用一个或者多个 optgroup 标签,对选项进行逻辑分组。注意, optgroup 标签本身不能嵌套。
    • 例子:
    • <%@ taglib prefix=“s” uri=“/struts-tags” %>
    • <s:form>
    • <s:select label= &quot; 选择图书 &quot; name= &quot;book&quot; list=&quot;#{1:'JAVA 核心编程 ',2:' 深入 struts2 学习 '}&quot; >
    • <s:optgroup label= &quot;C/C++ 图书 &quot; list=&quot;#{3:'VC++ 编程详解 ',4:'Spring 详解 '}&quot;/>
    • <s:optgroup label= &quot;Oracle 图书 &quot; list=&quot;#{5:'Oracle 基础 ',6:'DBA 入门 '}&quot;/>
    • </s:select>
    • </s:form>
  60. optgroup 标签注意
    • optgroup 标签的 label 属性指定选项组的组名。 optgroup 标签对应的模板需要使用 listKey 和 listValue 属性的值,因此你要么为 list 属性指定一个 Map 类型的值 ( 此时, listKey 默认为 Map.Entry 的 key , listValue 默认为 Map.Entry 的 value) ,要么为 list 属性指定一个对象列表,然后使用 listKey 和 listValue 属性指定对象的属性作为选项的值和内容。
  61. radio 标签
    • radio 标签输出一组 HTML 单选按钮,等价于一组 HTML 代码: <input type=“radio” …/>
    • 例子:
      • <%@ taglib prefix= &quot;s&quot; uri= &quot;/struts-tags&quot; %>
      • <s:form>
      • <s:radio name= &quot;user.sex&quot; value= &quot;1&quot; list=&quot;#{1 : ' 男 ', 0 : ' 女 '}&quot; label= &quot; 性别 &quot; />
      • </s:form>
  62. checkbox 标签
    • checkbox 标签输出一个 HTML 复选框,等价于代码: <input type=“checkbox”…/>
    • checkbox 标签创建一个 value 属性为 true 或者为 false 的复选框。你可以通过 checkbox 标签的 fieldValue 属性来指定创建的 HTML 复选框 value 属性的值。我们看下面的代码:
    • <s:checkbox name=“user.username” label=“ 是否显示 Email” fieldValue=“true” />
    • 复选框的值是 true 还是 false ,是由 fieldValue 属性来控制的,而不是由通常的 value 属性来设置的。
    • 注意,除非你知道你要做什么,否则不要将 fieldValue 属性设置为 false 。将 fieldValue 属性设置为 false 可能会导致一些问题。 HTML 规范规定,复选框只有在选中时才会被提交,在通常的 Servlet/JSP 处理过程中,我们可以通过判断复选框的 name 属性所指定的请求参数是否存在来获知用户是否选中了复选框,如果选中,则取出它的值。然而,在使用 struts2 框架时,这一切发生了一些微妙的变化。如果将 fieldValue 属性设置为 false ,那么复选框的值将是 false 。当没有选中复选框时,提交的请求参数中不会有复选框对应的请求参数。不过,虽然 struts2 框架没有接收到这个请求参数,但它仍然会将复选框对应的 action 属性的值设为 false 。于是你就会看到一个奇怪的现象,那就是不管你是否选中复选框,对应的 action 属性的值都是 false.
  63. checkboxlist 标签
    • checkboxlist 标签使用一个列表创建一系列复选框,属性设置与 <s:select/> 和 <s:radio/> 类似,只是创建的是 HTML 复选框。不同的是, checkboxlist 标签是多选标签。
    • 示例:
      • <s:form>
      • <s:checkboxlist name= &quot;interest&quot; list= &quot;{' 足球 ',' 篮球 ',' 排球 ',' 游泳 '}&quot; label= &quot; 兴趣爱好 &quot; />
      • </s:form>
  64. hidden 标签
    • hidden 标签输出一个 HTML 隐藏表单元素,等价于 HTML 代码: <input type=“hidden”…/>. 在 xhtml 主题下, hidden 标签与其它的标签不太一样, hidden 标签并不输出表行。 xhtml 主题直接从 simple 主题继承了 hidden.ftl 模板。除了公共属性外, hidden 标签没有特有的属性。
    • 示例:
      • <s:hidden name=“id” value=“5” />
  65. submit 标签
    • submit 标签输出一个提交按钮。 submit 标签和 form 标签一起使用可以提供异步表单提交功能。 submit 标签可以输出以下三种类型的提交按钮。
      • input: 等价于 HTML 代码 <input type=“submit”…>
      • image: 等价于 HTML 代码 <input type=“image”…>
      • button: 等价于 HTML 代码 <input type=“submit”…>
    • HTML 的 button 标签已经演进为可以分别指定提交的值 ( 通过 value 属性指定 ) 和按钮上显示的文本 ( 通过标签的内容来指定 ) ,但只能用于 IE6.0 以上版本的浏览器。
  66. submit 标签示例
    • 例 1 :指定 image 类型的提交按钮,使用 method 属性。
      • <s:submit type=“image” method=“login” src=“images/login.gif” />
      • 上述代码在客户端浏览器中的输出如下:
      • <input type=“image” src=“images/login.gif” name=“method:login” value=“Submit”…./>
      • 注意生成的 input 元素的 name 属性。
    • 例 2 :指定 button 类型的提交按钮,使用 action 和 method 属性。
      • <s:submit type=“button” action=“userManager” method=“login” label=“ 登录” />
      • 上述代码在客户端浏览器中的输出如下 :
      • <button type=“submit” name=“action:userManager!login” value=“submit” …/> 登录 </button>
      • 注意 button 标签的 name 属性。
      • 通过上面的例子可以看到 name 属性有二个前缀: method 和 action ,这是 struts2 提供的一种特性,即使用一些预定义的前缀来命名一个按钮,通过按钮的名字来改变执行的行为。 Struts2 定义了 4 个前缀,如下:
      • method-------method:login
      • action--------action:userManager
      • redirect------redirect:cancel.jsp
      • redirection-action------redirect-action:register
  67. method 前缀
    • 使用 method 前缀,来取代 action 默认的 execute() 方法的执行。例如一个表单同时用于用户注册和登录,那么可以编写代码如下:
    • <s:form action=“userManager”>
      • <s:textfield label=“ 用户名” name=“user.username” />
      • <s:password label=“ 密码” name=“user.password” />
      • <s:submit value=“ 登录” name=“method:login” />
      • <s:submit value=“ 注册” name=“method:reg” />
      • </s:form>
      • 注意: 1) 对于 input 类型的提交按钮,不能通过 submit 标签的 label 属性来设置提交按钮上的文本,只能使用 value 属性。
      • 2) 可以在 submit 标签的 name 属性中直接使用 method 前缀,也可以像前面给出的例子中使用 submit 标签的 method 属性来指定处理请求的 action 方法。
  68. action 前缀
    • 使用 action 前缀,取代 form 标签指定的 action ,将请求导向到另外的 action 进行处理。
    • 示例:
    • <s:form action=“login”>
      • <s:textfield label=“ 用户名” name=“user.username” />
      • <s:password label=“ 密码” name=“user.password” />
      • <s:submit value=“ 登录” />
      • <s:submit value=“ 注册” name=“action:register” />
      • </form>
    • 如果用户已经注册,可以直接登录,否则单击注册按钮,转到注册页面。 action 前缀也可以和 struts2 的动态方法调用结合使用,例如: name=“action:userManager!register”.
  69. redirect 前缀
    • 使用 redirect 前缀将请求重定向到其他的 URL ,甚至可以是 Web 应用程序外部的 URL 。
    • 示例:
    • <s:form action=“login”>
      • <s:textfield label=“ 用户名” name=“user.username” />
      • <s:password label=“ 密码” name=“user.password” />
      • <s:submit value=“ 登录” />
      • <s:submit value=“ 注册” name=“redirect:www.163.com” />
      • </form>
  70. redirect-action 前缀
    • 使用 redirect-action 前缀将请求重定向到其他的 action 。在内部, struts2 使用 ServletRedirectResult 来执行这个任务。
    • 示例:
    • <s:form action=“login”>
      • <s:textfield label=“ 用户名” name=“user.username” />
      • <s:password label=“ 密码” name=“user.password” />
      • <s:submit value=“ 登录” />
      • <s:submit value=“ 注册” name=“redirect-action : register” />
      • </form>
  71. reset 标签
    • reset 标签输出一个重置按钮。 reset 标签与 form 标签一起使用,用来提供表单的重置。 reset 标签可以输出以下两种类型的重置按钮:
      • input: 等价于 HTML 代码 <input type=“reset”…>
      • button: 等价于 HTML 代码 <button type=“reset”…>
    • 示例
    • <s:reset value=“ 重置” />
    • <s:reset type=“button” label=“ 重置” />
    • 如果是类型为 input 的重置按钮,则只能通过 value 属性来设置重置按钮上的文本。
  72. label 标签
    • Xhtml 主题下的 label 标签输出两个 HTML 的 label 标签 (simple 主题下的 label 标签只输出一人 HTML label 标签 ) ,分别位于一行的两列,左边的 label 标签起提示作用,右列的 label 标签用于显示只读的 action 属性数据。
    • 示例
      • <s:label label=“ 用户名” name=“user.username” />
      • 如果 Action 实例已经创建,并且 user.username 有值,那么在表行的右列中将显示 user.username 的值。
  73. token 标签与 file 标签
    • token 标签输出两个隐藏的表单字段,用于防止表单的重复提交。要让 token 标签正常工作,需要启用 TokenInterceptor 或者 TokenSessionInterceptor 拦截器。
    • 示例: <s:token /> 具体使用后面章节讲解。
    • file 标签输出一个 HTML 文件选择框,等价于 HTML 代码: <input type=“file” …/>.
    • 示例:
      • <s:file name=“uploadFile” accept=“text / *” />
      • <s:file name=“anotherUploadFile” accept=“text/html,text/plain” />
      • 文件上传后面章节详解。
  74. 非表单标签
    • Struts2 的非表单标签包括下列标签:
      • component 、 a 、 actionerror 、 actionmessage 、 fielderror
    • component 标签使用特定的模板输出一个自定义的 UI 小部件 (widget) 。
    • a 标签创建一个 HTML 超链接,等价于 HTML 代码: <a href=“….” />.
    • a 标签虽然可以在 simple 、 xhtml 和其它主题中使用,但它实际上是为了更好地和 ajax 主题一起工作布置而设计的 .
    • a 标签有一个 String 类型的 href 属性,用于指定链接的 URL 。看下面的例子:
      • <s:a href=“register!default.action”> 重新注册 </s:a>
  75. actionerror 、 actionmessage 、 fielderror 标签
    • actionerror 、 actionmessage 、 fielderror 标签都是用于输出消息的 .
    • 不同的是 :
      • actionerror 标签输出 action 的错误消息,
      • actionmessage 标签输出 action 的一般消息,
      • fielderror 标签输出 action 字段的错误消息 .
    • actionerror 标签输出 action 的 actionErrors 属性 (property) 保存的错误消息, actionErrors 是一个 Collection 类型的属性;
    • actionmessage 标签输出 action 的 actionMessages 属性保存的消息, actionMessages 是一个 Collection 类型的属性;
    • fielderror 标签输出 action 的 fieldErrors 属性保存的字段错误消息, actionMessages 是一个 Map 类型的属性;
    • 对于 fielderror 标签,可以通过嵌套的 param 标签来指定输出特定字段的错误消息。
    • actionerror 、 actionmessage 、 fielderror 标签输出消息的布局依赖于使用的主题。
  76. 示例 : MessageAction .java
    • public class MessageAction extends ActionSupport
    • {
    • @Override
    • public String execute() throws Exception
    • {
    • // 添加 action 错误消息
    • addActionError(&quot;Action Error Message1&quot;);
    • addActionError(&quot;Action Error Message2&quot;);
    • // 添加 action 一般性消息
    • addActionMessage(&quot;Action Message1&quot;);
    • addActionMessage(&quot;Action Message2&quot;);
    • // 添加字段消息
    • addFieldError(&quot;field1&quot;,&quot;field1 error&quot;);
    • addFieldError(&quot;field2&quot;,&quot;field2 error&quot;);
    • return SUCCESS ;
    • }
    • }
  77. 示例 : message.jsp
    • <%@ page contentType= &quot;text/html;charset=GBK&quot; %>
    • <%@ taglib prefix= &quot;s&quot; uri= &quot;/struts-tags&quot; %>
    • <h3> 输出 action 的错误消息 </h3>
    • <s:actionerror/>
    • <h3> 输出 action 的一般性消息 </h3>
    • <s:actionmessage/>
    • <h3> 输出所有字段的错误消息 </h3>
    • <s:fielderror/>
    • <h3> 输出特定字段的错误消息 </h3>
    • <s:fielderror>
    • <s:param value= &quot;'field2'&quot; />
    • </s:fielderror>
分享到:
评论

相关推荐

Global site tag (gtag.js) - Google Analytics