javaweb專案中引入struts2後web.xml的詳細配置和註釋
web.xml是web應用中載入有關servlet資訊的重要配置檔案,起著初始化servlet,filter等web程式的作用。
通常,所有的MVC框架都需要Web應用載入一個核心控制器,那採取什麼方法載入這樣的核心控制器呢,servlet或filter成為了很好的選擇,
因為它們會隨著web服務的啟用而自動的載入。對於Struts 2框架而言,需要載入FilterDispatcher,
只要Web應用負責載入FilterDispatcher,FilterDispatcher將會載入應用的Struts 2框架。
因為Struts 2將核心控制器設計成Filter,而不是一個普通Servlet。故為了讓Web應用載入FilterDispacher,只需要在web.xml檔案中配置FilterDispatcher即可。
在web.xml裡面配置struts。如果是2.1.3之前的版本,用 org.apache.struts2.dispatcher.FilterDispatcher,
以後的版本則配置org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter。
<!-- 配置Struts 2框架的核心Filter --> <filter> <!-- 配置Struts 2核心Filter的名字 --> <filter-name>struts2</filter-name> <!-- 配置Struts 2核心Filter的實現類 --> <filter-class>org.apache.struts2.dispatcher.FilterDispatcher </filter-class> <init-param> <param-name>config </param-name> <param-value>struts-default.xml,struts-plugin.xml,/WEB-INF/struts.xml </param-value> </init-param> <init-param> <!-- 配置Struts 2框架預設載入的Action包結構 --> <param-name>actionPackages</param-name> <param-value>org.apache.struts2.showcase.person</param-value> </init-param> <!-- 配置Struts 2框架的配置提供者類 --> <init-param> <param-name>configProviders </param-name> <param-value>lee.MyConfigurationProvider</param-value> </init-param> <!-- 配置Struts 2框架的常量 --> <init-param> <param-name>truts.enable.DynamicMethodInvocation</param-name> <param-value>false</param-value> </init-param> <init-param> <param-name>struts.devMode</param-name> <param-value>false</param-value> </init-param> <init-param> <param-name>struts.objectFactory</param-name> <param-value>spring</param-value> </init-param> </filter> <!-- 配置Filter攔截的URL --> <filter-mapping> <!-- 配置Struts 2的核心FilterDispatcher攔截所有使用者請求 --> <filter-name>struts2</filter-name> <url-pattern>/*</url-pattern> </filter-mapping>
其中有3個初始化引數有特殊意義:
config:該引數的值是一個以英文逗號(,)隔開的字串,每個字串都是一個XML配置檔案的位置。Struts 2框架將自動載入該屬性指定的系列配置檔案。
actionPackages:該引數的值也是一個以英文逗號(,)隔開的字串,每個字串都是一個包空間,Struts 2框架將掃描這些包空間下的Action類。
configProviders:如果使用者需要實現自己的ConfigurationProvider類,使用者可以提供一個或多個實現了ConfigurationProvider介面的類,
然後將這些類的類名設定成該屬性的值,多個類名之間以英文逗號(,)隔開。
除此之外,還可在此處配置Struts 2常量,每個<init-param>元素配置一個Struts 2常量,其中<param-name>子元素指定了常量name,
而<param-value>子元素指定了常量value。
至於filter-mapping屬性是過濾器(Filter)必須的一個屬性,用於過濾請求的路徑,此處一般就設為/*形式,
對所有請求uri進行攔截(過濾),除非你要做一些特殊的處理。
到此,配置完struts2的核心控制器後,基本完成了struts2在web.xml檔案中的配置。
注意點:如果web容器是J2EE1.3(servlet2.3),由於不會自動載入struts的標籤庫,所以需要在web.xml檔案中手動載入struts的標籤庫,
檔名struts-tags.tld,一般放在WEB-INF下面,可以自己指定但如果web容器是J2EE1.4(servlet2.4),那麼web容器會自動載入標籤庫,
Struts 2的標籤庫定義檔案包含在struts2-core-2.0.6.jar檔案裡,在struts2-core-2.0.6.jar檔案的META-INF路徑下,包含了一個struts-tag.tld檔案,
這個檔案就是Struts 2的標籤庫定義檔案,Servlet 2.4規範會自動載入該標籤庫檔案,其中struts-tags.tld檔案裡包含了載入資訊的片斷:如下:
<taglib>
<!-- 定義標籤庫的版本 -->
<tlib-version>2.2.3</tlib-version>
<!-- 定義標籤庫所需的JSP版 -->
<jsp-version>1.2</jsp-version>
<short-name>s</short-name>
<!-- 定義Struts 2標籤庫的URI,jsp檔案中應用的uri-->
<uri>/struts-tags</uri>...
</taglib>
而servlet2.3手動配置如下:
<!-- 手動配置Struts 2的標籤庫 -->
<taglib>
<!-- 配置Struts 2標籤庫的URI jsp檔案中應用的uri,類似於名字空間-->
<taglib-uri>/s</taglib-uri>
<!-- 指定Struts 2標籤庫定義檔案的物理位置 -->
<taglib-location>/WEB-INF/struts-tags.tld</taglib-location>
</taglib>