1. 程式人生 > >javaweb專案中引入struts2後web.xml的詳細配置和註釋

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>