Struts framework根據配置文件使得ServletAction,ActionMapping,Action , ActionForm這幾個不同層次的組件相互交互,協調的工作。這些配置文件是在系統啓動的時候,讀入導內存中,供控制器使用的。
Struts framework主要包括三部分的配置描述,一個是指定有關Struts Controller及其相關的的配置描述(Initialization Parameters),一個對struts tag lib的描述,一個是struts組件(ActionMapping,Action,ActionForm)之間相互映射協調的關係
有關Struts Controller及其相關的的配置描述:
因爲Struts Controller的主要類ActionServlet是繼承自HttpServlet,所以必須像配置一個Servlet那樣在部署描述符(Web.xml)中配置ActionServlet類及其訪問映射。
當您第一次創建基於Struts的Web應用程序時,將爲您創建一個部署描述符,這通常就足夠了。該文件包括下列條目:
<servlet>條目定義用於Web應用程序的servlet(在本例中,這是唯一的servlet):
— <servlet-name> 和<servlet-class>指示ActionServlet (標識爲“操作”)接收HTTP請求並確定如何響應。
— <init-param>表示servlet初始化參數.
- “config”指示ActionServlet的行爲由指定的配置文件來指導,該配置文件通常具有以下名稱:
/WEB-INF/struts-config.xml
- “debug”具有整數值,它指示將有關處理的詳細信息寫至控制檯的程度。
- ”detail”具有整數值,它指示將“映射”詳細信息(如後面所述)寫至控制檯的程度。
— <load-on-startup>導致在啓動應用程序時裝入servlet。
<servlet-mapping>元素標識這樣的命名模式:當命名模式由URL進行匹配時,Web服務器就將控制權移交給ActionServlet。考慮下面各種情況:
— 訪問了ActionServlet,原因是“操作”(<servlet-mapping>中的<servlet-name>元素的內容)與“操作”(<servlet>中的<servlet-name>元素的內容)相匹配。
— <servlet-mapping>元素指定URL的結尾的命名模式。每個URL的開頭都是應用程序上下文路徑。按照慣例,ActionServlet調用對象以響應與命名模式“*do”(其中“*”是通配符)一致的URL。
<welcome-file-list>元素指示獲得初始控制權的特定於應用程序的代碼;在本例中,Web服務器直接從Web Content目錄中調用index.jsp。
<error-page>元素指示顯示哪個JSP來響應錯誤;在本例中,錯誤爲如下所示:
— 404 (找不到資源)
— 500 (Web服務器內部發生錯誤)
每個<taglib>元素都使相對URL(相對於Web.xml)與標記庫描述符(相對於Web應用程序根目錄)相關聯。每個JSP都可以使用同一個URL來表示給定的標記庫,而Web.xml確定引用了哪個文件。
有關struts tag lib的配置描述
如果你的web application打算使用Struts的taglib,那麼你有必要在web.xml中對struts taglib進行配置描述。
有關Struts Action Mapping的配置描述
作爲先前描述的web.xml設置的結果,Web應用程序服務器將請求的一個子集按路徑發送至ActionServlet,它通常調用一系列操作和JSP。ActionServlet的響應是基於配置文件struts-config.xml的內容的。有關其DTD文檔的描述,請參考http://jakarta.apache.org/struts/dtds/struts-config_1_1.dtd
一般struts-config(version1.1)包含了如下幾個部分:
(1)form-bean
(2)global-forwards
(3)action-mappings
(4)data-sources
我們知道,對於這樣的一個請求(例如,表示爲“/login.do”),執行下列步驟:
1、 尋找操作類對象(繼承org. apache.struts.action.Action的類)
2、 ActionServlet調用操作類對象的執行方法
操作類中的執行方法的特徵符爲如下所示:
public ActionForward execute(
ActionMapping mapping,
ActionForm form,
HttpServletRequest request,
HttpServletResponse response)
映射對象(ActionMapping),它包含指示如何響應方法的每個可能結果的規則(“映射”)
Struts表單bean(ActionForm),它保存發送至HTML表單或接收自HTML表單的數據
請求和響應對象(HttpServletReques/ HttpServletResponse)
3、 從執行方法返回ActionForward對象,用於指導ActionServlet接着訪問哪個操作類或JSP
返回的ActionForward對象中的信息取決於兩個值:
方法的結果(如在“成功”或“故障”等字符串中所述)
映射對象,它包含從Struts配置文件中讀取的信息
要弄明白某些運行時關係,要明白struts-config.xml該文件包括下面的一組條目:
<form-beans>標記標識每個表單bean
<action-mappings>標記包括用於指導應用程序流的信息,每個<action>子標記都使相對URL與操作類和潛在的後續操作相關。
Form-bean元素
Struts配置文件中的一個示例<form-bean>子元素爲如下所示:
<form-bean name=“registerForm” type=“strutscommon.RegisterForm”/>
每個<form-bean>子元素都包括下列屬性:
name
表單bean的名稱,稍後在配置文件中會用到。ActionServlet舉例說明了該bean(如果需要的話)並在將對bean的引用存儲在請求或會話對象中時將該名稱用作鍵。
type
類的全限定名稱,它繼承org.apache.struts.action.ActionForm該類必須在類路徑中。接受“Struts貿易樣本”中的註冊的表單bean包括HTML註冊表單中每個字段的getter 和setter方法。該bean還包括驗證方法,如下節“驗證”中所述。
Action元素
Struts配置文件中的一個示例<action>元素爲如下所示:
<action path=“/register”
type=“strutsEGL.RegisterAction”
name=“registerForm”
input=“/register.jsp”
scope=“request”
<forward name=“success”path=“/home.do”/>
< forward name=“failure”path=“/register.jsp”/>
</action>
每個<action>元素都包括下列屬性中的某些屬性或所有屬性:
path
將請求指定爲非限定URL,不帶文件擴展名(例如,“/register”)請求是根據<action>元素中的其它屬性來處理的,並且是用戶輸入的結果或者是在different<action>元素中標識的轉發的結果。
type
指定在發出請求時調用其執行方法的操作類的全限定名。該類必須在類路徑中。
注:不指定要實例化的類,可以通過使用forward屬性來轉發請求,該屬性在“Struts貿易樣本”中未使用,並且與後面描述的<forward>子元素不相同。
name
用於保存發送至HTML表單或接收自HTML表單的數據表單bean的名稱。
input
指定相對URL(例如,“/register.do”或“/index.jsp”)必須包括後綴,
如果表單bean的驗證方法指示發生了輸入錯誤,則會調用URL;有關詳細信息,參見下節的“驗證”。
scope
指定將對錶單 bean的引用存儲在哪個作用域中。其值爲“會話”(缺省值)或“請求”。
Struts配置文件中的每個<action>元素還包括子元素<forward>,它指定從方法結果至後續調用的映射。每個<forward>子元素都包括下列屬性
name
指定導致在運行時使用當前映射的字符串(例如,“success”),但是
只限於以下情況:在 type 中引用的操作類的執行方法使用完全相同
的字符串來配置返回至ActionServlet的 ActionForward對象。下面
的執行方法不是很重要,但是會導致使用“success”映射:
public ActionForward exectue(
ActionMapping mapping,
ActoinForm form,
HttpServletRequest request,
HttpServletResponse response)
Throws IOException,ServletException
{
ActionForward forward=new ActionForward();
Forward=mapping,findForward(“success”);
return(forward);
}
path
指定非限定URL(例如,“/home.do” 或“/index.jsp”)必須包括文件擴展名,僅當使用當前映射時纔會調用該URL,轉發操作類是根據different<action>元素中的屬性來處理的,尤其是,在其path屬性標識相同URL的<action>元素中。
有必要提一下的是,在struts1.1中,提出了對Multiple Application Support。在struts的早先版本中,只有一個struts配置文件,一般叫struts-config.xml。但是,對於越來越複雜的應用系統的發展,只有一個地方存放這個一個文件,對大型項目來說,使用和修改這個配置文件,使其成爲了一個應用的瓶頸問題。在struts1.1中,你可以定義多了配置文件協同工作。