從零打造線上網盤系統之Struts2框架配置全解析

摘要： 歡迎瀏覽Java工程師SSH教程從零打造線上網盤系統系列教程 ,本系列教程將會使用SSH(Struts2+Spring+Hibernate)打造一個線上網盤系統,本系列教程是從零開始,所以會詳細以及著重地闡述SSH三個框架的基礎知識,第四部分將會進入專案實戰,如果您已經對SSH框架有...

歡迎瀏覽ofollow,noindex" target="_blank">Java工程師SSH教程從零打造線上網盤系統系列教程 ,本系列教程將會使用SSH(Struts2+Spring+Hibernate)打造一個線上網盤系統,本系列教程是從零開始,所以會詳細以及著重地闡述SSH三個框架的基礎知識,第四部分將會進入專案實戰,如果您已經對SSH框架有所掌握,那麼可以直接瀏覽第四章,原始碼均提供在 GitHub/ssh-network-hard-disk 上供大家參閱

要想學好一個框架,就必須要學好如何配置好這個框架,下面讓我們大體上來一起來了解一下Struts2的相關配置,在Struts2框架中涉及到三個配置檔案,如下所示

1. web.xml
2. struts.xml
3. struts.properties

web.xml

不管是基於MVC模式的框架還是其他功能框架,只要參與了Web應用的請求與響應動作,就必須要藉助web.xml檔案來安裝這個框架,例如Struts2就藉助==StrutsPrepareAndExecuteFilter==這個類來攔截WEB程式的請求

<filter>
<filter-name>struts2</filter-name>
<filter-class>org.apache.struts2.dispatcher.filter.StrutsPrepareAndExecuteFilter</filter-class>
<init-param>
<!--配置預設載入包-->
<param-name>actionPackages</param-name>
<param-value>com.jimisun.action</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>struts2</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>

struts.xml

struts.xml是Struts2的核心配置檔案,負責管理Struts2中的Action

. 例如下面的配置中就配置了一個http://xxxx.xx/hello.action的Action,當前在請求的時候攜帶一個引數為username引數值為jimisun,如果執行結果為success,就跳轉至"/success.jsp"

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE struts PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 2.3//EN"
"http://struts.apache.org/dtds/struts-2.3.dtd">

<!-- 根元素 -->
<struts>

<package name="default" extends="struts-default" namespace="/">
<action name="hello" class="com.jimisun.action.HelloAction">
<param name="username">jimisun</param>
<result name="success">/success.jsp</result>
</action>

</package>
</struts>

struts.properties

struts2框架中有兩個核心配置檔案，其中struts.xml檔案主要負責管理應用中的action對映，以及該action包含的result定義等。除此之外，struts2框架還包括一個struts.properties檔案，該檔案定義了struts2框架的大量屬性，開發者可以通過改變這些屬性來滿足應用的需求。

struts.configuration

該屬性制定載入Struts 2配置檔案的配置檔案管理器。該屬性的預設值是org.apache.struts2.config.DefaultConfiguration，這是Struts 2預設的配置檔案管理器。如果需要實現自己的配置配置檔案管理器，開發者可以實現一個實現Configuration介面的類，該類可以自己載入Struts 2配置檔案。

struts.locale

指定Web應用的預設locale。

struts.il8n.encoding

該常量指定了Web應用的預設編碼集。通常，由於使用中文字符集，將其設定為UTF-8。

struts.objectFactory

指定Struts 2預設的ObjectFactory Bean，該屬性預設時Spring。

struts.objectFactory.spring.autoWire

指定Spring框架的自動裝配模式，預設值時name,即預設根據Bean的name屬性自動裝配。

struts.objectFactroy.spring.useClassCache

指定整合Spring框架時，是否快取Bean例項，該屬性只允許使用true和false，預設值是true。通常不建議修改該屬性值得。

struts.objectTypeDeterminer

指定Struts 2的型別檢測機制，通常支援tiger和notiger兩個屬性值。

struts.multipart.parser

指定處理multipart/forma-data的MIME型別（檔案上傳）請求框架，該屬性支援cos、pell、和jakarta等屬性，即分別對應使用cos的檔案上傳框架、pell上傳及common-fileupload檔案上產框架。預設值是jakarta.

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的請求都都由Struts2處理。如果使用者需要指定多個請求字尾，則多個字尾之間以英文逗號（,）隔開。

struts.serve.satic

該屬性設定是否通過JAR檔案提供靜態內容服務，該屬性只支援true和false,預設值是false。

struts.serve.static.browserCache

該屬性設定瀏覽器是否快取靜態內容。當應用處於開發間段時，我們希望每次請求都獲得伺服器的最新響應，則可設定該屬性為false。

struts.enable.DynamicMethodInvocation

設定Struts 2是否支援動態方法呼叫，預設值是true。

struts.enable.SlashesInActionNames

設定Struts 2是否允許Action名中使用斜線，預設值為false。

struts.tag.altSyntax

指定是否允許在Struts 2標籤中使用表示式語法，因為通常都會在標籤中使用表示式語法，因此應該設定為true，預設值是true。

struts.devMode

指定Struts 2應用是否應用開發模式。如果該屬性設定為true，則可以在應用出錯時顯示更多、更友好的出錯提示。該屬性只接受true和false，預設值是false。

struts.il8.reload

設定是否每次HTTP請求到達時，系統都重新載入資原始檔。預設值是false。在開發階段應該設定為true。每次請求都載入資原始檔會大大降低應用的效能。

struts.ui.theme

指定試圖標籤預設的試圖主題，預設值是xhtml。

struts.ui.templateDir

指定試圖主題所需要模板檔案的位置，預設值是tempate，即預設載入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.url.https.port

該屬性類似於struts.url.http.port屬性的作用，區別是該屬性指定的是WEB應用的加密服務埠。

strust.url.includeParames

該屬性指定Struts 2生成URL時是否包含請求引數。該屬性接受none、ge 、all三個屬性，分別對應不包含、僅包含GET型別請求引數和包含全部請求引數。

struts.custom.il8n.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，這是Struts2內建的FreeMarker管理器。

struts.xslt.nocache

指定XSLT Result是否使用樣式表快取。當應用處於開發間段時，通常被設定為true。

struts.configuration.files

指定struts2框架預設載入的配置檔案，如果需要指定預設載入多個配置檔案，則多個配置檔案的檔名以英文逗號隔開。預設值為struts-default.xml,strust-plugin.xml,struts.xml。

當然以上這些配置你同樣可以寫在struts.xml中

<constant name="struts.custom.i18n.resources" value="Resource"/>
.....

Struts2配置檔案載入順序

1. struts-default.xml
2. struts-plugin.xml
3. struts.xml
4. struts.properties
5. web.xml

如果在配置檔案中多次配置,最後載入的配置會覆蓋前面的配置