Struts2體系結構與基本流程

一、Struts2基本流程

大緻上，Struts2架構由三部分組成：核心控制器FilterDispatcher、業務控制器和使用者實作的業務邏輯元件。在這三部分裡，Struts2架構提供了核心控制器，

而使用者需要實作業務控制器和業務邏輯元件。

1、核心控制器（FilterDispatcher）

FilterDispatcher是Struts2架構的核心控制器，該控制器作為一個Filter運作在web架構中，它負責攔截所有的使用者請求，當使用者請求到達時，該Filter會自

動過濾使用者請求。如果使用者請求以action結尾，該請求被轉入struts2架構處理。

當Struts2獲得*.action的請求後，會根據*.action的*部分判斷調用哪個業務邏輯元件，例如user.action請求，Struts2會調用Action為user的業務邏輯來

處理該請求，Struts2的Action定義在struts.xml檔案中。

2、業務控制器

業務控制器實際上就是使用者實作Action類的執行個體，在此類中繼承ActionSupport這個類，一般要重寫它的execute方法。此方法傳回一個字元串，根據處理結果的

不同，傳回的字元串也不同，每個字元串對應着一個相應的傳回視圖。

我們開發出Action類之後還要在struts.xml檔案中配置這個Action，有如下三部分需要定義：

（1）配置Action的name值，與用戶端請求的Url對應

（2）配置Action元件的實作類，即class屬性

（3）配置Action所包含的邏輯視圖與實體資源之間的關系。即result标簽的屬性。

3、Struts2模型元件

Struts2的業務控制器不會對使用者的請求進行處理，使用者的請求一般最終由模型元件來處理，業務控制器隻是負責中間排程的。

就比如平時做的項目中一般是由action層調用service層的方法對使用者請求進行處理，srrvice層下面還可能隐含着Dao層。

4、Struts2的基本流程

Struts2的大緻執行流程有如下幾步：

（1）使用者發起請求（.action表示一個Action請求）

（2）Struts2的FilterDispatcher攔截到使用者發起的請求，判斷這個請求是否是Action請求，如果是Action請求，那麼交給對應的Action進行處理，在這個

過程中需要一個輔助對象：Action映射器（ActionMapper）

（3）交給對應的Action處理之後，根據struts.xml中對此Action的配置資訊，首先執行攔截此Action的所有攔截器，然後再執行請求的Action對象。

（4）Action執行完畢之後需要傳回一個結果（此結果用字元串表示），核心控制器根據此傳回結果從配置檔案中找到真正的路徑，然後将請求轉發給相應的視

圖，由視圖向用戶端做出相應的響應。

二、Struts2的基本配置

配置3個檔案：web.xml  struts.xml  struts.properties

1、web.xml

任何MVC架構都需要與web應用整合，這就不得不借助web.xml這個檔案，隻有配置在web.xml中的Servlet才會被應用加載。

通常，所有的MVC架構都需要在web.xml中加載一個核心控制器，對于Struts2架構而言，需要加載FilterDispatcher，web應用隻需要負責加載

FilterDispatcher，FilterDispatcher就會自動加載Struts2架構。

在web.xml中配置FilterDispatcher的代碼片段如下：

<!-- 配置Struts2的核心Filter -->
	<filter>
		<!-- 配置Struts2核心Filter的名字 -->
		<filter-name>struts2</filter-name>
		<!-- 配置Struts2核心Filter的實作類 -->
		<filter-class>org.apache.struts2.dispatcher.FilterDispatcher</filter-class>
	</filter>
	<!-- 配置Filter攔截的url，通過此配置讓Filter攔截所有的使用者請求 -->
	<filter-mapping>
		<filter-name>struts2</filter-name>
		<url-pattern>/*</url-pattern>
	</filter-mapping>
           

當然，配置這個Filter的時候也可以指定一些初始化參數或者常量（比如struts2的編碼），平時我沒怎麼用到在這塊加參數，是以沒寫，但是要知道這塊是可以

加初始化參數的。

2、配置struts.xml

Struts2架構的核心配置檔案就是struts.xml，該檔案主要負責管理struts2架構的業務控制器，也就是管理Action。

在預設情況下，Struts2架構将自動加載放到/WEB-INF/classes路徑下的struts.xml檔案（是以我們在eclipse中要将struts.xml放到項目的src目錄下）。

在大部分應用中，随着應用規模的增加，系統中的Action數量也在增多，造成struts,xml檔案臃腫，是以我們在開發的時候要将Action分類配置到不同的xml

檔案中，然後在struts.xml檔案中包含其他的配置檔案，例如，<include file="struts_util.xml"/>。這樣可以提高struts.xml檔案的可讀性。

看一個struts.xml檔案的結構，就是一個示範檔案：

<?xml version = "1.0" encoding = "UTF-8"?>
<!--下面是Struts2配置檔案的DTD資訊 -->
<!DOCTYPE struts PUBLIC
    "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
    "http://struts.apache.org/dtds/struts-2.0.dtd">
<!--struts是struts2配置檔案的跟元素 -->
<struts>
	<!--下面的元素可以出現0次，也可以出現無限多次 -->
	<constant name="" value="" />
	<!--下面的元素可以出現0次，也可以出現無限多次 -->
	<bean type="" name="" class="" scope="" static="" optional="" />
	<!--下面的元素可以出現0次，也可以出現無限多次 -->
	<include file="" />
	<!--package元素是struts配置檔案的核心，該元素可以出現0次，或者是無限多次 -->
	<package name="必填的包名" extends="" namespace="" abstract="" externalReferenceResovler>
		<!--以下該元素可以出現，也可以不出現，最多出現一次 -->
		<result-types>
			<!--以下該元素必須出現，可以出現無數多次 -->
			<result-type name="" class="" default="true\false">
				<!--下面的元素可以出現0次，也可以出現無限多次 -->
				<param name="參數名">參數值 </param>
			</result-type>
		</result-types>
		<!--以下的該元素可以出現，也可以不出現，但最多出現1次 -->
		<interceptors>
			<!--interceptors元素的子元素interceptor元素和interceptor-stack至少出現其中之一，也可以兩者都出現 -->
			<!--下面的元素可以出現0次，也可以出現無限多次 -->
			<interceptor name="" class="">
				<!--下面的元素可以出現0次，也可以出現無限多次 -->
				<param name="參數名">參數值 </param>
			</interceptor>
			<!--下面的元素可以出現0次，也可以出現無限多次 -->
			<interceptor-stack name="">
				<!-- 下面的元素必須出現，可以出現無數多次 -->
				<interceptor-ref name="">
					<!-- 下面的元素可以出現0次，也可以出現無限多次 -->
					<param name="參數名">參數值</param>
				</interceptor-ref>
			</interceptor-stack>
		</interceptors>
		<!-- 下面的元素可以出現0次，也可以出現無限多次 -->
		<default-interceptor-ref name="">
			<!-- 下面的元素可以出現0次，也可以出現無限多次 -->
			<param name="參數名">參數值</param>
		</default-interceptor-ref>
		<!-- 下面的元素可以出現0次，也可以出現無限多次 -->
		<default-action-ref name="">
			<!-- 下面的元素可以出現0次，也可以出現無限多次 -->
			<param name="參數名">參數值</param>
		</default-action-ref>
		<!-- 下面的元素可以出現0次，也可以出現無限多次 -->
		<global-results>
			<!-- 該元素必須出現，可以出現無限多次 -->
			<result name="" type="">
				<!-- 該字元串内容可以出現0次或者多次 -->
				映射資源
				<!-- 下面的元素可以出現0次，也可以出現無限多次 -->
				<param name="參數名">參數值</param>
			</result>
		</global-results>
		<!-- 下面的元素可以出現0次，也可以出現多次 -->
		<global-exception-mappings>
			<!-- 該元素必須出現，可以出現多次 -->
			<exception-mapping name="" exception="" result="">
				異常處理資源
				<!-- 下面的元素可以出現0次，也可以出現無限多次 -->
				<param name="參數名">參數值</param>
			</exception-mapping>
		</global-exception-mappings>
		<action name="" class="" method="" convertor="">
			<!-- 下面的元素可以出現0次，也可以出現無限多次 -->
			<param name="參數名">參數值</param>
			<!-- 下面的元素可以出現0次，也可以出現無限多次 -->
			<result name="" type="">
				映射資源
				<!-- 下面的元素可以出現0次，也可以出現無限多次 -->
				<param name="參數名">參數值</param>
			</result>
			<!-- 下面的元素可以出現0次，也可以出現無限多次 -->
			<interceptor-ref name="">
				<!-- 下面的元素可以出現0次，也可以出現無限多次 -->
				<param name="參數名">參數值</param>
			</interceptor-ref>
			<!-- 下面的元素可以出現0次，也可以出現無限多次 -->
			<exception-mapping name="" exception="" result="">
				異常處理資源
				<!-- 下面的元素可以出現0次，也可以出現無限多次 -->
				<param name="參數名">參數值</param>
			</exception-mapping>
		</action>
	</package>
</struts>
           

上面配置檔案中的内容較多，我們可以從中了解到struts.xml檔案的一個完整結構，但是各個配置元素的意義不一定都能深入了解，在這裡不多牽扯細節的地

方，後面文章會逐漸的去探索每一個配置元素的意義。

3、配置struts.properties

Struts2架構由兩大核心配置檔案，其中struts.xml檔案主要負責管理應用中的Action映射，以及該Action包含的Result定義等，除此之外，Struts2架構還包

含一個struts.properties的配置檔案，該檔案定義了Struts2架構的大量屬性，開發者可以通過改變這些屬性來滿足應用需求。

struts.properties檔案中包含大量的key-value對應，每個key就是一個Struts2屬性，每個value就是一個Struts2屬性值。

struts.properties檔案通常放在WEB-INF/classes目錄下。

可配置屬性及說明如下：

struts.configuration：該屬性指定加載Struts 2配置檔案的配置檔案管理器。該屬性的預設值是org.apache.Struts2.config.DefaultConfiguration，

這是Struts 2預設的配 置檔案管理器。如果需要實作自己的配置管理器，開發者則可以實作一個實作Configuration接口的類，

該類可以自己加載Struts 2配置檔案。

struts.locale：指定Web應用的預設Locale。

struts.i18n.encoding：指定Web應用的預設編碼集。該屬性對于進行中文請求參數非常有用，對于擷取中文請求參數值，應該将該屬性值設定為GBK或

者GB2312。提示 當設定該參數為GBK時，相當于調用HttpServletRequest的setCharacterEncoding方法。

struts.objectFactory：指定Struts 2預設的ObjectFactoryBean，該屬性預設值是spring。

struts.objectFactory.spring.autoWire：指定Spring架構的自動裝配模式，該屬性的預設值是name，即預設根據Bean的name屬性自動裝配。

struts.objectFactory.spring.useClassCache：該屬性指定整合Spring架構時，是否緩存Bean執行個體，該屬性隻允許使用true和false兩個屬性值，

它的預設值是true。通常不建議修改該屬性值。

struts.objectTypeDeterminer：該屬性指定Struts 2的類型檢測機制，通常支援tiger和notiger兩個屬性值。

struts.multipart.parser：該屬性指定處理multipart/form-data的MIME類型（檔案上傳）請求的架構，該屬性支援cos、pell和jakarta等屬性值，

即分别對應使用cos的檔案上傳架構、pell上傳及common-fileupload檔案上傳架構。該屬性的預設值為jakarta。注意 如果需要使用cos或者pell的檔案

上傳方式，則應該将對應的JAR檔案複制到Web應用中。例如，使用cos上傳方式，則需要自己下載下傳cos架構的JAR檔案，并将該檔案放在WEB-INF/lib路徑下。

struts.multipart.saveDir：該屬性指定上傳檔案的臨時儲存路徑，該屬性的預設值是javax.servlet.context.tempdir。

struts.multipart.maxSize：該屬性指定Struts 2檔案上傳中整個請求内容允許的最大位元組數。

struts.custom.properties：該屬性指定Struts 2應用加載使用者自定義的屬性檔案，該自定義屬性檔案指定的屬性不會覆寫struts.properties檔案

中指定的屬性。如果需要加載多個自定義屬性檔案，多個自定義屬性檔案的檔案名以英文逗号（,）隔開。

struts.mapper.class：指定将HTTP請求映射到指定Action的映射器，Struts 2提供了預設的映射

器：org.apache.struts2.dispatcher.mapper.DefaultActionMapper。預設映射器根據請求的字首與Action的name屬性完成映射。 

struts.action.extension：該屬性指定需要Struts 2處理的請求字尾，該屬性的預設值是action，即所有比對*.action的請求都由Struts 2處理。

如果使用者需要指定多個請求字尾，則多個字尾之間以英文逗号（,）隔開。

struts.serve.static：該屬性設定是否通過JAR檔案提供靜态内容服務，該屬性隻支援true和false屬性值，該屬性的預設屬性值是true。

struts.serve.static.browserCache：該屬性設定浏覽器是否緩存靜态内容。當應用處于開發階段時，我們希望每次請求都獲得伺服器的最新響應，則可設定

該屬性為false。

struts.enable.DynamicMethodInvocation：該屬性設定Struts 2是否支援動态方法調用，該屬性的預設值是true。如果需要關閉動态方法調用，則可設定該

屬性為false。

struts.enable.SlashesInActionNames：該屬性設定Struts 2是否允許在Action名中使用斜線，該屬性的預設值是false。如果開發者希望允許在Action名中

使用斜線，則可設定該屬性為true。

struts.tag.altSyntax：該屬性指定是否允許在Struts 2标簽中使用表達式文法，因為通常都需要在标簽中使用表達式文法，故此屬性應該設定為true，該屬

性的預設值是true。

struts.devMode：該屬性設定Struts 2應用是否使用開發模式。如果設定該屬性為true，則可以在應用出錯時顯示更多、更友好的出錯提示。該屬性隻接受true

和flase兩個值，該屬性的預設值是false。通常，應用在開發階段，将該屬性設定為true，當進入産品釋出階段後，則該屬性設定為false。

struts.i18n.reload：該屬性設定是否每次HTTP請求到達時，系統都重新加載資源檔案。該屬性預設值是false。在開發階段将該屬性設定為true會更有利于開

發，但在産品釋出階段應将該屬性設定為false。提示 開發階段将該屬性設定了true，将可以在每次請求時都重新加載國際化資源檔案，進而可以讓開發者看到

實時開發效果；産品釋出階段應該将該屬性設定為false，是為了提供響應性能，每次請求都需要重新加載資源檔案會大大降低應用的性能。

struts.ui.theme：該屬性指定視圖示簽預設的視圖主題，該屬性的預設值是xhtml。

struts.ui.templateDir：該屬性指定視圖主題所需要模闆檔案的位置，該屬性的預設值是template，即預設加載template路徑下的模闆檔案。

struts.ui.templateSuffix：該屬性指定模闆檔案的字尾，該屬性的預設屬性值是ftl。該屬性還允許使用ftl、vm或jsp，分别對應FreeMarker、Velocity和

JSP模闆。

struts.configuration.xml.reload：該屬性設定當struts.xml檔案改變後，系統是否自動重新加載該檔案。該屬性的預設值是false。

struts.velocity.configfile：該屬性指定Velocity架構所需的velocity.properties檔案的位置。該屬性的預設值為velocity.properties。

struts.velocity.contexts：該屬性指定Velocity架構的Context位置，如果該架構有多個Context，則多個Context之間以英文逗号（,）隔開。

struts.velocity.toolboxlocation：該屬性指定Velocity架構的toolbox的位置。

struts.url.http.port：該屬性指定Web應用所在的監聽端口。該屬性通常沒有太大的使用者，隻是當Struts 2需要生成URL時（例如Url标簽），該屬性才提供

Web應用的預設端口。

struts.url.https.port：該屬性類似于struts.url.http.port屬性的作用，差別是該屬性指定的是Web應用的加密服務端口。 

struts.url.includeParams：該屬性指定Struts 2生成URL時是否包含請求參數。該屬性接受none、get和all三個屬性值，分别對應于不包含、僅包含GET類型

請求參數和包含全部請求參數。

struts.custom.i18n.resources：該屬性指定Struts 2應用所需要的國際化資源檔案，如果有多份國際化資源檔案，則多個資源檔案的檔案名以英文逗号（,）

隔開。

struts.dispatcher.parametersWorkaround：對于某些Java EE伺服器，不支援HttpServletRequest調用getParameterMap()方法，此時可以設定該屬性值

為true來解決該問題。該屬性的預設值是false。對于WebLogic、Orion和OC4J伺服器，通常應該設定該屬性為true。

struts.freemarker.manager.classname：該屬性指定Struts 2使用的FreeMarker管理器。該屬性的預設

值org.apache.struts2.views.freemarker.FreemarkerManager，這是Struts 2内建的FreeMarker管理器。

struts.freemarker.wrapper.altMap：該屬性隻支援true和false兩個屬性值，預設值是true。通常無需修改該屬性值。

struts.xslt.nocache：該屬性指定XSLT Result是否使用樣式表緩存。當應用處于開發階段時，該屬性通常被設定為true；當應用處于産品使用階段時，該屬

性通常被設定為false。

struts.configuration.files：該屬性指定Struts 2架構預設加載的配置檔案，如果需要指定預設加載多個配置檔案，則多個配置檔案的檔案名之間以英文逗

号（,）隔開。該屬性的預設值為struts-default.xml,struts-plugin.xml,struts.xml，看到該屬性值，讀者應該明白為什麼Struts2架構預設加

載struts.xml檔案了。 

有時候開發者不喜歡額外的struts.properties檔案，Struts2允許使用struts.xml檔案管理這些屬性，在struts.xml檔案中通過配置constant元素一樣配置

這些屬性。