struts標(biāo)簽詳解(一個不漏)

1、.struts標(biāo)簽詳解（一個不漏）整理來自：www.web-· Struts Bean(1.2)  cookie 常用屬性：id：定義一個javax.servlet.http.Cookie類型的變量，這個變量被存放在page范圍內(nèi)。name：指定Cookie的名字。value：指定Cookie的默認(rèn)值。如果有name屬性指定的cookie不存在，就是使用value屬性指定的默認(rèn)值。更多 cookie 信息 define 這個標(biāo)簽基于來自一個給定的字符串，或另一個JavaBean的數(shù)據(jù)暴露一個變量。scriptlet及其他標(biāo)簽

2、可以像訪問任何其他的變量一樣訪問這個暴露變量。這可能好像沒有什么用處，但是它的確有用。參見具體的例子。也請參考cookie/header /parameter和page條目，其中有相關(guān)的標(biāo)簽。1. 使用限制id屬性是必需的，并作為要暴露的變量的名稱。也需要指定name/property/scope或value，或者將暴露的變量的值嵌入到”bean:define”標(biāo)簽的標(biāo)簽體內(nèi)部。還有，只可以一次定義一個變量。試圖在同一個頁面中定義一個同名的新變量將導(dǎo)致拋出異常。更多 define 信息 header bean:header標(biāo)簽取回請求中名稱為name的h

3、eader的值。如果沒有指定multiple屬性則依據(jù)剛?cè)』氐闹祫?chuàng)建一個String類型的bean。如果指定了multiple屬性則依據(jù)剛?cè)』氐闹祫?chuàng)建一個String類型的數(shù)組。然后用id屬性值將String或String綁定到page作用域中(這種綁定是為了其它標(biāo)簽?zāi)軌蚴褂迷撝?，并創(chuàng)建對應(yīng)的scripting變量(這種變量是為了JSP腳本能夠使用該值)。 下面是我的瀏覽器發(fā)送的header的內(nèi)容，這些內(nèi)容和瀏覽器有關(guān)，因此您的瀏覽器發(fā)送的內(nèi)容可能和下面列出的不同。不過這沒有關(guān)系，因為要理解bean:header標(biāo)簽?zāi)灰獙@些內(nèi)容有一個大概的認(rèn)識就足夠了。更多 header

4、60;信息 include 這個有趣的標(biāo)簽允許調(diào)用一個外部的JSP或全局轉(zhuǎn)發(fā)或URL，并且將結(jié)果響應(yīng)數(shù)據(jù)作為一個變量訪問。被調(diào)用頁面的響應(yīng)不會寫出到響應(yīng)流。如果該暴露的變量是用”bean:write”顯示的，接收到的輸出是經(jīng)過HTML編碼的（“”被替換為“& It;”，等等）。1. 使用限制 必須指定id屬性和forward、page或者h(yuǎn)ref屬性之一。2. 屬性 id：要暴露的變量的名稱。scriptlet及其他定制標(biāo)簽將能夠使用這個名稱來訪問該新變量。結(jié)果變量是頁面作用域的。 forward：要調(diào)用的全局轉(zhuǎn)發(fā)的名稱。 page：要

5、調(diào)用的當(dāng)前Web應(yīng)用中的JSP頁面的名稱。這個名稱是相對于模塊的，并且需要一個“/”前綴。  href：外部頁面的的絕對URL，例如/code/index.html。 anchor：被調(diào)用頁面的HTML錨的名稱。 transaction：如果被設(shè)置為true，則會在響應(yīng)中包含事務(wù)令牌。參見”logic:redirect”條目中的說明。 更多 include 信息 message 這個標(biāo)簽顯示一個國際化了的消息。最多可以指定5個替代參數(shù)。1. 使用限制 必須指定key屬性或者n

6、ame/property/scope組合。2. 屬性key：要顯示的消息資源的關(guān)鍵字。如果locale/bundle組合沒有被指定，那么默認(rèn)消息資源文件和用戶的當(dāng)前場所將被用來決定顯示哪個消息資源。name/property/scope：這些屬性被用來基于一個具有給定的name和可選的property和scope屬性的對象來導(dǎo)出一個關(guān)鍵字。如果沒有指定scope，將在所有作用域中查找給定名稱的對象。 locale/bundle：這些屬性用于指定一個不同的場所對象或消息資源文件。locale指定一個可用于查找存儲于當(dāng)前會話中的Locale對象的關(guān)鍵字。bundle屬性將在下面的小節(jié)中詳細(xì)解釋。a

7、rg0/arg1/arg2/arg3/arg4：這些分別是第一個、第二個、第三個、第四個以及第五個替代參數(shù)的值。更多 message 信息 page 這個方便的標(biāo)簽將來自于頁面上下文中的對象暴露為可以通過scriptlet或定制標(biāo)簽訪問的變量。PageContext對象是當(dāng)前頁面的所有狀態(tài)的儲存庫。這包含在第2章描述過的會話（HttpSession）和請求（HttpServletRequest）中。還有一些：application：javax.servlet.ServletContext對象，通過調(diào)用pageContext.getServlet- Con

8、text()來獲得。config：javax.servlet.ServletConfig對象，通過調(diào)用pageContext.getServletConfig()來獲得。不要將其與Struts的內(nèi)部配置對象搞混淆。response：與此頁面關(guān)聯(lián)的HttpServletResponse對象。更多 page 信息 parameter bean:parameter標(biāo)簽取回請求中的參數(shù)值。如果沒有指定multiple屬性則依據(jù)剛?cè)』氐闹祫?chuàng)建一個String類型的bean。如果指定了multiple屬性則依據(jù)剛?cè)』氐闹祫?chuàng)建一個String類型的數(shù)組。然后用id屬性

9、值將String或String綁定到page作用域中(這種綁定是為了其它標(biāo)簽?zāi)軌蚴褂迷撝?，并創(chuàng)建對應(yīng)的scripting變量(這種變量是為了JSP腳本能夠使用該值)。 下面的兩個代碼片段使用相同的url傳遞參數(shù)，url的形式為:8080/struts-demo/parameter.jsp?param=1&param=2&param=3。前面的代碼片段中沒有指定multiple屬性，因此p是String類型而且僅僅讀取了參數(shù)的第一個值。后面的代碼片段中指定了multiple屬性的值，因此ps是String類型的包含所有參數(shù)的值。 更多&#

10、160;parameter 信息 resource resource允許從當(dāng)前Web應(yīng)用程序讀取任何文件并且將其暴露為一個字符串變量或者一個InputStream。參見”bean:include”。1. 使用限制id屬性和name屬性是必需的。2. 屬性id：要暴露的變量的名稱。scriptlet及其他定制標(biāo)簽將能夠使用這個名稱來訪問該新變量。這個屬性是必需的。 name：要加載資源的模塊相對的名稱。 input：如果這個屬性被指定（實際的值并不重要），那么該暴露的變量具有InputStream類型，否則它是String類型。 更多 resou

11、rce 信息 size 這個標(biāo)簽將一個給定的Collection或者M(jìn)ap或者數(shù)組的大小暴露為一個變量（整數(shù)類型），可以從scriptlet或定制標(biāo)簽訪問到。1. 使用限制 id屬性是必需的，并且必須指定想要測量大小的數(shù)組/ Collection/Map，使用collection屬性或者一個name/property/scope組合。2. 屬性 id：要暴露的變量的名稱。scriptlet及其他定制標(biāo)簽將能夠使用這個名稱來訪問該新變量。這個屬性是必需的。 name/property/scope：這些屬性被用來定位Collection/Map/數(shù)

12、組，基于可選的屬性和作用域。如果沒有指定scope，將在所有作用域中查找給定名稱的對象。 collection：這個是name/property/scope組合的一個非常方便的替換物。使用scriptlet來計算這個屬性的值，更多 size 信息 struts 這個標(biāo)簽暴露一個Struts全局轉(zhuǎn)發(fā)，或表單bean或表單處理器（該表單處理器的ActionMapping）為一個變量，可以通過scriptlet及其他標(biāo)簽進(jìn)行訪問。如果想要JSTL能夠訪問Struts的內(nèi)部變量，這是很有幫助的。1. 使用限制id屬性是必需的。還必須指定forward、

13、formBean或mapping屬性。2. 屬性 id：要暴露的變量的名稱。scriptlet及其他定制標(biāo)簽將能夠使用這個名稱來訪問該新變量。這個屬性是必需的。  forward：要暴露的全局轉(zhuǎn)發(fā)的名稱。 formBean：要暴露的已經(jīng)聲明的表單bean的名稱。 mapping：要暴露的表單處理器的名稱。 更多 struts 信息 write 這個標(biāo)簽將指定的bean屬性輸出為響應(yīng)流。它允許對給定的bean屬性進(jìn)行一些格式化。1. 使用限制name屬性是必需的。2. 屬性name/property/scope：這些

14、屬性被用來基于給定的name 和可選的property 和scope 來定位JavaBean。如果沒有指定scope，將在所有作用域中查找給定名稱的對象。ignore：如果被設(shè)置為true，則一旦命名的JavaBean沒有找到，則失敗，什么也不會發(fā)生。默認(rèn)值（false）導(dǎo)致一個異常被拋出。更多 write 信息· Struts Html(1.2)  cancel  html:cancel標(biāo)簽生成一個取消按鈕。當(dāng)點擊該按鈕后action servlet會繞過相應(yīng)的form bean的validate()方法，同時將控制權(quán)交給相應(yīng)的ac

15、tion。在該action中可以使用Action.isCancelled(HttpServletRequest)方法判斷是否被取消了。如果返回true表示這個action被取消了，否則表示這個action沒有被取消。 請注意，如果您修改了html:cancel標(biāo)簽的property屬性值，那么struts提供的cancel探測機(jī)制就失效了，您自己必須提供類似的機(jī)制。下面是可取消的action的配置文件，注意<set-property property="cancellable" value="true"/>這一行，如果不添加Struts會拋出

16、org.apache.struts.action.InvalidCancelException異常。這是我在完成本指南的過程中發(fā)現(xiàn)的唯一向下不兼容的地方。更多 cancel 信息 checkbox html:check標(biāo)簽生成一個checkbox。這里的value值可以是true，yes或on。如果您要提交其它的值(如某種形式的標(biāo)識)應(yīng)該考慮使用html:multibox標(biāo)簽。 注意:為了正確的處理沒有選中的checkbox您必須在reset()中設(shè)置對應(yīng)的屬性為false。下面的代碼示例了html:checkbox標(biāo)簽的用法，其中CheckboxFor

17、m中聲明了三個boolean類型的域，如下：<!- 略掉了get方法(也可以是isXXX形式)和set方法 ->private boolean one = false;private boolean two = false;<html:checkbox name="checkboxForm" property="one">One</html:checkbox><html:checkbox name="checkboxForm" property="two">Two&l

18、t;/html:checkbox>如果選中后被提交則相應(yīng)的屬性的值為true。更多 checkbox 信息 errors  html:errors標(biāo)簽和html:messages標(biāo)簽的功能相似，做比較介紹。 html:errors標(biāo)簽將由name屬性指定的ActionMessages、ActionErrors、String和String直接輸出到頁面中。html:messages標(biāo)簽將用由name屬性(注意message屬性值對它的影響)指定的ActionMessages、ActionErrors、String和String創(chuàng)建一個新的屬

19、性和scripting變量，使用id屬性值作為名稱。html:errors標(biāo)簽和html:messages標(biāo)簽的property屬性是用來為errors和messages分類的。我們可以給這兩個標(biāo)簽指定property屬性，以便只顯示某一類的錯誤或消息。更多 errors 信息 form 示例通常，可以指定action和focus屬性：<html:form action="login.do" focus="userId"><html:text property="userId"

20、>.</html:form>更多 form 信息 frame 呈現(xiàn)為一個HTML “frame”。使用”html:frame”的好處在于可以使用全局轉(zhuǎn)發(fā)或表單處理器來輕易地將內(nèi)容放入frame中。1. 使用限制必須指定action/ module、href、page或者forward屬性。例如：<html:frame page="/index.jsp" scrolling="no" framName="main"/>更多 frame 信息

21、0;hidden 這個標(biāo)簽表示一個隱藏表單字段。1. 使用限制property屬性是必需的。它必須是”html:form”標(biāo)簽的一個子標(biāo)簽。2. 屬性前5個公共屬性集（evt-attrs、acc-attrs、ren-attrs、struts-attrs和initattr）都是可接受的，并且都有其通常的意義。除此之外，還有個write屬性，如果被設(shè)置為true，將導(dǎo)致這個隱藏字段的值會被顯示。這在調(diào)試時是有用的。3. 示例<html:hidden property="userId"/>還可以這樣指定一個value屬性.更多 hidden

22、0;信息 html 這個標(biāo)簽插入”html”/html”標(biāo)簽，并且language屬性等于當(dāng)前的用戶的場所。1. 使用限制無如果使用它，其他的Struts標(biāo)簽應(yīng)該被嵌套在它內(nèi)部。<html:html>ok</html:html>更多 html 信息 img 用于在網(wǎng)頁上面顯示一個圖片寫法大致如下：<html:img srcKey="panyLogo">更多 img 信息 javascript  html:javascript標(biāo)簽生

23、成用于校驗的javascript腳本代碼。 下面的代碼片段示例了html:javascript標(biāo)簽的基本用法，其中formName屬性的值是在validation.xml文件的<formset>中定義的form的名稱。有一點值得注意的是在確定<formset>時要使用合適的language屬性值。<html:javascript formName="dataForm"/>更多 javascript 信息 link  html:link標(biāo)簽生成一個錨點(<a>)元素。我從html

24、:link標(biāo)簽如何構(gòu)造基本url和如何構(gòu)造query參數(shù)兩個方面來介紹這個標(biāo)簽。構(gòu)造基本url是依據(jù)該標(biāo)簽的如下四個屬性進(jìn)行的，這四個屬性一次只能出現(xiàn)一個。讓我們看看它們：forward，指定一個全局ActionForward的名稱。另外如果forward是module相關(guān)的則該forward必須指向一個action而不能是一個頁面。action，指定一個Action的名稱。href，struts會直接使用這個值而不會對其進(jìn)行任何處理。page，指定一個頁面的路徑，必須以/開始。更多 link 信息 messages html:messages標(biāo)簽功能和

25、html:errors相似，所以我們放到一起來介紹。 html:errors標(biāo)簽將由name屬性指定的ActionMessages、ActionErrors、String和String直接輸出到頁面中。html:messages標(biāo)簽將用由name屬性(注意message屬性值對它的影響)指定的ActionMessages、ActionErrors、String和String創(chuàng)建一個新的屬性和scripting變量，使用id屬性值作為名稱。html:errors標(biāo)簽和html:messages標(biāo)簽的property屬性是用來為errors和messages分類的。我們可以給這兩個標(biāo)簽指定prop

26、erty屬性，以便只顯示某一類的錯誤或消息。在資源文件增加了如下的內(nèi)容：.更多 messages 信息 multibox html:multibox標(biāo)簽生成多個checkbox。當(dāng)您要使用大量的checkbox時使用這個標(biāo)簽非常方便，可以使您避免在ActionForm中聲明大量的boolean類型的變量，帶之以一個數(shù)組就行了。注意:為了正確的處理沒有選中的checkbox您必須在reset()中設(shè)置數(shù)組的長度為0。下面的代碼示例了html:multibox標(biāo)簽的一般用法，如果被提交則選中的所有checkbox的value值將被提交到multiboxFor

27、m中的selectedItems中，這是一個String數(shù)組。<html:multibox name="multiboxForm" property="selectedItems" value="00001"/><html:multibox name="multiboxForm" property="selectedItems" value="00002"/>更多 multibox 信息 password tex

28、t表示一個一行的文本輸入字段。password表示一個口令字段。兩者之間唯一的差別在于，使用”html:password”標(biāo)簽，用戶輸入的字符將不會被顯示出來；只有星號或其他的占位符被顯示出來。 1. 使用限制property屬性是必需的。它必須是”html:form”標(biāo)簽的一個子標(biāo)簽。2. 屬性 全部的公共的屬性集（evt-attrs、acc-attrs、ren-attrs、struts-attrs、init-attr和新的err-attrs）都是可接受的，并且都有其通常的意義。更多 password 信息 radio  html:radio

29、標(biāo)簽生成一個radio。主要的用法有兩種，下面我們通過代碼來示例。 下面的代碼示例了html:radio標(biāo)簽的一般用法，如果被提交則選中的radio的value值將被提交到radioForm中的id中。<html:radio name="radioForm" property="id" value="00001">One</html:radio><html:radio name="radioForm" property="id" value="00002&

30、quot;>Two</html:radio> 更多 radio 信息 reset  這個標(biāo)簽顯示一個如果被單擊后，將導(dǎo)致外圍的表單中的字段被清除的按鈕。1. 使用限制這個標(biāo)簽應(yīng)該用于一個”html:form”標(biāo)簽內(nèi)部。2. 屬性 前4個通用屬性集（evt-attrs、acc-attrs、ren-attrs和struts-attrs）都是可以接受的。如果其值沒有被指定，并且如果沒有在”html:reset”標(biāo)簽的標(biāo)簽體中呈現(xiàn)文本，那么按鈕文字默認(rèn)為“Reset”。3. 示例這個例子展示了1個提交按鈕，按鈕的文本都是“test”。

31、<html:reset value="test"/>更多 reset  信息 rewrite 這個標(biāo)簽解析并且呈現(xiàn)一個URL。所用的規(guī)則類似于”html:link”中所用的。不同于”html:link”的是，URL不是被嵌入到一個HTML “a”標(biāo)簽中，URL是單獨呈現(xiàn)的?？梢园l(fā)現(xiàn)在調(diào)試時或用于腳本的時候這個標(biāo)簽是非常有用的。示例這里是使用一個全局轉(zhuǎn)發(fā)的簡單例子：<html:rewrite forward="success"/>更多 rewrite 信息 sel

32、ect html:select標(biāo)簽生成一個select元素。是單選還是多選取決于該標(biāo)簽的multiple屬性。如果指定了multiple="true"則為多選，此時對應(yīng)的屬性應(yīng)該是一個數(shù)組。如果沒有指定multiple="true"則為單選，此時對應(yīng)的屬性應(yīng)該是標(biāo)量。 注意：為了正確的處理沒有做任何的選擇的情況，在ActionForm中的reset()方法中必須將標(biāo)量屬性設(shè)置為默認(rèn)值而將數(shù)組的長度置為0。另外的一個重要問題就是struts如何生成option元素了，這個任務(wù)struts交給了html:option、html:options和ht

33、ml:optionsCollection三個標(biāo)簽。html:option標(biāo)簽html:option標(biāo)簽生成一個HTML的option元素。該標(biāo)簽必須嵌在html:select標(biāo)簽中。它的顯示文本來自其標(biāo)簽體，也可以來自于資源文件。它的value屬性用來指定什么值將要被提交。更多 select 信息 submit 這個標(biāo)簽顯示一個按鈕，如果被單擊將導(dǎo)致外圍的表單被提交處理。1. 使用限制這個標(biāo)簽必須用于一個”html:form”標(biāo)簽內(nèi)部。2. 屬性“html:submit”對前4個公共屬性集（evt-attrs、acc-attrs、ren-attrs和st

34、ruts-attrs）都是可以接受的。如果其值沒有被指定，并且如果沒有在它的標(biāo)簽體中呈現(xiàn)文本，那么按鈕文字默認(rèn)為“Submit”。3. 示例<html:submit value="test"/>更多 submit 信息 text text表示一個一行的文本輸入字段。password表示一個口令字段。兩者之間唯一的差別在于，使用”html:password”標(biāo)簽，用戶輸入的字符將不會被顯示出來；只有星號或其他的占位符被顯示出來。 1. 使用限制property屬性是必需的。它必須是”html:form”標(biāo)簽的一個子標(biāo)簽。2.

35、 屬性 全部的公共的屬性集（evt-attrs、acc-attrs、ren-attrs、struts-attrs、init-attr和新的err-attrs）都是可接受的，并且都有其通常的意義。更多 text 信息 xhtml html:xhtml標(biāo)簽在頁面中一出現(xiàn)就是告訴該頁的所有其它的Struts html標(biāo)簽以XHTML1.0兼容的形式輸出。這和將html:html標(biāo)簽的xhtml屬性值指定為true有些類似。如果上述情況都沒有出現(xiàn)，Struts html標(biāo)簽將以html4.01兼容的形式輸出。 更多 xhtml 信息 

36、;empty logic:empty標(biāo)簽是用來判斷是否為空的。如果為空，該標(biāo)簽體中嵌入的內(nèi)容就會被處理。該標(biāo)簽用于以下情況： 當(dāng)Java對象為null時  當(dāng)String對象為""時  當(dāng)java.util.Collection對象中的isEmpty()返回true時  當(dāng)java.util.Map對象中的isEmpty()返回true時  下面的代碼示例了logic:empty標(biāo)簽判斷集合persons是否為空： <logic:empty name="listForm" property = &q

37、uot;persons">  <div>集合persons為空!</div> </logic:empty> 更多 empty 信息 equal equal檢查給定的屬性（或擴(kuò)展屬性）是否等于一個給定值。如果是這樣的話，equal標(biāo)簽的標(biāo)簽體便會被執(zhí)行。notEqual是equal的逆命題。1. 使用限制value屬性是必需的。2. 屬性base-attrs和exprop-attrs屬性集都是接受的。還有一個額外的value屬性，它是屬性或擴(kuò)展屬性將要與之比較的一個常數(shù)值。更多 equ

38、al 信息 forward 該標(biāo)簽用于進(jìn)行全局轉(zhuǎn)發(fā)，使用該標(biāo)簽的頁面一般不再編寫其他內(nèi)容，因為隨著轉(zhuǎn)發(fā)，頁面將跳轉(zhuǎn)，原頁面中的內(nèi)容也沒有意義了。例如：<logic:forward name="welcome"/>welcome 是配置在struts里面的全局轉(zhuǎn)發(fā)變量，大致這樣<global-forwards><forward name="welcome" path="/welcome.jsp"></global-forwards>更多 forwar

39、d 信息 greaterEqual greaterEqual是一個有條件標(biāo)簽，只有在給定的屬性（或擴(kuò)展屬性）大于或等于由value屬性給出的常數(shù)值的時候，其標(biāo)簽體才會被執(zhí)行。本組中的其他標(biāo)簽也是類似定義的。注意，如果值不是一個數(shù)值，它會被解釋為一個字符串，并且會執(zhí)行字符串之間的比較（使用Java的標(biāo)準(zhǔn)字符串比較）。1. 使用限制value屬性是必需的。2. 屬性base-attrs和exprop-attrs屬性集都是接受的。還有一個額外的value屬性，它是屬性或擴(kuò)展屬性將要與之比較的一個常數(shù)值。更多 greaterEqual 信息 

40、greaterThan 意為：大于示例：<logic:greaterThan name="maxId" value="10">/.</logic:greaterThan>再說明下cookie屬性的使用。<logic:greaterThan cookie="use_num" name="maxId" value="10">/.</logic:greaterThan>更多 greaterThan 信息 itera

41、te id 腳本變量的名稱，它保存著集合中當(dāng)前元素的句柄。 name 代表了你需要疊代的集合，來自session或者request的屬性。 type 是其中的集合類元素的類型 bean的write標(biāo)記是用來將屬性輸出的，name用來匹配iterate的id，property用來匹配相應(yīng)類的屬性<logic:iterate>用法詳解22007-04-04 20:34<login:iterate>標(biāo)記用于在頁面中創(chuàng)建一個循環(huán),以此來遍歷如數(shù)組、Collection、Map這樣的對象。該標(biāo)記的功能強(qiáng)大，在Struts應(yīng)用的頁面中經(jīng)常使用到。 更多 iter

42、ate 信息 lessEqual 意為：小于等于 示例：<logic:lessEqual name="maxId" value="10">/.</logic:lessEqual>再說明下cookie屬性的使用。<logic:lessEqual cookie="use_num" name="maxId" value="10">/.</logic:lessEqual>更多 lessEqual 信息

43、60;lessThan 意為：小于 示例：<logic:lessThan name="maxId" value="10">/.</logic:lessThan>再說明下cookie屬性的使用。<logic:lessThan cookie="use_num" name="maxId" value="10">/.</logic:lessThan>更多 lessThan 信息 match logic:match標(biāo)簽用來處理子串匹配問題。 match標(biāo)簽將在一個在給定屬性（或擴(kuò)展屬性）包含作為一個子串的value屬性的時候執(zhí)行其標(biāo)簽體的條件處理標(biāo)簽。示例下面是查找一個具有.cn后綴的電子郵件地址的簡單例子： <logic:match name="MyBean" property="email" value="