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

歡迎瀏覽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

若是在配置文件中屢次配置,最後加載的配置會覆蓋前面的配置