struts2筆記 - 配置
與Struts 1.X不同,Struts2引入了WebWork的配置機(jī)制,在很大程度上提高了配置的靈活度。通過(guò)使用配置可以配置如下內(nèi)容:
配置類型 |
配置文件 |
Struts2 參數(shù)配置 |
struts.properties |
Struts2 Action 配置 |
struts.xml |
Struts2 Result 配置 |
struts.xml |
Struts2 Exception Handling 配置 |
struts.xml |
Struts2 Intercept 配置 |
struts.xml |
Struts2 多配置文件 |
struts.xml |
struts.properties文件在WEB-INF/classes目錄下存放。
這個(gè)文件用來(lái)配置Struts2系統(tǒng)的一些基本規(guī)約,所有在struts.properties中配置的內(nèi)容都可以在struts.xml中配置,或者web.xml中在struts2 filter中配置,例如:
Struts.properties中的如下配置:
struts.i18n.encoding=UTF-8
相當(dāng)于struts.xml中的如下配置:
<constant name=“struts.i18n.encoding” value=“true” />
相當(dāng)于web.xml中的如下配置:
<filter>
<filter-name>struts</filter-name>
<filter-class>org.apache.struts2.dispatcher.FilterDispatcher</filter-class>
<init-param>
<param-name>struts.i18n.encoding</param-name>
<param-value>true</param-value>
</init-param>
</filter>
Package配置
使用package可以將邏輯上相關(guān)的一組Action,Result,Intercepter等組件分為一組,Package有些想對(duì)象,可以繼承其他的Package,也可以被其他package繼承,甚至可以定義抽象的Package。
Package的可以使用的屬性:
屬性 |
是否必須 |
說(shuō)明 |
name |
是 |
Package的表示,為了讓其他的package引用 |
extends |
否 |
從哪個(gè)package集成行為 |
namespace |
否 |
參考Namespace配置說(shuō)明 @TODO Namespace配置說(shuō)明 |
abstract |
否 |
定義這個(gè)package為抽象的,這個(gè)package中不需要定義action |
由于struts.xml文件是自上而下解析的,所以被集成的package要放在集成package的前邊。
Namespace配置
Namespace將action分成邏輯上的不同模塊,每一個(gè)模塊有自己獨(dú)立的前綴。使用namespace可以有效的避免action重名的沖突,例如每一個(gè)package都可以有自己獨(dú)立的Menu和Help action,但是事項(xiàng)方式各有不同。Struts2標(biāo)簽帶有namespace選項(xiàng),可以根據(jù)namespace的不同向服務(wù)器提交不同的package的action的請(qǐng)求。
“/”表示跟namespace,所有直接在應(yīng)用程序上下文環(huán)境下的請(qǐng)求(Context)都在這個(gè)package中查找。
“”表示默認(rèn)namespace,當(dāng)所有的namespace中都找不到的時(shí)候就在這個(gè)namespace中尋找,例如我們上面的login應(yīng)用程序。
例如,有如下配置:
<package name="default">
<action name="foo" class="mypackage.simpleAction>
<result name="success" type="dispatcher">
greeting.jsp
</result>
</action>
<action name="bar" class="mypackage.simpleAction">
<result name="success" type="dispatcher">bar1.jsp</result>
</action>
</package>
<package name="mypackage1" namespace="/">
<action name="moo" class="mypackage.simpleAction">
<result name="success" type="dispatcher">moo.jsp</result>
</action>
</package>
<package name="mypackage2" namespace="/barspace">
<action name="bar" class="mypackage.simpleAction">
<result name="success" type="dispatcher">bar2.jsp</result>
</action>
</package>
1 如果請(qǐng)求為/barspace/bar.action
查找namespace/barspace,如果找到bar則執(zhí)行對(duì)應(yīng)的action,否則將會(huì)查找默認(rèn)的namespace,在上面的例子中,在barspace中存在名字位bar的action,所以這個(gè)action將會(huì)被執(zhí)行,如果返回結(jié)果為success,則畫面將定為到bar2.jsp
2 如果請(qǐng)求為/ moo.action
根namespace('/')被查找,如果moo action存在則執(zhí)行否則查詢默認(rèn)的namespace,上面的例子中,根namespace中存在moo action,所以改action被調(diào)用,返回success的情況下畫面將定位到moo.jsp
Action配置
在struts2框架中每一個(gè)Action是一個(gè)工作單元。Action負(fù)責(zé)將一個(gè)請(qǐng)求對(duì)應(yīng)到一個(gè)Action處理上去,每當(dāng)一個(gè)Action類匹配一個(gè)請(qǐng)求的時(shí)候,這個(gè)Action類就會(huì)被Struts2框架調(diào)用。
一個(gè)Action配置示例:
<action name="Logon" class="tutorial.Logon">
<result type="redirect-action">Menu</result>
<result name="input">/tutorial/Logon.jsp</result>
</action>
每一個(gè)Action可以配置多個(gè)result,多個(gè)ExceptionHandler,多個(gè)Intercepter,但是只能有一個(gè)name,這個(gè)name和package的namespace來(lái)唯一區(qū)別一個(gè)Action。
每當(dāng)struts2框架接受到一個(gè)請(qǐng)求的時(shí)候,他會(huì)去掉Host,Application和后綴等信息,得到Action的名字,例如如下的請(qǐng)求將得到Welcome這個(gè)Action。
http://www.planetstruts.org/struts2-mailreader/Welcome.action
在一個(gè)Struts2應(yīng)用程序中,一個(gè)指向Action的鏈接通常有Struts Tag產(chǎn)生,這個(gè)Tag只需要指定Action的名字,Struts框架會(huì)自動(dòng)添加諸如后綴等的擴(kuò)展,例如:
<s:form action="Hello">
<s:textfield label="Please enter your name" name="name"/>
<s:submit/>
</s:form>
將產(chǎn)生一個(gè)如下的鏈接的請(qǐng)求:
http://Hostname:post/appname/Hello.action
在定義Action的名字的時(shí)候不要使用.和/來(lái)明明,最好使用英文字母和下劃線。
Action中的方法
Action的默認(rèn)入口方法由xwork2的Action接口來(lái)定義,代碼清單為:
public interface Action {
public String execute() throws Exception;
}
有些時(shí)候我們想指定一個(gè)Action的多個(gè)方法,我們可以做如下兩步:
<!--[if !supportLists]-->1 <!--[endif]-->建立一些execute簽名相同的方法,例如:
Public String forward() throws Exception
<!--[if !supportLists]-->2 <!--[endif]-->在Action配置的時(shí)候使用method屬性,例如:
<action name="delete" class="example.CrudAction" method="delete">
Action中的方法通配符
有些時(shí)候?qū)ction中方法的調(diào)用滿足一定的規(guī)律,例如edit Action對(duì)應(yīng)edit方法,delete Action對(duì)應(yīng) delete方法,這個(gè)時(shí)候我們可以使用方法通配符,例如:
<action name="*Crud" class="example.Crud" method="{1}">
這時(shí),editCrud Action的引用將調(diào)用edit方法,同理,deleteCrud Action的引用將調(diào)用delete 方法。
另外一種比較常用的方式是使用下劃線分割,例如:
<action name="Crud_*" class="example.Crud" method="{1}">
這樣當(dāng)遇到如下調(diào)用的時(shí)候可以找到對(duì)應(yīng)的方法。
"action=Crud_input" => input方法
"action=Crud_delete" => delete方法
通配符和普通的配置具有相同的地位,可以結(jié)合使用框架的所有其他功能。
默認(rèn)的Action
當(dāng)我們沒(méi)有指定Action的class屬性的時(shí)候,例如:
<action name="Hello">
我們默認(rèn)使用com.opensymphony.xwork.ActionSupport
ActionSupport有兩個(gè)方法input和execute,每個(gè)方法都是簡(jiǎn)單的返回SUCCESS。
Post-Back Action
可以使用如下畫面達(dá)到字畫面刷新的效果
<s:form>
<s:textfield label="Please enter your name" name="name"/>
<s:submit/>
</s:form>
默認(rèn)Action
通常情況下,請(qǐng)求的Action不存在的情況下,Struts2框架會(huì)返回一個(gè)Error畫面:“404 - Page not found”,有些時(shí)候或許我們不想出現(xiàn)一個(gè)控制之外的錯(cuò)誤畫面,我們可以指定一個(gè)默認(rèn)的Action,在請(qǐng)求的Action不存在的情況下,調(diào)用默認(rèn)的Action,通過(guò)如下配置可以達(dá)到要求:
<package name="Hello" extends="action-default">
<default-action-ref name="UnderConstruction">
<action name="UnderConstruction">
<result>/UnderConstruction.jsp</result>
</action>"
默認(rèn)通配符
<action name="*" >
<result>/{1}.jsp</result>
</action>
每個(gè)Action將會(huì)被映射到以自己名字明明的JSP上。
Result配置
Action里提供了五個(gè)默認(rèn)的返回值:
String SUCCESS = "success";
String NONE = "none";
String ERROR = "error";
String INPUT = "input";
String LOGIN = "login";
默認(rèn)的一些配置
在package下有如下配置
<result-types>
<result-type name="dispatcher"
class="org.apache.struts2.dispatcher.ServletDispatcherResult"
default="true" />
</result-types>
如果一個(gè)Result的type沒(méi)有設(shè)定的話,默認(rèn)為dispthcher。Dispatcher的意思是轉(zhuǎn)向一個(gè)JSP等的資源。
另外如果Result的name沒(méi)有設(shè)定的話,默認(rèn)為SUCCESS。
一個(gè)完整的Result的聲明如下:
<result name="success" type="dispatcher">
<param name="location">/ThankYou.jsp</param>
</result>
考慮到默認(rèn)值可以寫成:
<result>
<param name="location">/ThankYou.jsp</param>
</result>
另外也可以簡(jiǎn)寫為:
<result>/ThankYou.jsp</result>
另外為了方便,可以在package中設(shè)置一些全局的result,例如:
<global-results>
<result name="error">/Error.jsp</result>
<result name="invalid.token">/Error.jsp</result>
<result name="login" type="redirect-action">Logon_input</result>
</global-results>
動(dòng)態(tài)結(jié)果
有些時(shí)候,在Action執(zhí)行完畢之后才知道Result的指向,可以使用如下的方法:
Action
private String nextAction;
public String getNextAction() {
return nextAction;
}
public String execute() throws Exception {
return “next”;
}
struts.xml
<action name="fragment" class="FragmentAction">
<result name="next" type="redirect-action">${nextAction}</result>
</action>
3.4節(jié) ActionSupport
Action類不一定非要實(shí)現(xiàn)Action接口或者集成ActionSupport類,也就是說(shuō)Action可以是一個(gè)POJO對(duì)象,只不過(guò)提供一個(gè)返回String的方法。如果Action類不實(shí)現(xiàn)Action接口,也不從ActionSupport集成,則Struts框架通過(guò)Java的反射機(jī)制(Reflection)來(lái)調(diào)用Action類中的處理方法。
Action類的處理方法需要滿足以下要求
1 public
2 返回String,框架根據(jù)返回值決定遷移的目的
3 (可選)拋出Exception,讓Struts框架統(tǒng)一處理異常
3.5節(jié) Exception Handling
Struts可以以聲明的方式處理Action類拋出的異常。以聲明的方式處理是指:所有的Action類的處理方法拋出的Exception會(huì)被框架統(tǒng)一處理,之后定向到預(yù)先定義的Result。處理這些異常的Action,Result等可以動(dòng)態(tài)的配置。
Struts2自帶一個(gè)默認(rèn)的配置:struts-default.xml,在這個(gè)文件中預(yù)先定義了一些基本的操作,其中Exception Handling也在其中,參看下述代碼:
...
<interceptors>
...
<interceptor name="exception"
class="com.opensymphony.xwork.interceptor.ExceptionMappingInterceptor"/>
...
</interceptors>
<interceptor-stack name="defaultStack">
<interceptor-ref name="exception"/>
<interceptor-ref name="alias"/>
<interceptor-ref name="servlet-config"/>
<interceptor-ref name="prepare"/>
<interceptor-ref name="i18n"/>
<interceptor-ref name="chain"/>
<interceptor-ref name="debugging"/>
<interceptor-ref name="profiling"/>
<interceptor-ref name="scoped-model-driven"/>
<interceptor-ref name="model-driven"/>
<interceptor-ref name="fileUpload"/>
<interceptor-ref name="checkbox"/>
<interceptor-ref name="static-params"/>
<interceptor-ref name="params"/>
<interceptor-ref name="conversionError"/>
<interceptor-ref name="validation">
<param name="excludeMethods">input,back,cancel,browse</param>
</interceptor-ref>
<interceptor-ref name="workflow">
<param name="excludeMethods">input,back,cancel,browse</param>
</interceptor-ref>
</interceptor-stack>
...
要使用Struts2聲明式異常處理,只需要將異常映射到result就可以了,可以用兩種方法配置,一種方法是全局配置,針對(duì)所有的Action有效,另一種是針對(duì)具體的Action做配置,只針對(duì)具體的Action有效。
參看如下struts.xml 配置文件片段:
<package name="default">
...
<global-results>
<result name="login" type="redirect">/Login.action</result>
<result name="Exception">/Exception.jsp</result>
</global-results>
<global-exception-mappings>
<exception-mapping
exception="java.sql.SQLException" result="SQLException"/>
<exception-mapping
exception="java.lang.Exception" result="Exception"/>
</global-exception-mappings>
...
<action name="DataAccess" class="com.company.DataAccess">
<exception-mapping
exception="com.company.SecurityException" result="login"/>
<result name="SQLException" type="chain">SQLExceptionAction</result>
<result>/DataAccess.jsp</result>
</action>
...
</package>
上述配置有如下結(jié)果
1 一個(gè)java.sql.SQLException異常將鏈接到SQLExceptionAction (上述文件中沒(méi)有說(shuō)明)
2 一個(gè)com.company.SecurityException將重新定位到login.action
3 其他從java.lang.Exception繼承而來(lái)的Exception將會(huì)被定為到/Exception.jsp頁(yè)面
3.6節(jié) Intercepter攔截器
攔截器的運(yùn)行時(shí)機(jī)在Action類運(yùn)行之前和之后。攔截器使用Filter模式,將你需要執(zhí)行的代碼放在Action類處理方法之前或者之后執(zhí)行。攔截器在開(kāi)發(fā)程序的時(shí)候功能非常強(qiáng)大,通過(guò)使用攔截器可以完成校驗(yàn),屬性設(shè)置,安全,日志,程序剖析等功能。
攔截器可以彼此鏈接構(gòu)成一個(gè)攔截器的棧,每一個(gè)攔截器本質(zhì)上是一個(gè)Java類,都有一個(gè)常常的類名,為了方便使用,可以在Struts2框架中注冊(cè)這些攔截器,例如:
<interceptor name="security" class="com.jpleasure.security.SecurityInterceptor"/>
<interceptor-stack name="secureStack">
<interceptor-ref name="security"/>
<interceptor-ref name="defaultStack"/>
</interceptor-stack>
</interceptors>
攔截器和攔截器棧可以混合使用來(lái)定義新的攔截器棧,在調(diào)用過(guò)程中,框架按照在攔截器棧中的順序逐個(gè)調(diào)用這些攔截器。
可以在Package中定義默認(rèn)的攔截器棧,例如:
<default-interceptor-ref name="secureStack"/>
當(dāng)然每一個(gè)Action類也可以定義自己的攔截器棧,例如:
<action name="VelocityCounter"
class="org.apache.struts2.example.counter.SimpleCounter">
<result name="success">...</result>
<interceptor-ref name="defaultComponentStack"/>
</action>
3.7節(jié) 分離配置文件
可以在struts.xml中使用include標(biāo)記將配置文件分離成不同的部分。
例如:
<!DOCTYPE struts PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
"http://struts.apache.org/dtds/struts-2.0.dtd">
<struts>
<include file="Home.xml"/>
<include file="Hello.xml"/>
<include file="Simple.xml"/>
<include file="/util/POJO.xml"/>
</struts>
posted on 2008-10-08 14:36 Sky Yi 閱讀(712) 評(píng)論(0) 編輯 收藏