struts.xml文件結(jié)構(gòu)
struts.xml文件是整個(gè)Struts2框架的核心。
struts.xml文件內(nèi)定義了Struts2的系列Action,定義Action時(shí),指定該Action的實(shí)現(xiàn)類,并定義該Action處理結(jié)果與視圖資源之間的映射關(guān)系。
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE struts PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
"http://struts.apache.org/dtds/struts-2.0.dtd">
<struts>
<package name="example" namespace="/example" extends="struts-default">
<!-- 定義一個(gè)Action名稱為HelloWorld,實(shí)現(xiàn)類為example.HelloWorld.java-->
<action name="HelloWorld" class="example.HelloWorld">
<!-- 任何情況下都轉(zhuǎn)入到/example/HelloWorld.jsp -->
<result>/example/HelloWorld.jsp</result>
</action>
<action name="Login_*" method="{1}" class="example.Login">
<!-- 返回input時(shí),轉(zhuǎn)入到/example/login.jsp -->
<result name="input">/example/Login.jsp</result>
<!-- 重定向到Menu的Action -->
<result type="redirect-action">Menu</result>
</action>
<action name="*" class="example.ExampleSupport">
<result>/example/{1}.jsp</result>
</action>
</package>
</struts>
*<result name="input">/example/Login.jsp</result>
以上表示當(dāng)execute方法返回input的字符串時(shí),跳轉(zhuǎn)到/example/Login.jsp。定義rusult元素時(shí),可以指定兩個(gè)屬性:type和name。其中name指定了execute方法返回的字符串,而type指定轉(zhuǎn)向的資源類型,此處轉(zhuǎn)向的資源可以是JSP,也可以是FreeMarker等,甚至是另一個(gè)Action。
加載子配置文件
Struts2框架的核心配置文件就是struts.xml配置文件,該文件主要負(fù)責(zé)管理Struts2框架的業(yè)務(wù)控制器Action。
在默認(rèn)情況下,Struts2框架將自動(dòng)加載放在WEB-INF/classes路徑下的struts.xml文件。為了避免隨著應(yīng)用規(guī)模的增加,而導(dǎo)致的struts.xml文件過(guò)于龐大,臃腫,從而是該文件的可讀性下降。我們可以將一個(gè)struts.xml配置文件分解成多個(gè)配置文件,然后在struts.xml文件中包含其他配置文件。
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE struts PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
"http://struts.apache.org/dtds/struts-2.0.dtd">
<!--根元素-->
<struts>
<constant name="struts.enable.DynamicMethodInvocation" value="false" />
<constant name="struts.devMode" value="false" />
<!--通過(guò)include元素導(dǎo)入其他元素-->
<include file="example.xml"/>
</struts>
通過(guò)這種方式,Struts2提供了一種模塊化的方式來(lái)管理struts.xml配置文件。
Package配置
Struts2框架使用包來(lái)管理Action和攔截器等。每個(gè)包就是多個(gè)Action、多個(gè)攔截器、多個(gè)攔截器引用的集合。使用package可以將邏輯上相關(guān)的一組Action,Result,Intercepter等組件分為一組,Package有些想對(duì)象,可以繼承其他的Package,也可以被其他package繼承,甚至可以定義抽象的Package。
Package的可以使用的屬性:
屬性 是否必須 說(shuō)明
name 是 Package的表示,為了讓其他的package引用
extends 否 從哪個(gè)package集成行為
namespace 否 參考Namespace配置說(shuō)明
abstract 否 定義這個(gè)package為抽象的,這個(gè)package中不需要定義action
package元素用于定義包配置,每個(gè)package元素定義了一個(gè)包配置。定義package元素時(shí)可以指定如下幾個(gè)屬性:
name:必填,指定包的名字,該名字是該包被其他包引用的key。
extends:可選,指定該包繼承其他包。繼承其他包,可以繼承其他包中的Action定義、攔截器定義等。
namespace:可選,定義該包的命名空間。
abstract:可選,它指定該包是否是一個(gè)抽象包。抽象包不能包含Action定義。
*由于struts.xml文件是自上而下解析的,所以被集成的package要放在集成package的前邊。
Namespace配置(命名空間配置)
Struts2以命名空間的方式來(lái)管理Action,同一個(gè)命名空間里不能有同名的Action,不同的命名空間里可以有同名的Action。Struts2不支持為單獨(dú)的Action設(shè)置命名空間,而是通過(guò)為包指定namespace屬性來(lái)為包下面的所有Action指定共同的命名空間。
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,則畫(huà)面將定為到bar2.jsp
2 如果請(qǐng)求為/moo.action
根namespace('/')被查找,如果moo action存在則執(zhí)行否則查詢默認(rèn)的namespace,上面的例子中,根namespace中存在moo action,所以改action被調(diào)用,返回success的情況下畫(huà)面將定位到moo.jsp。
又例:
<struts>
<constant name="struts.custom.i18n.resources" value="messageResource"/>
<package name="lee" extends="struts-default">
<action name="login" class="lee.LoginAction">
<result name="input">/login.jsp</result>
<result name="error">/error.jsp</result>
<result name="success">/welcome.jsp</result>
</action>
</package>
<package name="get" extends="struts-default" namespace="/book">
<action name="getBooks" class="lee.GetBooksAction">
<result name="login">/login.jsp</result>
<result name="success">/showBook.jsp</result>
</action>
</package>
</struts>
以上代碼配置了兩個(gè)包:lee和get,配置get包時(shí),指定了該包的命名空間為/book。對(duì)于名為lee的包而言,沒(méi)有指定namespace屬性。如果某個(gè)包沒(méi)有指定namespace屬性,即該包使用默認(rèn)的命名空間,則默認(rèn)的命名空間總是""。
需要注意的問(wèn)題有兩個(gè):
默認(rèn)命名空間里的Action可以處理任何模塊下的Action請(qǐng)求。
即:如果存在URL為/book/GetBooks.action的請(qǐng)求,并且/book的命名空間沒(méi)有名為GetBooks的Action,則默認(rèn)命名空間下名為GetBooks的Action也會(huì)處理用戶請(qǐng)求。
當(dāng)某個(gè)包指定了命名空間后,該包下所有的Action處理的URL應(yīng)該是命名空間+Action名。
以上面的get的包為例,該包下包含了名為getBooks的Action,則該Action處理的URL為:
http://localhost:8080/namespace/book/GetBooks.action
*namespace是應(yīng)用名,book是該Action所有包對(duì)應(yīng)的命名空間,GetBooks是Action名。
Action配置
配置Action就是讓Struts2容器知道該Action的存在,并且能調(diào)用該Action來(lái)處理用戶請(qǐng)求。因此,我們認(rèn)為:Action是Struts2的基本“程序單位”。即,在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)用。Action只是一個(gè)控制器,它并不直接對(duì)瀏覽者生成任何響應(yīng),因此,Action處理完用戶請(qǐng)求后,Action需要將指定的視圖資源呈現(xiàn)給用戶。因此,配置Action時(shí),應(yīng)該配置邏輯視圖和物理視圖資源之間的映射。
Struts2使用包來(lái)組織Action,因此,將Action的定義是放在包定義下完成的,定義Action通過(guò)使用package下的action子元素來(lái)完成。至少需要指定該Action的name屬性,該name屬性既是該Action的名字,也是該Action需要處理的URL的前半部分。除此之外,通常還需要為action元素指定一個(gè)class屬性,其中class屬性指定了該Action的實(shí)現(xiàn)類。
一個(gè)簡(jiǎn)單的例子:
<package name="lee" extends="struts-default">
<action name="login" class="lee.LoginAction">
<result name="input">/login.jsp</result>
<result name="error">/error.jsp</result>
<result name="success">/welcome.jsp</result>
</action>
</package>
一個(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)命名,最好使用英文字母和下劃線。
1,Action中的方法
Action的默認(rèn)入口方法由xwork2的Action接口來(lái)定義,代碼清單為:
public interface Action {
public String execute() throws Exception;
}
有些時(shí)候我們想指定一個(gè)Action的多個(gè)方法,我們可以做如下兩步:
建立一些execute簽名相同的方法,例如:
Public String forward() throws Exception
在Action配置的時(shí)候使用method屬性,例如:
<action name="delete" class="example.CrudAction" method="delete">
2,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é)合使用框架的所有其他功能。
3,默認(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。
4,Post-Back Action
可以使用如下畫(huà)面達(dá)到字畫(huà)面刷新的效果
<s:form>
<s:textfield label="Please enter your name" name="name"/>
<s:submit/>
</s:form>
4,默認(rèn)Action
通常情況下,請(qǐng)求的Action不存在的情況下,Struts2框架會(huì)返回一個(gè)Error畫(huà)面:“404 - Page not found”,有些時(shí)候或許我們不想出現(xiàn)一個(gè)控制之外的錯(cuò)誤畫(huà)面,我們可以指定一個(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>
</package>
5,默認(rèn)通配符
<action name="*" >
<result>/{1}.jsp</result>
</action>
每個(gè)Action將會(huì)被映射到以自己名字明明的JSP上。
本站僅提供存儲(chǔ)服務(wù),所有內(nèi)容均由用戶發(fā)布,如發(fā)現(xiàn)有害或侵權(quán)內(nèi)容,請(qǐng)
點(diǎn)擊舉報(bào)。