Struts配置檔案詳細講解

jianghe_03發表於2008-04-11
Struts應用採用兩個基於XML的配置檔案來配置,分別是web.xml和struts-cofig.xml檔案.web.xml檔案是配置所有web應用的而struts-config.xml檔案是struts專用的配置檔案,事實上也是可以根據需要給這個配置檔案起其他名稱的.
Web應用的釋出描述檔案:

web應用釋出描述檔案可以在應用開著者,釋出者和組裝者之間傳遞配置資訊,Web容器在啟動的時候從該檔案中讀取配置資訊,根據它來裝載和配置web應用.文件型別定義DTD對XML文件的格式做了定義,DTD吧XML文件劃分為元素,屬性,實體每一種XML文件都有獨自的DTD檔案.可以從網上下載.<web-app>元素是web.xml的根元素,其他元素必須嵌入在<web-app>元素之內.要注意的是子元素也是有順序的比如必須是首先<servlet>,然後<servlet-mapping>最後<taglib>.

為Struts應用配置Web.xml檔案:

首先最重要的一步是配置ActionServlet,這個用<servlet>標籤的servlet-name屬性起一個名字叫action,然後用servlet-class屬性指定ActionServlet的類.

然後用<servlet-mapping>標籤的servlet-name屬性指定action,在用url-pattern指定接收範圍是*.do的請求.不管應用中包含了多少子應用,都只需要配置一個ActionServlet,類來出來應用中的不同的功能,其實者就是不必要的,因為Servlet本身就是多執行緒的,而且目前Struts只允許配置一個ActionServlet.宣告ActionServlet的初始化引數:<servlet>的<init-param>子元素用來配置Servlet的初始化引數.param-name設定config引數名.param-value設定struts-config.xml的路徑引數值.

配置歡迎使用清單:

如果客戶訪問Web的時候值是訪問了WEB應用的根目錄URL.沒有具體的指定檔案,Web會自動呼叫Web的歡迎檔案.<welcome-file-list>元素來配置的.通過其中的<welcome-file>歡迎頁面</welcome-file>來配置.

配置錯誤處理:

儘管Struts框架功能強大的錯誤處理機制,但是不能保證處理所有的錯誤或者異常.當錯誤發生時,如果框架不能處理這種錯誤,把錯誤拋棄給Web容器,在預設的情況下web容器會想客戶端返回錯誤資訊.如果想避免讓客戶看到原始的錯誤資訊,可以在Web應用釋出描述檔案中配置<error-page>元素.通過<error-code>404來定義錯誤的型別.然後通過<location>要處理錯誤的JSP頁面來對錯誤進行處理.還可以用<exception-type>來設定異常,然後通過<location>來處理異常的JSP頁面來處理異常.

配置Struts標籤庫:

這個就和以前學到的JSP自定義標籤類似,配置元素為<taglib>來配置.<taglib-uri>這個指定標籤庫的uri,類似起一個名稱.<taglib-location>這個是標籤庫的位置也就是實際所在的路徑.通過這樣的方法引入一個標籤庫,然後在前臺JSP頁面就可以通過自己定義的URI來呼叫標籤.

Struts配置檔案:

struts-config.xml檔案.

首先研討一下org.apache.struts.config包,在struts應用啟動的時候會把Struts配置檔案資訊讀取到記憶體中,並把它們存放在config包中相關的JavaBean類的例項中.包中的每一個類都和struts配置檔案中特定的配置元素對應,ModuleConfig在Struts框架中扮演了十分重要的角色,它是整個config包的核心,在Struts執行時來存放整個應用的配置資訊.如果有多個子應用都會有一個ModuleConfig物件,它和Struts檔案根元素的<struts-config>對應.根元素中包含<form-bean><action><forward>等元素.

<struts-config>元素:時Struts配置檔案的根元素,和它對應的配置類ModuleConfig類,<struts-config>元素有8個子元素.他們的DTD定義是data-sources?form-bean? global-exception?global-forwards?action-mapping?controller?message-resources?plug-in*在Struts配置檔案中,必須按照DTD指定的先手順序來配置<struts-config>元素的各個子元素,如果顛倒了這些子元素的順序,會產生錯誤.

<data-sources>元素:用來配置應用所需要的資料來源,資料來源負責建立和特定的資料庫的連線.許多資料來源採用連線池的機制實現.以便提高資料庫訪問的效能.JAVA語言提供了javax.sql.DataSource介面,所有的資料來源都必須實現這個介面.許多應用伺服器和Web伺服器都提供了資料來源元件.很多資料庫廠商也提供了資料來源的實現.<data-sources>元素包含多個<data-source>子元素永遠配置特定的資料來源.他們可以包含多個<set-property>子元素用於設定資料來源的各種屬性.配置了資料來源以後,就可以在Action類中訪問資料來源,在Action中定義了getDataSource(HttpRequest)方法,用於獲取資料來源物件的引用.然後可以利用DataSource物件呼叫getConnection獲取一個連線物件對資料庫進行操作.在配置檔案中宣告多個資料來源的時候需要為每一個資料來源分配唯一的Key值,通過這個來表示特定的資料來源.獲取特定的資料來源的時候可以用dataSource = getDataSource(reqeust,”A”);

<form-beans>元素:用來配置多個ActionForm,包含一個或者N個<form-bean>子元素.每個<form-bean>元素都包含多個屬性.className指定和<form-bean>匹配的類.name指定該ActionForm的唯一識別符號,這個屬性是必須的以後作為引用使用.type指定ActionForm類的完整類名,這個屬性也是必須的.注意包名也要加上.<form-property>是指定動態的Form的元素,以後會深入瞭解.

<global-exception>元素:用於配置異常處理,元素可以包含一個或者多個<exception>元素,用來設定JAVA異常和異常處理類ExceptionHandler之間的對映.className指定和元素對應的配置類,預設的不用動.handler指定異常處理類預設是ExceptionHandler.key指定在本地資原始檔中異常的訊息Key,path指定當前異常發生的時候轉發的路徑.scope指定ActionMessages例項存放的範圍.type指定需要處理異常類的名字,必須的.bundle指定Resource Bundle.

<global-forwards>元素:用來宣告全域性轉發,元素可以有一個或者N個<forward>元素組成,用於把一個邏輯名對映到特定的URL,通過這種方法Action類或者JSP頁面無需指定URL,只要指定邏輯名稱就可以實現請求轉發或者重定向.這樣可以減少控制元件和檢視的聚合.易於維護.className對應的配置類.contextRelative如果為true表示當path屬性以/開頭的時候,給出的是對應的上下文URL預設是false.name轉發路徑的邏輯名,必須寫.path轉發或者重定向的URL,必須寫必須是以/開頭.redirect設定為true的時候表示執行重定向操作,此項為false的時候,表示執行請求轉發操作.重定向與請求轉發的區別以後就是重定向是把請求生成應答給客戶端然後在重新傳送給定向的URL,瀏覽器位址列會有顯示.而轉發就是直接把請求轉發給本應用的另一個檔案,不生成應答所以客戶端IE沒顯示.

<action-mapping>元素:包含一個或者N個<action>元素,描述了從特定的請求路徑到響應的Action的對映.在<action>元素中可以包含多個<exception>和<forward>子元素,他們分別配置區域性異常處理和區域性轉發.attribute設定Action關聯的ActionForm在request或者session範圍內的key.就是在request或者session共享內的名稱.className對應配置元素的類.預設的是ActionMapping.forward指定轉發URL路徑include指定包含URL路徑.input指定包含表單的URL,當表單驗證失敗的時候傳送的URL.name,指定和該Action關聯的Form名字.該名字必須是在form-bean中定義過的,可寫可不寫.path必須/開頭的方位Action的路徑.parameter指定Action配置引數.在Action的execute()方法中可以呼叫ActionMapping的getParameter()方法來讀取匹配的引數.roles指定允許呼叫該Action的安全形色,多個角色之間逗號格開.scope指定Form的存在範圍.預設是session.tyep指定Action的完整類名.unknown如果是true表示可以處理使用者發出的所有的無效的ActionURL預設是false.validate指定是否呼叫ActionForm的validate方法.

<controller>元素:用於配置ActionServlet.buffreSize指定上載檔案的輸入緩衝大小.該屬性為可選預設4096.className指定元素對應的配置類,ControllerConfig.然後是contentType指定響應結果內容型別和字元編碼,該屬性為可選,預設是text/html如果在Action或者JSP網頁也設定了型別內容,會覆蓋這個.locale指定是否把Locale物件儲存到當前使用者的session中預設false.tempDir指定處理檔案上載的臨時工作目錄.nochache如果是true在響應結果中加入特定的頭引數.

<message-resources>元素:用來配置Resource Bundle.用於存放本地文字訊息檔案.className元素對應的配置類.MessageResourcesConfig.factory指定訊息的工廠類.key指定檔案存放的Servlet物件中採用的屬性Key.null指定如何處理未知訊息.parameter指定訊息的檔名.

<plug-in>元素:用於配置Struts外掛.

配置多應用模組:所有的子應用都可以共享同一個ActionServlet例項,但是每個子應用都有單獨的配置檔案.把應用劃分為多個子應用模組.首先為每個應用建立單獨的Struts配置檔案,在web.xml的ActionServlet配置程式碼中新增幾個子應用資訊.採用<forward>元素來實現應用之間的切換.

Digester元件:是一個Apache的另一個開原始碼專案.當Struts被初始化的時候,首先會讀取並解析配置檔案,框架採用Digester元件來且西配置檔案.然後建立config包中的物件.者物件用於存放配置資訊.

其實配置檔案不難,只要都理其中的原理就OK了.真正實際的專案開發中,採用的工具例如Eclipse系列,提供了相應的外掛,在建立一個Struts工程的時候配置檔案的標籤都是自動生成的,而我們只需要往裡面填寫屬性就OK了.

相關文章