Struts提供了五個标簽庫,即: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 标簽也支援嵌套引用,例如:
雖然Struts 标簽的設計原意是為了避免使用scriptlet,scriptlet的表達式還能夠提供給所有的Struts 标簽使用。但請確定使用完整的表達式:
Property="foo.bar.baz"
這相當于進行下面的調用:
getFoo().getBar().getBaz();
或者做為setter:
getFoo().getBar().setBaz(value);
Html 标簽庫
1. <html>标簽
它有兩個屬性:locale和xhtml,兩者都不是必需的。
錯誤:
<html:link href="'<%= "/" + name %>/index.jsp>'>
正确:
<html:link href="'<%= "/" + name + "/index.jsp" %>'> // 表達式必須提供整個屬性值
2. 說明:生成的結果取決于Struts應用程式所位于的伺服器的locale。如果你将應用程式部署到一個不同locale的伺服器,你不需要改變代碼,Locale會自動調整。
3. <base>标簽:表示所包含頁面的絕對位置。這個标簽隻有内嵌在head标簽中才有效。
4. <img>标簽
最重要的屬性page:圖象檔案的路徑,前面必須帶有一個斜線。
其它屬性:heignt、width、alt。
<html:html locale=\"true\">
此行代碼解析後:
<html lang=\"en\">
5. <link>标簽
<html:base/>
<base href=\"http://www.mymain.com/myStrutsApp/testing.jsp\">
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的名稱。
2.
3. 任何包含在<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屬性時你需要給它指定元素的名稱。
<html:img page=\"/logo.gif\" height=\"50\" width=\"200\" alt=\"Web Logo\"/>
有沒有看到這個标簽庫是如何建立JavaScript來定焦到password元素上的? 這也是該庫讓人着迷的地方之一。你不用擔心如何在用戶端進行程式設計,它會幫你自動生成。
還可以看到,<form>标簽中method屬性的預設值是POST。
<text>标簽、<hidden>标簽、<textarea>标簽、<radio>标簽、<checkbox>标簽、<submit>标簽、<reset>标簽:
都有一個property屬性,最後會被轉換成HTML中的name屬性,當然還有name和value屬性。
<password>标簽
<html:link page=\"/index.html\">Click demo</html:link>
<a href=\"/index.html\">Click demo</a>
該标簽中的一個很重要的屬性是"redisplay",它用于重新顯示以前輸入到這個區域中的值。該屬性的預設值為true。然而,為了使password不能被重新顯示,你或許希望将該屬性的值設為false。
<select>标簽和<option>标簽:
1.)<html:link>标簽
forward屬性:連結到一個global forward上;action屬性:連結到一個action mapping上;
href屬性:這個連結會轉發給控制器,由控制器做決定;page屬性:一個相對的連結。
用page屬性連結到action上:
<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相關聯的。
注意,上面的代碼中你不必指定web的關聯。相反的,如果你使用href屬性,你就必須像下面所示指出web的關聯(這裡的關聯就是struts-exercise):
<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>
代碼解析後:
<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>
很明顯,當你在相同的web應用程式中做連結是,它比page屬性更加好。你也能用href在不同的伺服器上建立連結:
另一種連結到html-link.do的方法是用action屬性:
<html:password property=\"password\" redisplay=\"false\"/>
你也可以以寫死的方式使用參數:
<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>
或者使用paramId, paramName, and paramProperty屬性:
解析後的代碼:
<html:link page="/html-link.do">
Linking with the page attribute.
</html:link>
另外,還能使用帶name屬性的Map來實作傳遞多個參數:
<html:link href="/struts-exercise-taglib/html-link.do">
Using Href
你也能夠連結到Map類型的action上,上面的代碼解析後的結果:
2.) select和option标簽
<html:select> 的屬性:property-與ActionForm中的某個屬性對應;size-顯示option的數目;multiple-預設為fales,表示不能多選,當設定為true時,property對應的ActionForm的屬性必須為數組。
<html:select property="name" size=6 multiple="true">
<html:option>的屬性:key、local、bundle-指定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的集合中存放了options,value指實際能被送出的值,label是顯示給使用者的值。
例2 <html:options property="value" labelProperty="label" /> collection屬性不被指定時,将使用表單相關的form bean,form bean中value屬性存放option value,label屬性值顯示給使用者。
例3 <html:options name="valueBean" property="values" labelName="labelsBean" labelProperty="labels" /> 這個意思是value值存放在名為valueBean的bean的vlaues屬性中,它是一個collection;label值也是同樣的意思。
<html:optionsCollection>标簽,和<html:options>的用法很相似。
例如 <html:select property="custId"><html:optionsCollection property="customers" label="name" value="custId" /></html:select>
這個标簽和org.apache.structs.util.LabelValueBean結合的很好,如果把label和value都放到這個對象中,可以很簡單的這樣應用:
<html:select property="custId"><html:optionsCollection property="customers" /></html:select>
本文轉自My_King1 51CTO部落格,原文連結:http://blog.51cto.com/apprentice/1360660,如需轉載請自行聯系原作者