Struts2 標籤庫講解

要使用Struts2的標籤,只需要在JSP頁面添加如下一行定義即可:

<%@ taglib prefix="s" uri="/struts-tags"%>

struts2的標籤共分爲五大類:

一、邏輯控制標籤

用於進行邏輯控制輸出。主要分以下幾類:

1)條件標籤:用於執行基本的條件流轉

<s:if>:擁有一個test屬性,其表達式的值用來決定標籤裏內容是否顯示。<s:if test="#request.username=='hzd'">歡迎hzd</s:if>

<s:elseif>:同上。

<s:else>

2)迭代標籤:用於遍歷集合(java.util.Collection)或者枚舉值(java.util.Iterator)類型的對象,value屬性表示集合或枚舉對象,status屬性表示當前循環的對象,在循環體內部可以引用該對象的屬性

<s:iterator value="userList" status="user">

姓名:<s:property value="user.userName" />

年齡:<s:property value="user.age" />

</s:iterator>

3)組合標籤:用於將多個枚舉值對象進行疊加,形成一個新的枚舉值列表

如將3個列表對象進行了組合,形成新的列表對象:

<s:append var="newIteratorList">

<s:param value="%{myList1}" />

<s:param value="%{myList2}" />

<s:param value="%{myList3}" />

</s:append>

輸出:

<s:iterator value="%{#newIteratorList}">

<s:property />

</s:iterator>

4)分割標籤:用於將一個字符串進行分隔,產生一個枚舉值列表

下面的代碼將分隔爲3個字符串,然後循環輸出

<s:generator val="%{'aaa,bbb,ccc'}">

<s:iterator>

<s:property />

</s:iterator>

</s:generator>

5)合併標籤:用於將多個枚舉值按照數組的索引位置進行合併

<s:merge var="newMergeList">

<s:param value="%{mylist1}">--設mylist1列表中有a,b,c三個元素

<s:param value="%{mylist2}">--設mylist2列表中有1,2,3三個元素

</s:merge>

合併後新的列表的元素及其順序爲:a,1,b,2,c,3

<s:iterator value="%{#newMergeList}">

<s:property />

</s:iterator>

6)排序標籤:用於對一組枚舉值進行排序,屬性comparator指向一個繼承自java.util.Comparator的比較器,該比較器可以是對應Action頁面中的一個比較器變量,source指定要排序的列表對象

<s:sort comparator="myComparator" source="myList">

<s:iterator>

<s:property value="..."/>

</s:iterator>

</s:sort>

7)子集標籤:用於取得一個枚舉列表的子集,source用於指定檢索的列表對象,start用於指定起始檢索的索引位置,count用於指定檢索的結果數量,decider屬性必須是一個org.apache.struts2.util.SubsetIteratorFilter.Decider類的子類實例,用以指定檢索的條件。例如在Action中提供了以下方法用來取得一個Decider對象:

public Decider getDecider()

{

return new Decider(){

public boolean decide(Object element) throws Exception{

int i=((Integer)element).intValue();

return (((i%2)==0)?true:false);

}

};

}

然後引用該對象篩選子集:

<s:subset source="myList" decider="decider">

</s:subset>

或者不使用Decider對象:

<s:subset source="myList" count="13" start="3">

</s:subset>

 

二、數據輸出標籤

數據輸出標籤用以輸出頁面中的元素、屬性、隱含變量等,即包括靜態文本的輸出,也包括struts2集成的各種變量的輸出。

1)鏈接標籤:用於創建一個<a>標籤,errorText用於顯示錯誤信息,priInvokeJS表示該鏈接執行時的javascript提示函數,href表示跳轉地址.

<s:a errorText="刪除錯誤" preInvokeJS="confirm('確認刪除?')" href="test.jsp">

<img src="/image/delete.gif" />

</s:a>

2)Action標籤:可以直接調用Action類中的函數,前提是該Action類在struts.xml中有定義,name屬性用於指向映射文件中配置的Action函數,executeResult屬性表示是否執行結果集的跳轉

<s:action name="LoginAction" executeResult="true" />--表示執行LoginAction的默認處理方法execute()

<s:action name="LoginAction!login" executeResult="true" />--表示執行LoginAction的處理方法login()

3)JavaBean標籤:用於創建一個JavaBean對象,name表示JavaBean類全名,var表示變量的實例名,並可以包含<s:param>設置實例化輸入參數

<s:bean name="xxx,xxx,xxx" var="xxx">

<s:param name="name" value="hzd" />--爲該JavaBean的構造方法傳遞參數

</s:bean>

4)日期標籤:用以輸出一個格式化的日期對象,name表示要輸出的對象,format表示輸出的日期格式

 <s:date name="user.birthday" format="dd/MM/yyyy" />

<s:date name="user.birthday" format="%{getText('some.i18n.key')}" />

<s:date name="user.birthday" />--默認格式

5)調用標籤:用以輸出頁面的值棧調試信息,通常在進行程序調用時使用,便於查找JSP頁面中的錯誤

6)引用資源文件標籤:用於加載資源包到值棧,它可以允許<s:text>標籤訪問任何資源包的信息,而不只是當前action相關聯的資源包。name屬性用以指定資源包的類路徑

如xxx.xxx.xxx.ApplicationMessages中定義了標籤:HelloWord=歡迎您!

則可以這樣引用:

<s:i18n name="xxx.xxx.xxx.ApplilcationMessages">

<s:text name="HelloWord" />

</s:i18n>

7)包含頁面標籤:用來包含一個Servlet的輸出(Servlet或JSP頁面),使用value屬性指定包含頁名稱,可以使用<s:param>傳遞參數給子頁

<s:include value="/test.jsp">

<s:param name="username">hzd</s:param>--參數username=hzd給test.jsp頁面

</s:include>

8)傳遞參數標籤:用來爲其他標籤提供參數,所以一般是嵌套在其它標籤的內部,name屬性用來指定參數名稱,value(可選)屬性用來指定參數值

<s:param name="username" value="hzd" />--這種方式的參數值會以String格式放入stack

<s:param name="username">hzd</s:param>--這種方式的參數值會以Object的格式放入stack

9)值棧標籤:用以加入一個值到值棧中

<s:push value="user">

<s:property value="name" />--爲user指定name屬性

<s:property value="age" />--爲user指定age屬性

</s:push>

10)變量賦值標籤:賦予變量一個特定範圍內的值,name屬性表示變量的名字,scope表示變量的作用域(application.session.request.page.action),value變量的值

<s:set>

11)國際化標籤:用於輸出國際化信息,name屬性指定國際化資源文件中消息文本的key,可以與<s:i18n>標籤結合使用

<s:text name="HelloWord" />--它會按照一定的順序查找資源文件,直到找到定義HellowWord標籤的資源文件爲止

12)鏈接標籤:用於創建一個URL鏈接,並可以通過<s:param>標籤提供request參數

<s:url id="url" value="/test.jsp">

<s:param name="username">hzd</s:param>

</s:url>

13)屬性標籤:用以輸出value屬性的值,並擁有一個default屬性,在value對象不存在時顯示。escape屬性爲true,來輸出原始的HTML文本

<s:property value="getText('some.key')">

 

三、HTML表單標籤

HTML標籤都擁有以下3個設置樣式的屬性。

templateDir:執行模板路徑

theme:指定主題名稱,可選值包括simple、xhtml、ajax等

template:指定模板名稱

使用HTML表單標籤會生成大量格式化的HTML代碼,這些代碼是由struts2的模板生成的,這樣的好處是可以讓我們的jsp代碼十分簡單,只需要配置使用不同的主題模板,就可以顯示不同的頁面樣式。

struts2默認提供了5種主題(在此不做詳細介紹):

simple主題:最簡單的主題

XHTML主題:默認主題,使用常用的HTML技巧

CSS XHTML主題:使用CSS實現的XHTML主題

archive主題:使用文檔生成主題

AJAX主題:基於AJAX實現的主題

通過在struts.properties文件中改變struts.ui.theme,struts.ui.templateDir,struts.ui.templateSuffix三個標籤來自由切實可行換主題

由於HTML表單標籤也不少,所以還是要用的時候在網上找吧...

 四、HTML非表單標籤

主要用來輸出各種錯誤和消息。

1)錯誤標籤:用以輸出Action錯誤信息

<s:actionerror />

2)消息標籤:用以輸出Action普通消息

<s:atcionmessage />

3)字段錯誤標籤:用以輸出Action校驗中某一個字段的錯誤信息或所有字段的錯誤信息

<s:fielderror />--輸出所有字段的錯誤信息

<s:fielderror>

<s:param>username</s:param>--輸出字段username的錯誤信息

<s:param>password</s:param>--輸出字段password的錯誤信息

<s:fielderror>

4)DIV標籤:用以輸出一個<div>標籤

 

五、AJAX標籤

AJAX標籤是struts2專門提供的一組進行AJAX操作的標籤,在使用這些標籤之前,需要在JSP頁面中添加如下引用:

<%@ taglib prefix="sx" uri="/struts-dojo-tags"%>

1)鏈接標籤:用於創建一個<a>鏈接,並且在單擊該鏈接時執行異步的請求,該標籤的url屬性必須使用<s:url/>標籤進行設置,target屬性指向要被更新的頁面組件,showLoadingText屬性決定是否顯示文本,indicator表示異步請求時要顯示的圖片

使用form標籤:

<s:div id="targetDiv">

<s:form action="LoginAction">

<sx:a targets="targetDiv" showLoadingText="false" indicator="loadingImage" />

</s:form>

</s:div>

使用url標籤:

<s:div id="targetDiv">

<s:url id="ajaxTest" value="/LoginAction.action">

<sx:a targets="targetDiv" href="%{ajaxTest}" showLoadingText="false" indicator="loadingImage" />

</s:div>

2)自動完成標籤:是一個組合框組件,在文本框中輸入文本,能夠給出一個下拉的提示列表。list屬性用以指定一個自動提示檢索的列表集合(可以是Action中的List類型的屬性),autoComplete屬性爲true時表示進行自動提示

<sx:autocompleter name="test" list="{'上海','湖南',廣東}" autoCompleter="true" />

3)自動事件綁定標籤:該標籤可以爲多個對象的多個事件進行監聽,並能夠發送異步請求。src屬性指定監聽的對象源,events屬性指定監聽的事件類型(JavaScript事件),target屬性指定異步返回內容填充的目標,indicator屬性表示執行異步請求時顯示的圖片

<s:div id="targetDiv">

<s:form action="login">

<s:submit id="bin" />

<s:bind src="bin" events="onclick" targets="targetDiv" showLoadingText="false" indicator="%{getText('loadingImage')}" />

</s:form>

</s:div>

4)日期選擇標籤:用以彈出一個日期和時間的選擇窗口,displayFormat屬性指定要選擇日期的格式,name表示當前組件的屬性的對象,value表示默認值,label表示顯示的文本

<sx:datetimepicker name="order.date" label="Order Date" displayFormat="yyyy-MM-dd" value="%{'2006-01-01'}" />

5)樹標籤:用以輸出一個樹形結構

<sx:tree>

6)Tab頁標籤:使用AJAX的方式顯示多個Tab頁

<s:tabbedpanel>


轉自http://blog.163.com/hzd_love/blog/static/131999881201082111852520/

發佈了24 篇原創文章 · 獲贊 5 · 訪問量 21萬+
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章