Struts之HTML標籤庫詳解 (中文版)

Struts之HTML標籤庫詳解 (中文版)

Struts提供了五個標籤庫,即:HTMLBeanLogicTemplateNested

 標籤庫

 說明

 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 標籤的設計原意是爲了避免使用scriptletscriptlet的表達式還能夠提供給所有的Struts 標籤使用。但請確保使用完整的表達式:

 錯誤:
 <html:link href="'<%= "/" + name %>/index.jsp>'>
 
 
正確:
 <html:link href="'<%= "/" + name + "/index.jsp" %>'>    //
表達式必須提供整個屬性值

 

 

Html 標籤庫

1.        <html>標籤
它有兩個屬性:localexhtml,兩者都不是必需的。

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

 
此行代碼解析後:
 <html lang=/"en/">

2.        說明:生成的結果取決於Struts應用程序所位於的服務器的locale。如果你將應用程序部署到一個不同locale的服務器,你不需要改變代碼,Locale會自動調整。

3.        <base>標籤:表示所包含頁面的絕對位置。這個標籤只有內嵌在head標籤中才有效。

 <html:base/>

 
此行代碼解析後:
 <base href=/"http://www.mymain.com/myStrutsApp/testing.jsp/">

4.        <img>標籤
最重要的屬性page:圖象文件的路徑,前面必須帶有一個斜線。
其它屬性:heigntwidthalt

  <html:img page=/"/logo.gif/" height=/"50/"  width=/"200/" alt=/"Web Logo/"/>

5.        <link>標籤

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

 
此行代碼解析後:
  <a href=/"/index.html/">Click demo</a>

6.        <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
:相應的信息在錯誤信息的單獨列表後顯示。

7.        <form>標籤系列
使用<form>標籤時必須遵循一些規則:

1.        標籤中必須包含一個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相關聯的。

2.       

 

3.        任何包含在<form>中用來接收用戶輸入的標籤(<text><password><hidden><textarea><radio><checkbox><select>)必須在相關的form bean中有一個指定的屬性值。比如,如果你有一個屬性值被指定爲“username”<text>標籤,那麼相關的form bean中也必須有一個名爲“username”的屬性。輸入<text>標籤中的值會被用於生成form beanuserName屬性。


<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屬性,當然還有namevalue屬性。

<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>

遺補1.) <html:link>標籤

forward屬性:鏈接到一個global forward上;action屬性:鏈接到一個action mapping上;
href
屬性:這個鏈接會轉發給控制器,由控制器做決定;page屬性:一個相對的鏈接。

page屬性鏈接到action上:

  <html:link page="/html-link.do">
   Linking with the page attribute.
 </html:link>


注意,上面的代碼中你不必指定web的關聯。相反的,如果你使用href屬性,你就必須像下面所示指出web的關聯(這裏的關聯就是struts-exercise)

 <html:link href="/struts-exercise-taglib/html-link.do">
   Using Href
 </html:link>


很明顯,當你在相同的web應用程序中做鏈接是,它比page屬性更加好。你也能用href在不同的服務器上創建鏈接:

 <html:link href="http://otherserver/strutsTut/html-link.do">
  Using Href
 </html:link>


另一種鏈接到html-link.do的方法是用action屬性:

 <html:link action="/html-link">
  Using Action attribute
 </html:link>


你也可以以硬編碼的方式使用參數:

 <html:link page="/htmllink.do?doubleProp=3.3&amp;longProp=32">
   Double and long via hard coded changes
 </html:link>


或者使用paramId, paramName, and paramProperty屬性:

 <html:link page="/html-link.do" paramId="booleanProperty" paramName="testbean"
   paramProperty="nested.booleanProperty">
   Boolean via paramId, paramName, and paramValue
</html:link>


解析後的代碼:

 <a href="/struts-exercise-taglib/html-link.do?booleanProperty=false">
    Boolean via paramId, paramName, and paramValue
 </a>


另外,還能使用帶name屬性的Map來實現傳遞多個參數:

 <%
java.util.HashMap newValues = new java.util.HashMap();
newValues.put("floatProperty", new Float(444.0));
newValues.put("intProperty", new Integer(555));
newValues.put("stringArray", new String[]
{ "Value 1", "Value 2", "Value 3" });
pageContext.setAttribute("newValues", newValues);
%>
...
 <html:link action="/html-link" name="newValues">
    Float, int, and stringArray via name (Map)
 </html:link>


你也能夠鏈接到Map類型的action上,上面的代碼解析後的結果:

 <html:messages property="property2" message="true" id="msg" header="messages.header" footer="messages.footer">
 <tr><td><%= pageContext.getAttribute("msg") %></td></tr>
 </html:messages>

2.) selectoption標籤
<html:select>
的屬性:property-與ActionForm中的某個屬性對應;size-顯示option的數目;multiple-默認爲fales,表示不能多選,當設定爲true時,property對應的ActionForm的屬性必須爲數組。
<html:select property="name" size=6 multiple="true">
<html:option>
的屬性:keylocalbundle-指定Resource Bundle中的內容。
例如 <html:option value="color1">Orange</html:option>
<html:option value="color1" bundle="htmlselect.Colors" key="htmlselect.red"/>
它和配置文件中的<message-resources>元素的key屬性匹配 --> <message-resource parmeter="HtmlSelectColors" key="htmlselect.Colors"/>
<message-resource>
中配置的資源文件爲HtmlSelectColors.properties,相關內容爲 htmlselect.red=RED
<html:options>
標籤,提供了一組<option>元素,在<html:select>元素中可以包含多個<html:options>元素。非常靈活,可以取得集合或數組中的值。
1 <html:options collection="coll" property="value" labelProperty="label" /> 這指在coll的集合中存放了optionsvalue指實際能被提交的值,label是顯示給用戶的值。
2 <html:options property="value" labelProperty="label" /> collection屬性不被指定時,將使用表單相關的form beanform beanvalue屬性存放option valuelabel屬性值顯示給用戶。
3 <html:options name="valueBean" property="values" labelName="labelsBean" labelProperty="labels" /> 這個意思是value值存放在名爲valueBeanbeanvlaues屬性中,它是一個collectionlabel值也是同樣的意思。
<html:optionsCollection>
標籤,和<html:options>的用法很相似。
例如 <html:select property="custId"><html:optionsCollection property="customers" label="name" value="custId" /></html:select>
這個標籤和org.apache.structs.util.LabelValueBean結合的很好,如果把labelvalue都放到這個對象中,可以很簡單的這樣應用:
<html:select property="custId"><html:optionsCollection property="customers" /></html:select>

 
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章