struts2中struts.xml詳細說明

struts.xml文件結構 struts.xml文件是整個Struts2框架的核心。
struts.xml文件內定義了Struts2的系列Action,定義Action時,指定該Action的實現類,並定義該Action處理結果與視圖資源之間的映射關係。
< ?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">
< !-- 定義一個Action名稱爲HelloWorld,實現類爲example.HelloWorld.java-->
<action name="HelloWorld" class="example.HelloWorld">
< !-- 任何情況下都轉入到/example/HelloWorld.jsp -->
<result>/example/HelloWorld.jsp</result>
< /action>

< action name="Login_*" method="{1}" class="example.Login">
< !-- 返回input時,轉入到/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>
以上表示當execute方法返回input的字符串時,跳轉到/example/Login.jsp。定義rusult元素時,可以指定兩個屬性:type和name。其中name指定了execute方法返回的字符串,而type指定轉向的資源類型,此處轉向的資源可以是JSP,也可以是FreeMarker等,甚至是另一個Action。

加載子配置文件
Struts2框架的核心配置文件就是struts.xml配置文件,該文件主要負責管理Struts2框架的業務控制器Action。
在默認情況下,Struts2框架將自動加載放在WEB-INF/classes路徑下的struts.xml文件。爲了避免隨着應用規模的增加,而導致的struts.xml文件過於龐大,臃腫,從而是該文件的可讀性下降。我們可以將一個struts.xml配置文件分解成多個配置文件,然後在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" />
< !--通過include元素導入其他元素-->
<include file="example.xml"/>
< /struts>
通過這種方式,Struts2提供了一種模塊化的方式來管理struts.xml配置文件。

Package配置
Struts2框架使用包來管理Action和攔截器等。每個包就是多個Action、多個攔截器、多個攔截器引用的集合。使用package可以將邏輯上相關的一組Action,Result,Intercepter等組件分爲一組,Package有些想對象,可以繼承其他的Package,也可以被其他package繼承,甚至可以定義抽象的Package。
Package的可以使用的屬性:
屬性 是否必須 說明

name 是 Package的表示,爲了讓其他的package引用
extends 否 從哪個package集成行爲
namespace 否 參考Namespace配置說明
abstract 否 定義這個package爲抽象的,這個package中不需要定義action

package元素用於定義包配置,每個package元素定義了一個包配置。定義package元素時可以指定如下幾個屬性:
name:必填,指定包的名字,該名字是該包被其他包引用的key。
extends:可選,指定該包繼承其他包。繼承其他包,可以繼承其他包中的Action定義、攔截器定義等。
namespace:可選,定義該包的命名空間。
abstract:可選,它指定該包是否是一個抽象包。抽象包不能包含Action定義。

*由於struts.xml文件是自上而下解析的,所以被集成的package要放在集成package的前邊。

Namespace配置(命名空間配置)
Struts2以命名空間的方式來管理Action,同一個命名空間裏不能有同名的Action,不同的命名空間裏可以有同名的Action。Struts2不支持爲單獨的Action設置命名空間,而是通過爲包指定namespace屬性來爲包下面的所有Action指定共同的命名空間。
Namespace將action分成邏輯上的不同模塊,每一個模塊有自己獨立的前綴。使用namespace可以有效的避免action重名的衝突,例如每一個package都可以有自己獨立的Menu和Help action,但是事項方式各有不同。Struts2標籤帶有namespace選項,可以根據namespace的不同向服務器提交不同的package的action的請求。
“/”表示根namespace,所有直接在應用程序上下文環境下的請求(Context)都在這個package中查找。
“”表示默認namespace,當所有的namespace中都找不到的時候就在這個namespace中尋找,例如我們上面的login應用程序。
例如,有如下配置:
<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 如果請求爲/barspace/bar.action
查找namespace/barspace,如果找到bar則執行對應的action,否則將會查找默認的namespace,在上面的例子中,在barspace中存在名字位bar的action,所以這個action將會被執行,如果返回結果爲success,則畫面將定爲到bar2.jsp
2 如果請求爲/moo.action
根namespace('/')被查找,如果moo action存在則執行否則查詢默認的namespace,上面的例子中,根namespace中存在moo action,所以改action被調用,返回success的情況下畫面將定位到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>
以上代碼配置了兩個包:lee和get,配置get包時,指定了該包的命名空間爲/book。對於名爲lee的包而言,沒有指定namespace屬性。如果某個包沒有指定namespace屬性,即該包使用默認的命名空間,則默認的命名空間總是""。
需要注意的問題有兩個:
默認命名空間裏的Action可以處理任何模塊下的Action請求。
即:如果存在URL爲/book/GetBooks.action的請求,並且/book的命名空間沒有名爲GetBooks的Action,則默認命名空間下名爲GetBooks的Action也會處理用戶請求。
當某個包指定了命名空間後,該包下所有的Action處理的URL應該是命名空間+Action名。
以上面的get的包爲例,該包下包含了名爲getBooks的Action,則該Action處理的URL爲:
http://localhost:8080/namespace/book/GetBooks.action
*namespace是應用名,book是該Action所有包對應的命名空間,GetBooks是Action名。


Action配置
配置Action就是讓Struts2容器知道該Action的存在,並且能調用該Action來處理用戶請求。因此,我們認爲:Action是Struts2的基本“程序單位”。即,在struts2框架中每一個Action是一個工作單元。
Action負責將一個請求對應到一個Action處理上去,每當一個Action類匹配一個請求的時候,這個Action類就會被Struts2框架調用。Action只是一個控制器,它並不直接對瀏覽者生成任何響應,因此,Action處理完用戶請求後,Action需要將指定的視圖資源呈現給用戶。因此,配置Action時,應該配置邏輯視圖和物理視圖資源之間的映射。
Struts2使用包來組織Action,因此,將Action的定義是放在包定義下完成的,定義Action通過使用package下的action子元素來完成。至少需要指定該Action的name屬性,該name屬性既是該Action的名字,也是該Action需要處理的URL的前半部分。除此之外,通常還需要爲action元素指定一個class屬性,其中class屬性指定了該Action的實現類。
一個簡單的例子:
<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>
一個較全面的Action配置示例:
<action name="Logon" class="tutorial.Logon">
< result type="redirect-action">Menu</result>
< result name="input">/tutorial/Logon.jsp</result>
< /action>
每一個Action可以配置多個result,多個ExceptionHandler,多個Intercepter,但是只能有一個name,這個name和package的namespace來唯一區別一個Action。
每當struts2框架接受到一個請求的時候,他會去掉Host,Application和後綴等信息,得到Action的名字,例如如下的請求將得到Welcome這個Action。
http://www.planetstruts.org/struts2-mailreader/Welcome.action
在一個Struts2應用程序中,一個指向Action的鏈接通常有Struts Tag產生,這個Tag只需要指定Action的名字,Struts框架會自動添加諸如後綴等的擴展,例如:
<s:form action="Hello">
< s:textfield label="Please enter your name" name="name"/>
< s:submit/>
< /s:form>
將產生一個如下的鏈接的請求:
http://Hostname:post/appname/Hello.action
在定義Action的名字的時候不要使用.和/來命名,最好使用英文字母和下劃線。
1,Action中的方法
Action的默認入口方法由xwork2的Action接口來定義,代碼清單爲:
public interface Action {
public String execute() throws Exception;
}
有些時候我們想指定一個Action的多個方法,我們可以做如下兩步:
建立一些execute簽名相同的方法,例如:
Public String forward() throws Exception
在Action配置的時候使用method屬性,例如:
<action name="delete" class="example.CrudAction" method="delete">
2,Action中的方法通配符
有些時候對Action中方法的調用滿足一定的規律,例如edit Action對應edit方法,delete Action對應 delete方法,這個時候我們可以使用方法通配符,例如:
<action name="*Crud" class="example.Crud" method="{1}">
這時,editCrud Action的引用將調用edit方法,同理,deleteCrud Action的引用將調用delete 方法。
另外一種比較常用的方式是使用下劃線分割,例如:
<action name="Crud_*" class="example.Crud" method="{1}">
這樣當遇到如下調用的時候可以找到對應的方法。
"action=Crud_input" => input方法
"action=Crud_delete" => delete方法
通配符和普通的配置具有相同的地位,可以結合使用框架的所有其他功能。
3,默認的Action
當我們沒有指定Action的class屬性的時候,例如:
<action name="Hello">
我們默認使用com.opensymphony.xwork.ActionSupport
ActionSupport有兩個方法input和execute,每個方法都是簡單的返回SUCCESS。
4,Post-Back Action
可以使用如下畫面達到字畫面刷新的效果
<s:form>
< s:textfield label="Please enter your name" name="name"/>
< s:submit/>
< /s:form>
4,默認Action
通常情況下,請求的Action不存在的情況下,Struts2框架會返回一個Error畫面:“404 - Page not found”,有些時候或許我們不想出現一個控制之外的錯誤畫面,我們可以指定一個默認的Action,在請求的Action不存在的情況下,調用默認的Action,通過如下配置可以達到要求:
<package name="Hello" extends="action-default">
< default-action-ref name="UnderConstruction">
< action name="UnderConstruction">
< result>/UnderConstruction.jsp</result>
< /action>
< /package>
5,默認通配符
<action name="*" >
< result>/{1}.jsp</result>
< /action>
每個Action將會被映射到以自己名字明明的JSP上。
發佈了25 篇原創文章 · 獲贊 19 · 訪問量 5萬+
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章