|
Struts提供了五個(gè)標(biāo)簽庫(kù)，即：HTML、Bean、Logic、Template和Nested。
|
標(biāo)簽庫(kù) |
說(shuō)明 |
| HTML 標(biāo)簽 |
用來(lái)創(chuàng)建能夠和Struts 框架和其他相應(yīng)的HTML 標(biāo)簽交互的HTML 輸入表單 |
| Bean 標(biāo)簽 |
在訪問(wèn)JavaBeans 及其屬性，以及定義一個(gè)新的bean 時(shí)使用 |
| Logic 標(biāo)簽 |
管理?xiàng)l件產(chǎn)生的輸出和對(duì)象集產(chǎn)生的循環(huán) |
| Template 標(biāo)簽 |
隨著Tiles框架包的出現(xiàn)，此標(biāo)記已開始減少使用 |
| Nested 標(biāo)簽 |
增強(qiáng)對(duì)其他的Struts 標(biāo)簽的嵌套使用的能力 |
標(biāo)簽的公共特征
使用固定屬性名稱的Struts 標(biāo)簽：
|
屬性 |
說(shuō)明 |
| id |
命名自定義標(biāo)簽創(chuàng)建時(shí)的腳本變量名。 |
| name |
指出關(guān)鍵字值，在該關(guān)鍵字下可以找到一個(gè)存在的bean 。如果給出了scope屬性，則僅僅在scope中查找。否則，根據(jù)標(biāo)準(zhǔn)的順序在各種scope中查找：(page, request, session, or application)。 |
| property |
指出bean 中的某個(gè)屬性，可以在其中檢索值。如果沒有標(biāo)明，則使用對(duì)象本身的值。 |
| scope |
定義了Bean在哪個(gè)范圍(page, request, session, or application)中被查找。如果沒有標(biāo)明按順序查找。腳本變量(見id)將在相同的范圍中創(chuàng)建。 |
Struts 標(biāo)簽也支持嵌套引用，例如：
Property="foo.bar.baz"
這相當(dāng)于進(jìn)行下面的調(diào)用：
getFoo().getBar().getBaz()；
或者做為setter：
getFoo().getBar().setBaz(value)； |
雖然Struts 標(biāo)簽的設(shè)計(jì)原意是為了避免使用scriptlet，scriptlet的表達(dá)式還能夠提供給所有的Struts 標(biāo)簽使用。但請(qǐng)確保使用完整的表達(dá)式:
錯(cuò)誤：
<html:link href="‘<%= "/" + name %>/index.jsp>‘>
正確：
<html:link href="‘<%= "/" + name + "/index.jsp" %>‘> // 表達(dá)式必須提供整個(gè)屬性值 |
Html 標(biāo)簽庫(kù)
- <html>標(biāo)簽
它有兩個(gè)屬性：locale和xhtml，兩者都不是必需的。
<html:html locale=\"true\">
此行代碼解析后：
<html lang=\"en\"> | 說(shuō)明：生成的結(jié)果取決于Struts應(yīng)用程序所位于的服務(wù)器的locale。如果你將應(yīng)用程序部署到一個(gè)不同locale的服務(wù)器，你不需要改變代碼，Locale會(huì)自動(dòng)調(diào)整。
- <base>標(biāo)簽：表示所包含頁(yè)面的絕對(duì)位置。這個(gè)標(biāo)簽只有內(nèi)嵌在head標(biāo)簽中才有效。
<html:base/>
此行代碼解析后：
<base href=\"http://www./myStrutsApp/testing.jsp\"> |
-
<img>標(biāo)簽
最重要的屬性page：圖象文件的路徑，前面必須帶有一個(gè)斜線。
其它屬性：heignt、width、alt。
| <html:img page=\"/logo.gif\" height=\"50\" width=\"200\" alt=\"Web Logo\"/> |
- <link>標(biāo)簽
<html:link page=\"/index.html\">Click demo</html:link>
此行代碼解析后：
<a href=\"/index.html\">Click demo</a> |
- <errors>標(biāo)簽：通過(guò)一個(gè)簡(jiǎn)單的<html:errors/>標(biāo)簽，你就可以在一個(gè)JSP頁(yè)面上顯示完全自定義的錯(cuò)誤信息。功能超強(qiáng)大??！
說(shuō)明：這個(gè)標(biāo)簽在Request對(duì)象的屬性集合中查找reserved key。如果它找到一個(gè)reserved key，它就假設(shè)這個(gè)key是一個(gè)String、或是一個(gè)String數(shù)組
（它包含在模塊的MessageResources中查找的message keys）、或是類型為org.apache.struts.action.ActionErrors的一個(gè)對(duì)象。
如果在應(yīng)用程序資源中存在相應(yīng)的信息，那么就可以用下面這些可選的message keys：
· errors.header or errors.prefix：相應(yīng)的信息在錯(cuò)誤信息的單獨(dú)列表前顯示。
· errors.footer or errors.suffix：相應(yīng)的信息在錯(cuò)誤信息的單獨(dú)列表后顯示。
- <form>標(biāo)簽系列
使用<form>標(biāo)簽時(shí)必須遵循一些規(guī)則：
- 標(biāo)簽中必須包含一個(gè)action屬性，它是這個(gè)標(biāo)簽中唯一必需的屬性。如果不具備該屬性則JSP頁(yè)面會(huì)拋出一個(gè)異常。之后你必須給這個(gè)action屬性指定一個(gè)有效值。一個(gè)有效值是指應(yīng)用程序的Struts配置文件中元素里的任何一個(gè)子元素的訪問(wèn)路徑。而且相應(yīng)的元素中必須有一個(gè)name屬性，它的值是form bean的名稱。
<html:form action=\"/login\" >
如果你有上述一個(gè)標(biāo)簽 ，那么你的Struts配置文件的元素中必須有一個(gè)如下顯示為粗體的元素：
<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> // 這就是說(shuō)一個(gè)form標(biāo)簽是和form bean相關(guān)聯(lián)的。 |
-
任何包含在<form>中用來(lái)接收用戶輸入的標(biāo)簽（<text>、<password>、<hidden>、<textarea>、<radio>、<checkbox>、<select>）必須在相關(guān)的form bean中有一個(gè)指定的屬性值。比如，如果你有一個(gè)屬性值被指定為“username”的<text>標(biāo)簽，那么相關(guān)的form bean中也必須有一個(gè)名為“username”的屬性。輸入<text>標(biāo)簽中的值會(huì)被用于生成form bean的userName屬性。
<form>標(biāo)簽還有一些不是必須但很有用的“次要”屬性。
比如，你可以用focus屬性來(lái)生成JavaScript，它會(huì)“定焦”（focus）到該form所包含的一個(gè)元素上。使用focus屬性時(shí)你需要給它指定元素的名稱。
<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> | 有沒有看到這個(gè)標(biāo)簽庫(kù)是如何建立JavaScript來(lái)定焦到password元素上的? 這也是該庫(kù)讓人著迷的地方之一。你不用擔(dān)心如何在客戶端進(jìn)行編程，它會(huì)幫你自動(dòng)生成。
還可以看到，<form>標(biāo)簽中method屬性的缺省值是POST。
<text>標(biāo)簽、<hidden>標(biāo)簽、<textarea>標(biāo)簽、<radio>標(biāo)簽、<checkbox>標(biāo)簽、<submit>標(biāo)簽、<reset>標(biāo)簽：
都有一個(gè)property屬性，最后會(huì)被轉(zhuǎn)換成HTML中的name屬性，當(dāng)然還有name和value屬性。
<password>標(biāo)簽
| <html:password property=\"password\" redisplay=\"false\"/> | 該標(biāo)簽中的一個(gè)很重要的屬性是"redisplay"，它用于重新顯示以前輸入到這個(gè)區(qū)域中的值。該屬性的缺省值為true。然而，為了使password不能被重新顯示，你或許希望將該屬性的值設(shè)為false。
<select>標(biāo)簽和<option>標(biāo)簽：
<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> |
遺補(bǔ)：1.) <html:link>標(biāo)簽
forward屬性：鏈接到一個(gè)global forward上；action屬性：鏈接到一個(gè)action mapping上；
href屬性：這個(gè)鏈接會(huì)轉(zhuǎn)發(fā)給控制器，由控制器做決定；page屬性：一個(gè)相對(duì)的鏈接。
用page屬性鏈接到action上：
<html:link page="/html-link.do">
Linking with the page attribute.
</html:link> |
注意，上面的代碼中你不必指定web的關(guān)聯(lián)。相反的，如果你使用href屬性，你就必須像下面所示指出web的關(guān)聯(lián)(這里的關(guān)聯(lián)就是struts-exercise)：
<html:link href="/struts-exercise-taglib/html-link.do">
Using Href
</html:link> |
很明顯，當(dāng)你在相同的web應(yīng)用程序中做鏈接是，它比page屬性更加好。你也能用href在不同的服務(wù)器上創(chuàng)建鏈接：
另一種鏈接到html-link.do的方法是用action屬性：
<html:link action="/html-link">
Using Action attribute
</html:link> |
你也可以以硬編碼的方式使用參數(shù)：
<html:link page="/htmllink.do?doubleProp=3.3&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來(lái)實(shí)現(xiàn)傳遞多個(gè)參數(shù)：
<%
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上，上面的代碼解析后的結(jié)果：
<html:messages property="property2" message="true" id="msg" header="messages.header" footer="messages.footer">
<tr><td><%= pageContext.getAttribute("msg") %></td></tr>
</html:messages> |
2.) select和option標(biāo)簽
<html:select> 的屬性：property－與ActionForm中的某個(gè)屬性對(duì)應(yīng)；size－顯示option的數(shù)目；multiple－默認(rèn)為fales，表示不能多選，當(dāng)設(shè)定為true時(shí)，property對(duì)應(yīng)的ActionForm的屬性必須為數(shù)組。
<html:select property="name" size=6 multiple="true">
<html:option>的屬性：key、local、bundle－指定Resource Bundle中的內(nèi)容。
例如 <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，相關(guān)內(nèi)容為 htmlselect.red=RED
<html:options>標(biāo)簽，提供了一組<option>元素，在<html:select>元素中可以包含多個(gè)<html:options>元素。非常靈活，可以取得集合或數(shù)組中的值。
例1 <html:options collection="coll" property="value" labelProperty="label" /> 這指在coll的集合中存放了options，value指實(shí)際能被提交的值，label是顯示給用戶的值。
例2 <html:options property="value" labelProperty="label" /> collection屬性不被指定時(shí)，將使用表單相關(guān)的form bean，form bean中value屬性存放option value，label屬性值顯示給用戶。
例3 <html:options name="valueBean" property="values" labelName="labelsBean" labelProperty="labels" /> 這個(gè)意思是value值存放在名為valueBean的bean的vlaues屬性中，它是一個(gè)collection；label值也是同樣的意思。
<html:optionsCollection>標(biāo)簽，和<html:options>的用法很相似。
例如 <html:select property="custId"><html:optionsCollection property="customers" label="name" value="custId" /></html:select>
這個(gè)標(biāo)簽和org.apache.structs.util.LabelValueBean結(jié)合的很好，如果把label和value都放到這個(gè)對(duì)象中，可以很簡(jiǎn)單的這樣應(yīng)用：
<html:select property="custId"><html:optionsCollection property="customers" /></html:select>
參考：Struts 中 Html 標(biāo)簽庫(kù) 的用法
《Structs in action》、《Struts Kict Start》
|
