`
forlab
  • 浏览: 129210 次
  • 性别: Icon_minigender_1
  • 来自: 北京
社区版块
存档分类
最新评论

Structs - HTML、Bean、Logic、Template和Nested标签库总结、心得和使用详

 
阅读更多


标签库
说明
HTML 标签 用来创建能够和Struts 框架和其他相应的HTML 标签交互的HTML 输入表单
Bean 标签 在访问JavaBeans 及其属性，以及定义一个新的bean 时使用
Logic 标签 管理条件产生的输出和对象集产生的循环
Template 标签 随着Tiles框架包的出现，此标记已开始减少使用
Nested 标签 增强对其他的Struts 标签的嵌套使用的能力



标签的公共特征

使用固定属性名称的Struts 标签：

属性
说明
id 命名自定义标签创建时的脚本变量名。
name 指出关键字值，在该关键字下可以找到一个存在的bean 。如果给出了scope属性，则仅仅在scope中查找。否则，根据标准的顺序在各种scope中查找：(page, request, session, or application)。
property 指出bean 中的某个属性，可以在其中检索值。如果没有标明，则使用对象本身的值。
scope 定义了Bean在哪个范围(page, request, session, or application)中被查找。如果没有标明按顺序查找。脚本变量(见id)将在相同的范围中创建。



Struts 标签也支持嵌套引用，例如：

Property="foo.bar.baz"

这相当于进行下面的调用：
getFoo().getBar().getBaz()；

或者做为setter：
getFoo().getBar().setBaz(value)；



虽然Struts 标签的设计原意是为了避免使用scriptlet，scriptlet的表达式还能够提供给所有的Struts 标签使用。但请确保使用完整的表达式:

错误：
<html:link href="'<%= "/" + name %>/index.jsp>'>

正确：
<html:link href="'<%= "/" + name + "/index.jsp" %>'>    // 表达式必须提供整个属性值




Html 标签库

  1. <html>标签
    它有两个属性：locale和xhtml，两者都不是必需的。

    <html:html locale=\"true\">

    此行代码解析后：
    <html lang=\"en\">
    说明：生成的结果取决于Struts应用程序所位于的服务器的locale。如果你将应用程序部署到一个不同locale的服务器，你不需要改变代码，Locale会自动调整。  
  2. <base>标签：表示所包含页面的绝对位置。这个标签只有内嵌在head标签中才有效。

    <html:base/>

    此行代码解析后：
    <base href=\"http://www.mymain.com/myStrutsApp/testing.jsp\">

  3. <img>标签
    最重要的属性page：图象文件的路径，前面必须带有一个斜线。
    其它属性：heignt、width、alt。
      <html:img page=\"/logo.gif\" height=\"50\"  width=\"200\" alt=\"Web Logo\"/>
  4. <link>标签

    <html:link page=\"/index.html\">Click demo</html:link>

    此行代码解析后：
      <a href=\"/index.html\">Click demo</a>
  5. <errors>标签：通过一个简单的<html:errors/>标签，你就可以在一个JSP页面上显示完全自定义的错误信息。功能超强大！！
    说明：这个标签在Request对象的属性集合中查找reserved key。如果它找到一个reserved key，它就假设这个key是一个String、或是一个String数组  
            （它包含在模块的MessageResources中查找的message keys）、或是类型为org.apache.struts.action.ActionErrors的一个对象。
              如果在应用程序资源中存在相应的信息，那么就可以用下面这些可选的message keys：  
             · errors.header  or  errors.prefix：相应的信息在错误信息的单独列表前显示。 
             · errors.footer or  errors.suffix：相应的信息在错误信息的单独列表后显示。  
  6. <form>标签系列
    使用<form>标签时必须遵循一些规则：  标签中必须包含一个action属性，它是这个标签中唯一必需的属性。如果不具备该属性则JSP页面会抛出一个异常。之后你必须给这个action属性指定一个有效值。一个有效值是指应用程序的Struts配置文件中元素里的任何一个子元素的访问路径。而且相应的元素中必须有一个name属性，它的值是form bean的名称。

    <html:form action=\"/login\" > 

    如果你有上述一个标签 ，那么你的Struts配置文件的元素中必须有一个如下显示为粗体的元素： 
    <action-mappings> 
         <action path=\"/login\" 
          type=\"com.javapro.struts.LoginAction\"  
          name=\"loginForm\"
          scope=\"request\"
          input=\"/login.jsp\">
          <forward name=\"success\" path=\"/mainMenu.jsp\"/>
        </action>
        .
        .
        .
    </action-mappings>  // 这就是说一个form标签是和form bean相关联的。


  7. 任何包含在<form>中用来接收用户输入的标签（<text>、<password>、<hidden>、<textarea>、<radio>、<checkbox>、<select>）必须在相关的form bean中有一个指定的属性值。比如，如果你有一个属性值被指定为“username”的<text>标签，那么相关的form bean中也必须有一个名为“username”的属性。输入<text>标签中的值会被用于生成form bean的userName属性。



<form>标签还有一些不是必须但很有用的“次要”属性。
比如，你可以用focus属性来生成JavaScript，它会“定焦”（focus）到该form所包含的一个元素上。使用focus属性时你需要给它指定元素的名称。

<body>
<html:form action=\"/login\" focus=\"password\">
User Name: <html:text property=\"userName\"/>
<br>Password: <html:text property=\"password\"/>
<br><html:submit/>
</html:form>
</body>

代码解析后：
<body>
<form name=\"loginForm\" method=\"post\"  action=\"/myStrutsApp/login.do\">
User Name: <input type=\"text\" name=\"userName\"  value=\"\">
<br>Password: <input type=\"text\"  name=\"password\" value=\"\">
<br><input type=\"submit\"   value=\"Submit\">
</form>
<script language=\"JavaScript\"  type=\"text/javascript\">
  <!--
  if (document.forms[\"loginForm\"].elements[\"password\"].type != \"hidden\") 
       document.forms[\"loginForm\"].elements[\"password\"].focus()
  // -->
</script>

</body>

有没有看到这个标签库是如何建立JavaScript来定焦到password元素上的? 这也是该库让人着迷的地方之一。你不用担心如何在客户端进行编程，它会帮你自动生成。
还可以看到，<form>标签中method属性的缺省值是POST。

<text>标签、<hidden>标签、<textarea>标签、<radio>标签、<checkbox>标签、<submit>标签、<reset>标签：
都有一个property属性，最后会被转换成HTML中的name属性，当然还有name和value属性。

<password>标签

  <html:password property=\"password\"  redisplay=\"false\"/>

该标签中的一个很重要的属性是"redisplay"，它用于重新显示以前输入到这个区域中的值。该属性的缺省值为true。然而，为了使password不能被重新显示，你或许希望将该属性的值设为false。

<select>标签和<option>标签：   

<html:select property=\"color\" size=\"3\">
  <html:option value=\"r\">red</html:option>
  <html:option value= \"g\">green</html:option>
  <html:option value= \"b\">blue</html:option>
</html:select>



Logic 标签库 
        此标签库可以分为三种类型：条件、循环、转发/重定向。

一.) 条件类型

  1. logic:empty和logic:notEmpty
    logic:empty标签判断脚本变量是否为null，是否是一个空的字符串(长度为0)，是否是一个空的collection或map(调用isEmpty()方法来判断)。logic:notEmpty标签类似。
    <logic:empty name="myBean">
       The bean is missing
    </logic:empty>
    <logic:notEmpty name="myBean">
       The bean is not missing
    </logic:notEmpty>
    上段代码表示当一个名为myBean的bean在所有的scope中都不存在时，输出The bean is missing；存在的话输出The bean is not missing。
    此标签有三个属性：name、property和scope。
  2. logic:equal, logic:notEqual, logic:lessThan, logic:greaterThan,logic:lessEqual, and logic:greaterEqual
    这堆logic:*equal*标签从名字上就能知道意思，它们使用起来有些笨拙。
    有如下属性：name、property、scope、value、cookie、header、parameter。
    <logic:equal name="bean" property="doubleProperty" value="<%= doub1 %>">
        equal
    </logic:equal>
    <logic:greaterEqual name="bean" property="doubleProperty" value="<%= doub1 %>">
        greaterEqual
    </logic:greaterEqual>
  3. logic:present和logic:notPresent
    检查header、request parameter、cookie、JavaBean或JavaBean propertie是否存在且不等于null。另外还可以检查当前用户的身份，使用属性user和role。
    其它的属性有：name、property、scope、cookie、header、parameter。
    <logic:notPresent name="myBean"  property="prop"  scope="page">
    The bean property bean.prop is present
    </logic:notPresent>
    上段代码检查在page作用域内名为myBean的bean是否有一个prop属性。
  4. logic:match和logic:notMatch
    比较两字符串是否相等，可以比较字符串的开始的、结尾的或其中的某个部分。
    location属性：指定从某个位置开始进行比较。
    其它的属性有：name、property、scope、value、cookie、header、parameter。
    下面的例子是检查浏览器类型：
    <logic:match header="User-Agent" value="Mozilla">
      Mozilla!
    </logic:match>
    <logic:notMatch header="User-Agent" value="Mozilla">
      Not Mozilla :(
    </logic:notMatch>

    检查bean属性是否匹配"hello world"字符串：
    <logic:match name="bean" property="stringProperty" value="hello world">
      Hello World!
    </logic:match>
    <logic:notMatch name="bean" property="stringProperty" value="hello world">
      I'm so sad and lonely.
    </logic:notMatch>

    检查名为"name"的请求参数是否是"xyz"的子字符串，但是子字符串必须从"xyz"的索引位置1开始(也就是说子字符串必须是"y"或"yz")：
    <logic:match parameter="name"  value="xyz"  location="1">
          The parameter name is a sub-string of the string xyz from index 1
    </logic:match>


二.) 循环类型


logic:iterate
重复嵌套在此标签体内的指定集合的元素，集合必须为如下类型：array 、Collection(包括ArrayList和Vector）、Enumeration、Iterator、Map(包括HashMap、Hashtable和TreeMap)。例如：
<logic:iterate id="employee" name="department" property="employees" scope= "request">
…
<bean:write name="employee" property="username" />
…
<bean:write name="employee" property="name" />
…
<bean:write name="employee" property="phone" />
…
</logic:iterate>
上面的代码迭代了一个employee的集合，是department属性employees的一个集合，作用域为request。

为了输出第五个到第十个employee，需要使用length和offset属性：
<logic:iterate id="employee" name="department" property="employees" scope= "request" length="10" offset="5">
…
<bean:write name="employee" property="username" />
…
<bean:write name="employee" property="name" />
…
<bean:write name="employee" property="phone" />
…
</logic:iterate>

你可以定义一个变量保存当前的索引值：       
<ol>
<logic:iterate id="element" name="bean" property="stringArray" indexId="index">
<li>
<em>
<bean:write name="element"/>
</em> 
[<bean:write name="index"/>]</li>
</logic:iterate>
</ol>


三.) 转发/重定向类型


logic:forward和logic:redirect
logic:forward标签和jsp:forward标签和相似，但它可以使用global forward中的一个ActionForward：  
<logic:forward name="login" />
----------------------------------------------------------------------------------------------------------------------------------
与上面相关的global forward中的代码：
<global-forwards>
<forward name="login" path="/loginForm.jsp"/>
</global-forwards>

logic:redirect标签和上面的标签类似，但它默认调用的方法是response.sendRedirect()，取代了上面的requestDispatcher.forward()。最大的不同是它支持所有html:link标签的属性，所以你能够指定request参数：
<logic:redirect name="login" paramId="employeeId" paramName="employee" property="id" />

提示：1.) 在MVC框架下，不推荐使用这两个标签，你应该是从controller中选择下一个view，而不是从view中选择。
           2.) 在Jsp页面中不要过多的使用logic标签。



Structs - 标签库（Bean）- -


                                       

Bean 标签库
        此标签库和Java Bean有很强的关联性，设计的本意是要在JSP 和JavaBean 之间提供一个接口。Struts 提供了一套小巧有用的标签库来操纵JavaBean和相关的对象：cookie、 header、 parameter、 define、write、message、 include、page、resource、size、struts。
  1. bean:cookie、bean:header、bean:parameter
    这三个标签用来重新得到cookie, request header和request parameter。
    bean:header和bean:parameter标签定义了一个字符串；bean:cookie标签定义了一个Cookie对象。你可以使用value属性做为默认值。如果找不到指定的值，且默认值没有设定的话，会抛出一个request time异常。如果你期望返回多个值的话，可把multiple属性设为true。

    <bean:cookie id="sessionID" name="JSESSIONID" value="JSESSIONID-ISUNDEFINED"/>
    // 这段代码定义了一个名为sessionID的脚本变量，如果找不到一个名为JSESSIONID的cookie，那sessionID 
    // 的值就被设置为JSESSIONID-ISUNDEFINED。

    下面代码会输出一些Cookie对象的一些属性：
    <jsp:getProperty name="sessionID " property="comment"/> …
    <jsp:getProperty name="sessionID" property="domain"/> …
    <jsp:getProperty name="sessionID" property="maxAge"/> …
    <jsp:getProperty name="sessionID" property="path"/> …
    <jsp:getProperty name="sessionID" property="value"/> …
    <jsp:getProperty name="sessionID" property="version"/> …

    下面是在request中输出所有header的例子：  
    <%
            java.util.Enumeration names =((HttpServletRequest) request).getHeaderNames();
    %>
    …
    <%
            while (names.hasMoreElements()) {
            String name = (String) names.nextElement();
    %>
    <bean:header id="head" name="<%= name %>"/>
    … <%= name %>
    … <%= head %>
    …
    <%
            }
    %>

    下面是parameter的例子：

    <bean:parameter id="param1" name="param1"/>
    <bean:parameter id="param2" name="param2" multiple="true"/>  // 此处定义了一个param2[]。
    <bean:parameter id="param3" name="param3" value="UNKNOWN VALUE"/>

    于其它标签结合使用：

    <bean:header id="browser" name="User-Agent"/>
    <P>You are viewing this page with: <bean:write name="browser"/></P>
    ----------------------------------------------------------------------------------------------------------------------------------
    <bean:cookie id="username" name="UserName" scope="session"
    value="New User" />
    <P>Welcome <bean:write name="username" property="value"/!</P> 
      // 根据cookie创建一个新的Bean，如果用户名称已经存储在cookie中，它就不显示为一个新用户。

  2. bean:define：有三个用途。
    一是定义新字符串常量：

    <bean:define id="foo" value="This is a new String"/>
    <bean:define id="bar" value='<%= "Hello, " + user.getName() %>'/>
    <bean:define id="last" scope="session" value='<%= request.getRequestURI() %>'/>


    二是复制一个现有的bean给新的bean：

    <bean:define id="foo" name="bar"/>    
    <bean:define id="baz" name="bop" type="com.mycompany.MyClass"/>  //定义脚本变量的类型，默认为Object

    三是复制一个现有的bean的属性给新的bean：

    <bean:define id="bop" name="user" property="role[3].name"/>
      <bean:define id="foo" name="bar" property="baz" scope="request"  toScope="session"/> 
      //toScope属性指新bean的scope，默认为page  
    上段代码的意思是把名为bar的bean的baz属性赋值给foo，foo的类型为String(默认)。


  3. bean:include
    这个标签和bean:include标签和相似，不同点就是它定义了一个可以复用的脚本变量。用id属性命名一个新的脚本变量，还支持forward、href、page和transaction.属性，和html:link中的属性意义一样。
    <bean:include id="footerSpacer"  page="/long/path/footerSpacer.jsp"/> 
    然后你能够在多个地方(scope为page)调用：
    <bean:write name="footerSpacer" />



  4. bean:message
    用来实现对国际化的支持的一个标签，配合java.util数据包中定义的Locale和ResourceBundle类来完成这个任务，用java.text.MessageFormat类配置消息的格式。
        首先要指定资源文件的名称。这个文件会包含用默认语言编写的在程序中会出现的所有消息，这些消息以“关键字-值”的形式存储。文件需要存储在类路径下，路径要作为初始化参数传送给ActionServlet。
        实现国际化的规定：所有的资源文件必须都存储在基本资源文件所在的目录中。基本资源文件包含的是用默认地区语言-本地语言编写的消息。如果基本资源文件的名称是ApplicationResources.properties，那么用其他特定语言编写的资源文件的名称就应该是ApplicationResources_xx.properties(xx为ISO编码，如英语是en)。因此这些文件应包含相同的关键字，但关键字的值是用特定语言编写的。
        然后，ActionServlet的区域初始化参数必须与一个true值一起传送，这样ActionServlet就会在用户会话中的Action.LOCALE_KEY关键字下存储一个特定用户计算机的区域对象。现在可以运行一个国际化的web站点，它可以根据用户计算机上的设置的区域自动以相应的语言显示。

    使用特定的字符串来替换部分消息：
    在资源文件中的定义：info.myKey = The numbers entered are {0},{1},{2},{3}
    标记的使用：<bean:message key="info.myKey" arg0="5" arg1="6" arg2="7" arg3="8"/>
    Jsp页面的显示：The numbers entered are 5,6,7,8  // 最多支持4个参数



  5. bean:page：把Jsp中的内部对象做为脚本变量。
    <bean:page id="requestObj" property="request"/>



  6. bean:resource：获得应用程序的资源，这个资源可以是一个String或从java.io.InputStream中读入。使用ServletContext.getResource()ServletContext.getResourceAsStream() 方法检索web应用中的资源，如果在检索资源时发生问题，就会产生一个ruquest time异常。
    <bean:resource id="webxml" name="/WEB-INF/web.xml"/>
    使用input属性时，资源会做为一个InputStream，如果不指定就被当成一个String。



  7. bean:size：得到存储在array、collection或map中的数目，类型为java.lang.Integer。
    <bean:size id="count" name="employees" />



  8. bean:struts：复制Struct 对象(三种类型)给新的bean，scope为page。
    <bean:struts id="form" formBean="CustomerForm"/>    
    <bean:struts id="fwd" forward="success"/>
    <bean:struts id="map" mapping="/saveCustomer"/>



  9. bean:write：以字符串形式输出bean的属性值。
    filter属性：设为true时，将HTML保留字转换为实体("<" 转换为 &lt);
    ignore属性：如果对象不存在，不会抛出异常。
    <bean:write name="userRegistration" property="email" scope="request"/>
分享到：
| Java Web笔记 – Servlet中的Filter过滤器 ...
评论
发表评论

您还没有登录,请您登录后再发表评论

相关推荐

Magicbox
Global site tag (gtag.js) - Google Analytics