struts2標籤詳解

struts2標籤講解

要使用Struts2的標籤,只須要在JSP頁面添加以下一行定義便可：<%@ taglib prefix="s" uri="/struts-tags"%>

Struts2的標籤共分爲五大類：

1、邏輯控制標籤

用於進行邏輯控制輸出，主要分爲如下幾類：

一、條件標籤：用於執行基本的條件流轉

<c:if>擁有一個test屬性，其表達式的值用來決定標籤裏的內容是否顯示，

<s:if test="#request.username=='hzd'">北京歡迎你</s:if>
<selseif test="#request.username=='清風'">上海歡迎你</s:elseif>
<s:else>同上

二、迭代標籤：用於遍歷集合（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個列表對象進行了組合，造成新的列表對象

<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>

四、分割標籤：用於將一個字符串進行分割，產生一個枚舉值列表，下面的代碼將分割成三個字符串，而後輸出

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

<s:iterator>

<s:property />

</s:iterator>

</s:generator>

五、合併標籤;用於將多個枚舉值按照數組的索引位置進行合併

<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>

六、排序標籤：用於對一組枚舉值進行排序，屬性comparator指向一個繼承java.util.Comparator的比較器，該比較器能夠是對action頁面中的一個比較器變量，source指定要排序的列表對象

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

<s:iterator>

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

</s:iterator>

</s:sort>

七、子集標籤;用於取得一個枚舉列表的子集，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>

2、數據輸出標籤

 數據輸出標籤用以輸出頁面中的元素、屬性、隱含變量等，即包括靜態文本的輸出，也包括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函數，excuteResult是否執行結果集的跳轉

<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')">

3、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表單標籤也很多,因此仍是要用的時候在網上找吧...

 4、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>標籤

 

5、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>

 

Struts2工做原理

Struts2請求響應流程：

 

（1）  客戶端（Client）向Action發用一個請求（Request）

（2）  Container經過web.xml映射請求，並得到控制器（Controller）的名字

（3）  容器（Container）調用控制器（StrutsPrepareAndExecuteFilter或FilterDispatcher）。在Struts2.1之前調用FilterDispatcher，Struts2.1之後調用StrutsPrepareAndExecuteFilter

（4）  控制器（Controller）經過ActionMapper得到Action的信息

（5）  控制器（Controller）調用ActionProxy

（6）  ActionProxy讀取struts.xml文件獲取action和interceptor stack的信息。

（7）  ActionProxy把request請求傳遞給ActionInvocation

（8）  ActionInvocation依次調用action和interceptor

（9）  根據action的配置信息，產生result

（10） Result信息返回給ActionInvocation

（11） 產生一個HttpServletResponse響應

（12） 產生的響應行爲發送給客服端。

 

 

Struts2.3.4 所需的Jar包及介紹

Jar包的分類	jar包名稱	jar包版本	jar包 文件名	jar包 的做用	jar包內包含的主要包路徑及主要類	依賴的自有jar包名稱	依賴的第三方jar包名稱	本jar包是否爲第三方包
Struts 2.3.4 的 核 心 包	struts2-core -2.3.4.jar	2.3.4	struts2-core -2.3.4	struts2的核心包	org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter	xwork-core -2.3.4.jar		否
	xwork-core -2.3.4.jar	2.3.4	xwork-core -2.3.4	xwork核心包	com.opensymphony.xwork2/ com.opensymphony.xwork2.cinfig/ com.opensymphony.xwork2.ognl/			否
	aopalliance.jar	1.0	aopalliance	這個包爲AOP提供了最普通和通用的接口	org.aopalliance.aop/org.aopalliance.aop.intercept			否
	commons-fileupload-1.2.2.jar	1.2.2	commons-fileupload-1.2.2	Struts文件的上傳下載	org.apacher.commons.fileupload/ org.apacher.commons.fileupload.util			否
	commons-lang 3-3.1.jar	3.3.1	commons-lang3-3.1	爲java.lang包提供擴展	org.apacher.commons.lang3/ org.apacher.commons.lang3.builder			否
	commons-logging -1.1.1.jar	1.1.1	commons-logging -1.1.1	Jakarta的通用日誌記錄包	org.apacher.commons.logging/org.apacher.commons.logging.impl			否
	freemarker-2.3.19.jar	2.3.19	freemarker-2.3.19	FreeMarker是一個模板引擎，一個基於模板生成文本輸出的通用工具				否
	ognl-3.0.5.jar	3.0.5	ognl-3.0.5	支持ognl表達式	Ognl			否
輔 助 Jar 包	struts2-spring -plugin-2.3.4.jar	2.3.4	struts2-spring -plugin-2.3.4	struts2和spring整合須要的包				否
	antlr-2.7.2.jar	2.7.2	antlr-2.7.2	它是這樣的一種工具,它能夠接受詞文法語言描述,並能產生識別這些語言的語句的程序
	asm-3.3.jar	3.3	asm-3.3	操做java字節碼的類庫
	asm-commons-3.3.jar	3.3	asm-commons-3.3	提供了基於事件的表現形式
	asm-tree-3.3.jar	3.3	asm-tree-3.3	提供了基於對象的表現形式
	classworlds-1.1.jar	1.1	classworlds-1.1	基於java操做類裝載的開發框架。java的classloader的機制和本地類能夠引發頭痛，多爲某些類型的應用程序開發的混亂。
	commons-beanutils-1.8.0.jar	1.8.0	commons-beanutils-1.8.0	jakarta commons項目中的一個子項目。這個項目開發的目的是幫助開發者動態的獲取/設值JavaBean的屬性，同時解決每次都要寫getXXX和setXXX的麻煩
	commons-chain-1.2.jar	1.2	commons-chain-1.2	Apache 的 Commons-Chain 項目已將命令模式(Command)和責任鏈(Chain of Responsebility)模式二者完美的結合
	commons-collections-3.1.jar	3.1	commons-collections-3.1	包含了一些Apache開發的集合類，擴展了標準的Java Collection框架，提供了額外的Map、List 和Set實現以及多個有用的工具類庫。功能比java.util.*強大。
	commons-digester-2.0.jar	2.0	commons-digester-2.0	Jakarta Struts中的一個工具，用於處理struts-config.xml配置文件
	commons-logging-api-1.1.jar	1.1	commons-logging-api-1.1	Apache Commons包中的一個，包含了一些數據類型工具類，是java.lang.*的擴展。
	commons-validator-1.3.1.jar	1.3.1	commons-validator-1.3.1	校驗方法)和校驗規則。支持校驗規則的和錯誤消息的國際化。 struts使用它對錶單進行驗證
	dwr-1.1.1.jar	1.1.1	dwr-1.1.1	Direct Web Remoting是一個WEB遠程調用框架.Java開發利用這個框架可讓AJAX開發變得很簡單.
	ezmorph-1.0.6.jar	1.0.6	ezmorph-1.0.6	EZMorph是一個簡單的java類庫用於將一種對象轉換成另一種對象。EZMorph原先是Json-lib項目中的轉換器。EZMorph支持原始數據類型（Primitive），對象（Object），多維護數組轉換與DynaBeans的轉換。struts2中，json的處理便使用了EZMorph庫
	google-collections-1.0.jar	1.0	google-collections-1.0	對現有Java集合類的一個擴展。
	jackson-core-asl-1.9.2.jar	1.9.2	jackson-core-asl-1.9.2	一個高性能的解析器的核心庫
	json-lib-2.3-jdk15.jar	2.3	json-lib-2.3-jdk15	提供了強大的JSON支持，利用Ajax提交上來的JSON字符串進行解析，能夠轉化爲POJO對象，能夠從POJO轉化爲js能夠識別的JSON對象。
	juli-6.0.18.jar	6.0.18	juli-6.0.18	用於tomcat 錯誤日誌查看
	oro-2.0.8.jar	2.0.8	oro-2.0.8	RO一套文本處理工具,能提供perl5.0兼容的正則表達式,AWK-like正則表達式, glob表達式。還提供替換,分割,文件名過慮等功能
	oval-1.31.jar	1.31	oval-1.31	OVal是一個提供事務和對象的可擴展驗證框架的任何類型的Java對象。
	plexus-container-default-1.0-alpha-10.jar	1.0	plexus-container-default-1.0-alpha-10	Plexus項目提供完整的軟件棧，用於建立和執行軟件項目。根據叢容器，應用程序能夠利用面向組件編程構建模塊化，它能夠輕易地組裝和重用可重用組件。根據Plexus容器，應用程序能夠利用面向組件編程構建模塊化，它能夠輕易地組裝和重用可重用組件。
	plexus-utils-1.2.jar	1.2	plexus-utils	Plexus項目提供完整的軟件棧，用於建立和執行軟件項目。根據叢容器，應用程序能夠利用面向組件編程構建模塊化，它能夠輕易地組裝和重用可重用組件。
	sitemesh-2.4.2.jar	2.4.2	sitemesh-2.4.2	SiteMesh是一個用來在JSP中實現頁面佈局和裝飾（layout and decoration）的框架組件，可以幫助網站開發人員較容易實現頁面中動態內容和靜態裝飾外觀的分離。
	struts2-codebehind-plugin-2.3.4.jar	2.3.4	struts2-codebehind-plugin-2.3.4	一般JSP頁面來自於文件系統。利用這個插件，你能夠將jsp頁面部署到jar包中
	struts2-config-browser-plugin-2.3.4.jar	2.3.4	struts2-config-browser-plugin-2.3.4	struts配置瀏覽器所須要的插件
	struts2-convention-plugin-2.3.4.jar	2.3.4	struts2-convention-plugin-2.3.4	在默認狀況下該公約插件查找操做類在如下軟件包支柱,struts2的行爲或行動,任何包相匹配這些名稱將被考慮做爲根包爲常規插件。
	struts2-dojo-plugin-2.3.4.jar	2.3.4	struts2-dojo-plugin-2.3.4	爲struts所提供的一些控件例如：日曆
	struts2-dwr-plugin-2.3.4.jar	2.3.4	struts2-dwr-plugin-2.3.4	用於整合DWR
	struts2-embeddedjsp-plugin-2.3.4.jar	2.3.4	struts2-embeddedjsp-plugin-2.3.4	用於將jsp頁面放在jar包中
	struts2-jasperreports-plugin-2.3.4.jar	2.3.4	struts2-jasperreports-plugin-2.3.4	用於整合JasperReports
	struts2-javatemplates-plugin-2.3.4.jar	2.3.4	struts2-javatemplates-plugin-2.3.4	Apache提供的'javatemplates'用於代替默認的Freemarker渲染器
	struts2-jfreechart-plugin-2.3.4.jar	2.3.4	struts2-jfreechart-plugin-2.3.4	struts2使用jfreechart的插件包
	struts2-jsf-plugin-2.3.4.jar	2.3.4	struts2-jsf-plugin-2.3.4	sturts整合jsf的插件包
	struts2-json-plugin-2.3.4.jar	2.3.4	struts2-json-plugin-2.3.4	struts2所用到的json插件包
	struts2-junit-plugin-2.3.4.jar	2.3.4	struts2-junit-plugin-2.3.4	struts所提供的junit調試
	struts2-osgi-plugin-2.3.4.jar	2.3.4	struts2-osgi-plugin-2.3.4	這個插件提供了支持啓動一個實例的Apache Felix在一個web應用程序,和掃描安裝的bundle的Struts配置。還提供了一個管理包
	struts2-oval-plugin-2.3.4.jar	2.3.4	struts2-oval-plugin-2.3.4	插件定義了攔截器」ovalValidation」和攔截器堆棧」ovalValidationStack」在「oval-default」包。使用這個攔截器,擴大「oval-default」」包
	struts2-plexus-plugin-2.3.4.jar	2.3.4	struts2-plexus-plugin-2.3.4	使用該插件,當配置Struts動做,攔截器,在Struts或結果。xml,設置class屬性包含叢對象id,而不是實際的Java類。這將容許叢來建立對象和注入任何依賴關係也由管理叢。
	struts2-portlet-plugin-2.3.4.jar	2.3.4	struts2-portlet-plugin-2.3.4	Portlet的插件,用於發展中JSR286 Portlet使用Struts
	struts2-rest-plugin-2.3.4.jar	2.3.4	struts2-rest-plugin-2.3.4	rest插件用於自動處理序列化,並反序列化每種格式。
	struts2-sitegraph-plugin-2.3.4.jar	2.3.4	struts2-sitegraph-plugin-2.3.4	生成一個web應用程序的圖形視圖
	struts2-struts1-plugin-2.3.4.jar	2.3.4	struts2-struts1-plugin-2.3.4	這個jar包是用於將strusts和spring進行整合的一個插件，在處理數據庫的事物時，經過這個插件將數據源配置到底層的sessionFactory中，而後再將sessionFactory注入到相應Dao層或者service層，在配置請求頁面的處理結果頁面配置struts.xml文件由spring進行管理的
	struts2-testng-plugin-2.3.4.jar	2.3.4	struts2-testng-plugin-2.3.4	這個插件是用來在單元測試,而不是在運行時。所以,它包含在您的構建的類路徑中,但不要將它部署WEB-INF/lib在Struts2的應用程序
	struts2-tiles-plugin-2.3.4.jar	2.3.4	struts2-tiles-plugin-2.3.4	這個插件能夠安裝插件jar複製到應用程序的WEB-INF/lib 目錄中
	struts2-tiles-plugin-2.3.4.jar	2.3.4	struts2-tiles-plugin-2.3.4	這個插件能夠安裝插件jar複製到應用程序的WEB-INF/lib 目錄中
	testng-5.1-jdk15.jar	5.1	testng-5.1-jdk15	TestNG是一個測試框架從JUnit和NUnit啓發,但該框架引入了一些新功能,使它更強大,也更容易使用。而該jar包就是用於整合使用該框架。
	tiles-api-2.0.6.jar	2.0.6	tiles-api-2.0.6	提供對tiles的支持：類和標記庫在一個JSP環境中使用tiles。
	tiles-core-2.0.6.jar	2.0.6	tiles-core-2.0.6	tiles核心庫,包括基本的實現的api。
	tiles-jsp-2.0.6.jar	2.0.6	tiles-jsp-2.0.6	提供對tilesJSP的支持:類和標記庫在一個JSP環境使用tiles。
	velocity-1.6.3.jar	1.6.3	velocity-1.6.3	Java模板技術-velocity
	xmlpull-1.1.3.1.jar	1.1.3.1	xmlpull-1.1.3.1	支持可擴展的XML
	xpp3_min-1.1.4c.jar	1.1.4	xpp3_min-1.1.4c	Java對象和XML之間相互轉換所需JAR包
	xstream-1.4.2.jar	1.4.2	xstream-1.4.2	xstream 提供對象和xml之間的轉換