?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 標簽也支持嵌套引用，例如：
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 標簽庫
- <html>標簽
它有兩個屬性：locale和xhtml，兩者都不是必需的。
?<html:html?locale=\"true\">
?此行代碼解析后：
?<html?lang=\"en\"> |
- <base>標簽：表示所包含頁面的絕對位置。這個標簽只有內嵌在head標簽中才有效。
?<html:base/>
?此行代碼解析后：
?<base?href=\"http://www.mymain.com/myStrutsApp/testing.jsp\"> |
<img>標簽
最重要的屬性page：圖象文件的路徑，前面必須帶有一個斜線。
其它屬性：heignt、width、alt。
| ??<html:img?page=\"/logo.gif\"?height=\"50\"? width=\"200\"?alt=\"Web?Logo\"/> |
- <link>標簽
?<html:link?page=\"/index.html\">Click?demo</html:link>
?此行代碼解析后：
??<a?href=\"/index.html\">Click?demo</a> |
- <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：相應的信息在錯誤信息的單獨列表后顯示。
- <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相關聯的。 |
任何包含在<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> |
還可以看到，<form>標簽中method屬性的缺省值是POST。
<text>標簽、<hidden>標簽、<textarea>標簽、<radio>標簽、<checkbox>標簽、<submit>標簽、<reset>標簽：
都有一個property屬性，最后會被轉換成HTML中的name屬性，當然還有name和value屬性。
<password>標簽
| ??<html:password?property=\"password\"??redisplay=\"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.do的方法是用action屬性：
?<html:link action="/html-link">
? Using Action attribute
?</html:link> |
你也可以以硬編碼的方式使用參數：
?<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來實現傳遞多個參數：
?<%
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.) 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>
posted on 2006-07-06 17:10
船長 閱讀(501)
評論(0) 編輯 收藏 所屬分類:
J2EE