從零打造在線網盤系統之Struts2框架配置全解析
歡迎瀏覽Java工程師SSH教程從零打造在線網盤系統系列教程,本系列教程將會使用SSH(Struts2+Spring+Hibernate)打造一個在線網盤系統,本系列教程是從零開始,所以會詳細以及著重地闡述SSH三個框架的基礎知識,第四部分將會進入項目實戰,如果您已經對SSH框架有所掌握,那麽可以直接瀏覽第四章,源碼均提供在GitHub/ssh-network-hard-disk上供大家參閱
要想學好一個框架,就必須要學好如何配置好這個框架,下面讓我們大體上來一起來了解一下Struts2的相關配置,在Struts2框架中涉及到三個配置文件,如下所示
- web.xml
- struts.xml
- 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配置文件加載順序
- struts-default.xml
- struts-plugin.xml
- struts.xml
- struts.properties
- web.xml
如果在配置文件中多次配置,最後加載的配置會覆蓋前面的配置
從零打造在線網盤系統之Struts2框架配置全解析