简述Struts2 Convention零配置
從struts2.1開始,struts2不再推薦使用Codebehind作為零配置插件,而是改為使用Convention插件來支持零配置,和Codebehind相比,Convention插件更徹底,該插件完全拋棄配置信息,不僅不需要是使用struts.xml文件進(jìn)行配置,甚至不需要使用Annotation進(jìn)行配置,而是由struts2根據(jù)約定自動配置。
如何使用Convention
1.???????將struts-Convention-plugin-2.1.6.jar文件復(fù)制到WEB-INF/lib路徑下
2.???????對于Convention插件而言,它會自動搜索位于action,actions,struts,struts2包下的所有java類,Convention插件會把如下兩種java類當(dāng)成Action處理:
1)??所有實(shí)現(xiàn)了com.opensymphony.xwork2.Action的java類
2)??所有類名以Action結(jié)尾的java類
3.???????Convention插件還允許設(shè)置如下三個常量:
1)??struts.Convention.exclude.packges:指定不掃描哪些包下的java類,位于這些包結(jié)構(gòu)下的java類將不會自動映射成Action;
2)??struts.convention.package.locators:Convention插件使用該常量指定的包作為搜尋Action的根包。對于actions.fore.LoginAction類,按約定原本應(yīng)映射到/fore/login;如果將該常量設(shè)為fore,則該Action將會映射到/login
3)??struts.convention.action.packages:Convention插件以該常量指定包作為根包來搜索Action類。Convention插件除了掃描action,actions,struts,struts2四個包的類以外,還會掃描該常量指定的一個或多個包,Convention會試圖從中發(fā)現(xiàn)Action類。
注意:struts.convention.package.locators和struts.convention.action.packages兩個常量的作用比較微妙,開發(fā)者在利用這兩個常量時務(wù)必小心。
如:下面Action所在包被映射的命名空間如下:
com.fun.actions.LoginAction?映射到???/
com.fun.actions.myoffice.CarInfoAction?映射到?/myoffice
com.fun.struts.myoffice.EntINfoAction?映射到?/myofiice
4.???????映射Action的name時,遵循如下兩步規(guī)則:
1)??如果該Action類名包含Action后綴,將該Action類名的Action后綴去掉。否則不做任何處理。
2)??將Action類名的駝峰寫法(每個單詞首字母大寫、其他字母小寫的寫法)轉(zhuǎn)成中畫線寫法(所有字母小寫,單詞與單詞之間以中畫線隔開)
如:LoginAction映射的Acion的name屬性為login,GetBooks映射的Action的name的屬性為get-books,AddEmployeeAction映射的Action的name屬性為add-employee
5.???????默認(rèn)情況下。Convention總會到WEB應(yīng)用的WEB-INF/content路徑下定位物理資源,定位資源的約定是:actionRUL+resultCODE+suffix。當(dāng)某個邏輯視圖找不到對應(yīng)的試圖資源時,Convention會自動視圖使用ActionURL+suffix作為物理視圖資源。
???????如:actions.fore.LoginAction?返回success字符串時,Convention優(yōu)先考慮使用WEB-INF/content/fore目錄下的login-success.jsp作為視圖資源。如果找不到該文件,login.jsp也可作為對應(yīng)的試圖資源。如果返回input字符串,Convention會將WEB-INF/content/fore里面查找login-input.jsp
6.???????為了看到struts2應(yīng)用里的Action等各種資源的影射情況,struts2提供了Config Browser插件。使用方法,將struts2-config-browser-plugin-2.1.6.jar文件復(fù)制到struts2應(yīng)用的WEB-INF/lib目錄中。
打開首頁地址:http://localhost:8080/應(yīng)用名字/config-browser/actionNames.action這里可以看到Config Browser插件的首頁。
注意:這里不管開發(fā)者是否使用struts.xml文件進(jìn)行配置,一樣可以看到struts的配置信息。
7.Action鏈的約定
如果希望一個Action處理結(jié)束后不是進(jìn)入一個試圖頁面,而是進(jìn)行另一個Action形成的Action鏈。通過Convention插件則只需遵守如下三個約定即可。
1)??第一個Action返回的邏輯視圖字符串沒有對應(yīng)的視圖資源
2)??第二個Action與第一個Action處在同一個包下
3)??第二個Action影射的URL為:firstActionURL+resultCODE
如,第一個Action為OneAction,里面有個方法返回為“two”,那么就得保證,WEB-INF/content/下沒有one.jsp或one-two.jsp?對于第二個action?它的名字應(yīng)該是OneTwoAction,而對應(yīng)的url應(yīng)該是:“one-two.action”
注意:由于Convention插件根據(jù)Action和jsp頁面來動態(tài)生成映射的,因此不管是Acion的改變,還是JSP頁面的改變都需要Convention插件重新加載映射。那么只要我們?yōu)?span lang="EN-US">struts2應(yīng)用配置如下兩個常量就可以了。
<!--配置struts2應(yīng)用于開發(fā)模式--!>
<constant name=”struts.devMode” value=”true”/>
<!—配置Convention插件自動重加載映射--!>
<constant name=”struts.convention.classes.reload” value=”true”/>
幾個重要的常量
struts.convention.action.disableJarScanning---是否從包中搜索Action
struts.convention.action.package--------Convention插件以該常量指定包作為根包
struts.convention.result.path ---設(shè)置Convention插件定位視圖資源的根路徑。默認(rèn)值為/WEB-INF/content
struts.convention.result.flatLayout—如果是為false則可以將試圖放置Action對應(yīng)的目錄下,無需放入WEB-INF/content
7.???????Convention的Annotation
1)??與Action相關(guān)的兩個Annotation是@Action?和@Actions
2)??@Action中可指定一個value屬性。類似于指定<action name=””/>屬性值
3)??@Action中還可以指定一個params屬性,該屬性是一個字符串?dāng)?shù)組,用于該Acion指定的參數(shù)名和參數(shù)值。params屬性應(yīng)遵守如下格式:{“name1”,”value1”,”name2”,”value2”}
4)??@Actions?也用于修飾Action類里的方法,用于將該方法映射到多個URL.@Actions用于組織多個@Action.因此它可將一個方法映射成多個邏輯Action。
如:
package?com.fun.actions;
?
?
?
import?org.apache.struts2.convention.annotation.Action;
import?org.apache.struts2.convention.annotation.Actions;
?
import?com.fun.service.LoginService;
import?com.opensymphony.xwork2.ActionSupport;
?
public?class?LoginAction?extends?ActionSupport {
????private?String?str;
????@Actions({
???????@Action(value="login1",params={"str","這是已經(jīng)注入的了!"}),
???????@Action(value="login2")
??????
????})
????public?String login(){
???????return?"str";
????}
????@Action(value="ggg")
????public?String abc(){
???????return?"abc";
????}
????public?String getStr() {
???????return?str;
????}
????public?void?setStr(String str) {
???????this.str?= str;
????}
???
}
我們可以通過/login1.action訪問,而在訪問時,str這個屬性已經(jīng)有值,為str=”這是已經(jīng)注入的!”?返回的視圖是login1-str.jsp
當(dāng)我們用/login2.action訪問時,str的值為null。返回的視圖為?login2-str.jsp
而我們通過/ggg.action調(diào)用的是abc()方法,返回的視圖為/ggg-abc.jsp
8.???????與Result配置相關(guān)的Annotation
1)@ResultPath @Result?和Results
2)@Results用于組織多個@Result因此它只需指定一個value屬性值,該value屬性值為多個@Result
3)@Result相當(dāng)于struts.xml文件中的<result/>元素的做喲歐諾個。使用@Result必須指定一個name屬性,相當(dāng)于<result name=””/>另外,它還有幾個可選的屬性。
?????☆?type?相當(dāng)于<result type=””/>指定返回視圖資源的類型
?????☆?location?相當(dāng)于<result>…..</result>中間部分,用于指定實(shí)際視圖位置
?????☆?params:該屬性相當(dāng)于<result/>元素里多個<param../>子元素的作用,用于為該Result指定參數(shù)值。該屬性應(yīng)滿足{“name1”,”value1”,”name2”,”value2”}格式
4)@Result有以下兩種用法
1 Action級的Result映射:以@Actions組合多個@Action后修飾的Action類。這種Result映射對該Action里的所有方法都有效。
2方法級Result映射:將多個@Result組成數(shù)組后作為@Action的results屬性值。這種Result映射僅對被修飾的方法有效。
5)@ResultPath則用于修飾包和Action類,用于改變被修飾Action所對應(yīng)的物理視圖資源的根路徑。舉例說:默認(rèn)情況下,Convention都會到WEB-INF/content路徑下找物理視圖資源,一旦我們使用@ResultPath(“/abc”)修飾該Action,系統(tǒng)將回到abc目錄下尋找物理視圖資源。舉例:在默認(rèn)情況下,Convention都會到WEB-INF/content路徑下需找物理視圖資源,一旦我們使用@ResultPath(“/abc”)修飾該Action,系統(tǒng)會到abc目錄下尋找物理視圖資源。
?
9?與包和命名空間相關(guān)的Annotation:
???@Namespace:修飾Action類或其所在的包。該Annotation中指定一個value屬性值,用于指定被修飾的Action所在的命名空間
??@Namespaces:修飾Action類或其所在的包,用于組合多個@Namespace
??@ParentPackage:?用于指定被修飾的Action所在包的夫包。
10?異常處理相關(guān)的Annotation
??@ExceptionMappings?用于組織多個@ExceptionMapping,因此它只需指定一個value屬性值,該value屬性值為多個@ExceptionMapping。
?@ExceptionMapping?用于定義異常類和物理視圖之間的對應(yīng)關(guān)系,也相當(dāng)于struts.xml文件里<exception-mapping../>元素的作用?使用時,必須注意以下兩個屬性:
??exception:?用于指定異常類
??result?:?用于指定邏輯視圖
@ExceptionMpping有如下兩種用法
???Action級的異常定義:以@ExceptionMappings組合多個@ExceptionMapping后修飾的Action類。這種異常定義對Action中的所有方法有效
??方法級的異常定義:?將多個@ExceptionMapping組成數(shù)組后作為@Action的exceptionMappings屬性值,這種異常定義僅對被修飾的方法有效。
?
11.攔截器配置相關(guān)的Annotation
?與攔截器配置的Annotation有@InterceptorRef、@InterceptorRefs和@DefaultInterceptorRef
@InterceptorRefs用于組織多個@InterceptorRef,因此它只需要指定一個value屬性值,該value屬性值為多個@InterceptorRef
@InterceptorRef用于為指定Action引用lanjieq或者是攔截器棧。也就相當(dāng)于strut.xml中位于<action../>元素內(nèi)部的<interceptor-ref../>子元素的作用。使用@InterceptorRefAnnotation時,必須制定一個value屬性,用于指定所引用的攔截器或攔截器棧的名字。相當(dāng)于<interceptor-ref../>子元素里name屬性的作用。
總結(jié)
以上是生活随笔為你收集整理的简述Struts2 Convention零配置的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: Hadoop框架:DataNode工作机
- 下一篇: NetBeans 时事通讯(刊号 # 1