struts2中几个主要的配置文件。
1)struts-default.xml
这个文件是struts2框架默认加载的配置文件。它定义struts2一些核心的bean和拦截器。
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration2.0//EN" "http://struts.apache.org/dtds/struts-2.0.dtd"> <struts> <!--struts2中工厂bean的定义--> <beanname="xwork" /> <bean type="com.opensymphony.xwork2.ObjectFactory"name="struts"/> <beantype="com.opensymphony.xwork2.ActionProxyFactory" name="xwork"/> <beantype="com.opensymphony.xwork2.ActionProxyFactory" name="struts"/> <!--类型检测bean的定义--> <beantype="com.opensymphony.xwork2.util.ObjectTypeDeterminer"name="tiger"/> <beantype="com.opensymphony.xwork2.util.ObjectTypeDeterminer"name="notiger"/> <beantype="com.opensymphony.xwork2.util.ObjectTypeDeterminer"name="struts"/> <!--文件上传bean的定义--> <beantype="org.apache.struts2.dispatcher.mapper.ActionMapper"name="struts"/> <beantype="org.apache.struts2.dispatcher.mapper.ActionMapper"name="composite"/> <beantype="org.apache.struts2.dispatcher.mapper.ActionMapper"name="restful"/> <beantype="org.apache.struts2.dispatcher.mapper.ActionMapper"name="restful2"/> <beantype="org.apache.struts2.dispatcher.multipart.MultiPartRequest"name="struts"scope="default" optional="true"/> <beantype="org.apache.struts2.dispatcher.multipart.MultiPartRequest"name="jakarta"scope="default" optional="true" /> <!--标签库bean的定义--> <bean type="org.apache.struts2.views.TagLibrary"name="s"/> <!--一些常用视图bean的定义--> <beanname="struts" optional="true"/> <beanname="struts" optional="true" /> <bean/> <beantype="org.apache.struts2.components.template.TemplateEngine"name="ftl"/> <beantype="org.apache.struts2.components.template.TemplateEngine"name="vm"/> <beantype="org.apache.struts2.components.template.TemplateEngine"name="jsp"/> <!--类型转换bean的定义--> <beantype="com.opensymphony.xwork2.util.XWorkConverter" name="xwork1"/> <beantype="com.opensymphony.xwork2.util.XWorkConverter" name="struts"/> <bean type="com.opensymphony.xwork2.TextProvider"name="xwork1"/> <bean type="com.opensymphony.xwork2.TextProvider"name="struts"/> <!-- Struts2中一些可以静态注入的bean,也就是不需要实例化的--> <beanstatic="true" /> <bean static="true"/> <bean static="true"/> <bean static="true"/> <beanstatic="true" /> <beanstatic="true" /> <bean static="true"/> <bean static="true"/> <!-- 定义Struts2默认包--> <package name="struts-default"abstract="true"> <!-- 结果类型的种类--> <result-types> <result-type name="chain"/> <result-type name="dispatcher"default="true"/> <result-type name="freemarker"/> <result-type name="httpheader"/> <result-type name="redirect"/> <result-type name="redirectAction"/> <result-type name="stream"/> <result-typename="velocity"/> <result-type name="xslt"/> <result-type name="plainText"/> <result-type name="redirect-action"/> <result-type name="plaintext"/> </result-types> <!--struts2中拦截器的定义--> <interceptors> <!--实现在不同请求中相似参数别名的准换--> <interceptor name="alias"/> <!--与Spring整合时自动装配的拦截器--> <interceptor name="autowiring"/> <!--构建一个action链,使当前action可以访问前一个action,与<result-type="chain"/>配合使用--> <interceptor name="chain"/> <!--负责类型转换的拦截器--> <interceptor name="conversionError"/> <!--使用配置的name,value来是指cookies --> <interceptor name="cookie"/> <!--负责创建httpSession--> <interceptor name="createSession"/> <!--输出调试信息--> <interceptor name="debugging"/> <!--扩展引用--> <interceptor name="externalRef"/> <!--后台执行action负责发送等待画面给用户--> <interceptor name="execAndWait"/> <!--异常处理--> <interceptor name="exception"/> <!--文件上传,解析表单域的内容--> <interceptor name="fileUpload"/> <!--支持国际化--> <interceptor name="i18n"/> <!--日志记录--> <interceptor name="logger"/> <!--模型拦截器,当action实现了ModelDriven接口时,负责把getModel的结果放入valueStack中--> <interceptor name="modelDriven"/> <!--有生命周期的ModelDriven--> <interceptor name="scopedModelDriven"/> <!--负责解析请求中的参数,并赋值给action中对应的属性--> <interceptor name="params"/> <!--实现该Preparable接口的action,会调用拦截器的prepare方法--> <interceptor name="prepare"/> <!--负责将action 标签下的param参数值传递给action实例--> <interceptor name="staticParams"/> <!--范围转换--> <interceptorname="scope"/> <!--用于访问Servlet API--> <interceptor name="servletConfig"/> <interceptorname="sessionAutowiring"/> <!--输出action执行时间--> <interceptor name="timer"/> <!--防止表单重复提交--> <interceptor name="token"/> <!--与token拦截器相似,只是把token保存到HttpSession--> <interceptor name="tokenSession"/> <!--负责表单字段的验证*-validation.xml--> <interceptor name="validation"/> <!--负责执行action的validate()--> <interceptorname="workflow"/> <!--存储和重新获取Action 消息/错误/字段错误为Action,实现ValidationAware接口到seesion--> <interceptor name="store"/> <!--添加自动checkbox处理代码,这样检探测checkbox和添加它作为一个参数使用默认值(通常’false’).使用一个指定名字隐藏字段探测没提交的checkbox--> <interceptor name="checkbox"/> <interceptor name="profiling"/> <!--JAAS服务拦截器--> <interceptor name="roles"/> <!-- 一个基本的拦截器栈 --> <interceptor-stackname="basicStack"> <interceptor-refname="exception"/> <interceptor-refname="servletConfig"/> <interceptor-refname="prepare"/> <interceptor-refname="checkbox"/> <interceptor-refname="params"/> <interceptor-refname="conversionError"/> </interceptor-stack> <!-- 简单的validtion和webflow栈--> <interceptor-stackname="validationWorkflowStack"> <interceptor-refname="basicStack"/> <interceptor-refname="validation"/> <interceptor-refname="workflow"/> </interceptor-stack> <!-- 文件上传的拦截器栈 --> <interceptor-stackname="fileUploadStack"> <interceptor-refname="fileUpload"/> <interceptor-refname="basicStack"/> </interceptor-stack> <!-- model-driven 栈--> <interceptor-stackname="modelDrivenStack"> <interceptor-refname="modelDriven"/> <interceptor-refname="basicStack"/> </interceptor-stack> <!-- action链的拦截器栈--> <interceptor-stackname="chainStack"> <interceptor-refname="chain"/> <interceptor-refname="basicStack"/> </interceptor-stack> <!-- i18n 拦截器栈 --> <interceptor-stackname="i18nStack"> <interceptor-refname="i18n"/> <interceptor-refname="basicStack"/> </interceptor-stack> <!-- 结合preparable和ModenDriven拦截器--> <interceptor-stackname="paramsPrepareParamsStack"> <interceptor-refname="exception"/> <interceptor-refname="alias"/> <interceptor-refname="params"/> <interceptor-refname="servletConfig"/> <interceptor-refname="prepare"/> <interceptor-refname="i18n"/> <interceptor-refname="chain"/> <interceptor-refname="modelDriven"/> <interceptor-refname="fileUpload"/> <interceptor-refname="checkbox"/> <interceptor-refname="staticParams"/> <interceptor-refname="params"/> <interceptor-refname="conversionError"/> <interceptor-refname="validation"> <paramname="excludeMethods">input,back,cancel</param> </interceptor-ref> <interceptor-refname="workflow"> <paramname="excludeMethods">input,back,cancel</param> </interceptor-ref> </interceptor-stack> <!--定义默认的拦截器栈 --> <interceptor-stackname="defaultStack"> <interceptor-refname="exception"/> <interceptor-refname="alias"/> <interceptor-refname="servletConfig"/> <interceptor-refname="prepare"/> <interceptor-refname="i18n"/> <interceptor-refname="chain"/> <interceptor-refname="debugging"/> <interceptor-refname="profiling"/> <interceptor-refname="scopedModelDriven"/> <interceptor-refname="modelDriven"/> <interceptor-refname="fileUpload"/> <interceptor-refname="checkbox"/> <interceptor-refname="staticParams"/> <interceptor-refname="params"> <paramname="excludeParams">dojo..*</param> </interceptor-ref> <interceptor-refname="conversionError"/> <interceptor-refname="validation"> <paramname="excludeMethods">input,back,cancel,browse</param> </interceptor-ref> <interceptor-refname="workflow"> <paramname="excludeMethods">input,back,cancel,browse</param> </interceptor-ref> </interceptor-stack> <interceptor-stackname="completeStack"> <interceptor-refname="defaultStack"/> </interceptor-stack> <interceptor-stackname="executeAndWaitStack"> <interceptor-refname="execAndWait"> <paramname="excludeMethods">input,back,cancel</param> </interceptor-ref> <interceptor-refname="defaultStack"/> <interceptor-refname="execAndWait"> <paramname="excludeMethods">input,back,cancel</param> </interceptor-ref> </interceptor-stack> <interceptor name="external-ref"/> <interceptor name="model-driven"/> <interceptor name="static-params"/> <interceptor name="scoped-model-driven"/> <interceptor name="servlet-config"/> <interceptor name="token-session"/> </interceptors> <!--定义默认拦截器为"defaultStack"--> <default-interceptor-refname="defaultStack"/> </package> </struts> |
2)struts.xml
该文件也是struts2框架自动加载的文件,在这个文件中可以定义一些自己的action,interceptor,package等,该文件的package 通常继承struts-default包。下面是这个文件的格式。
<?xml version="1.0"encoding="GBK"?> <!-- 下面指定Struts2配置文件的DTD信息--> <!DOCTYPE struts PUBLIC "-//ApacheSoftware Foundation//DTD Struts Configuration 2.0//EN" "http://struts.apache.org/dtds/struts-2.0.dtd"> <!-- struts是Struts 2配置文件的根元素--> <struts> <!-- 下面元素可以出现0次,也可以无限多次--> <constant name="" value=""/> <!-- 下面元素可以出现0次,也可以无限多次--> <bean type="" name="" scope=""static="" optional="" /> <!-- 下面元素可以出现0次,也可以无限多次--> <include file=""/> <!-- package元素是Struts配置文件的核心,该元素可以出现0次,或者无限多次--> <package name="必填的包名" extends="" namespace="" abstract="" externalReferenceResolver> <!-- 该元素可以出现,也可以不出现,最多出现一次 --> <result-types> <!-- 该元素必须出现,可以出现无限多次--> <result-type name=""default="true|false"> <!-- 下面元素可以出现0次,也可以无限多次--> <param name="参数名">参数值</param>* </result-type> </result-types> <!-- 该元素可以出现,也可以不出现,最多出现一次 --> <interceptors> <!-- 该元素的interceptor元素和interceptor-stack至少出现其中之一, 也可以二者都出现 --> <!-- 下面元素可以出现0次,也可以无限多次--> <interceptor name=""> <!-- 下面元素可以出现0次,也可以无限多次--> <param name="参数名">参数值</param>* </interceptor> <!-- 下面元素可以出现0次,也可以无限多次--> <interceptor-stackname=""> <!-- 该元素必须出现,可以出现无限多次--> <interceptor-refname=""> <!-- 下面元素可以出现0次,也可以无限多次--> <param name="参数名">参数值</param>* </interceptor-ref> </interceptor-stack> </interceptors> <!-- 下面元素可以出现0次,也可以无限多次--> <default-interceptor-refname=""> <!-- 下面元素可以出现0次,也可以无限多次--> <param name="参数名">参数值</param> </default-interceptor-ref> <!-- 下面元素可以出现0次,也可以无限多次--> <default-action-refname=""> <!-- 下面元素可以出现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="" method=""converter=""> <!-- 下面元素可以出现0次,也可以无限多次--> <param name="参数名">参数值</param>* <!-- 下面元素可以出现0次,也可以无限多次--> <result name=""type=""> 映射资源 <!-- 下面元素可以出现0次,也可以无限多次--> <param name="参数名">参数值</param>* </result> <!-- 下面元素可以出现0次,也可以无限多次--> <interceptor-refname=""> <!-- 下面元素可以出现0次,也可以无限多次--> <param name="参数名">参数值</param>* </interceptor-ref> <!-- 下面元素可以出现0次,也可以无限多次--> <exception-mapping name="" exception=""result=""> 异常处理资源 <!-- 下面元素可以出现0次,也可以无限多次--> <param name="参数名">参数值</param>* </exception-mapping> </action> </package>* <struts> |
3)struts.properties文件
这个文件是struts2框架的全局属性文件,也是自动加载的文件。该文件包含了系列的key-value对。该文件完全可以配置在struts.xml文件中,使用constant元素。下面是这个文件中一些常见的配置项及说明。
###指定加载struts2配置文件管理器,默认为org.apache.struts2.config.DefaultConfiguration ###开发者可以自定义配置文件管理器,该类要实现Configuration接口,可以自动加载struts2配置文件。 #struts.configuration=org.apache.struts2.config.DefaultConfiguration ###设置默认的locale和字符编码 #struts.locale=en_US struts.i18n.encoding=UTF-8 ###指定struts的工厂类 #struts.objectFactory = spring ###指定spring框架的装配模式 ###装配方式有: name, type, auto,and constructor (name 是默认装配模式) struts.objectFactory.spring.autoWire = name ###该属性指定整合spring时,是否对bean进行缓存,值为true or false,默认为true. struts.objectFactory.spring.useClassCache = true ###指定类型检查 #struts.objectTypeDeterminer = tiger #struts.objectTypeDeterminer = notiger ###该属性指定处理 MIME-typemultipart/form-data,文件上传 #struts.multipart.parser=cos #struts.multipart.parser=pell struts.multipart.parser=jakarta #指定上传文件时的临时目录,默认使用 javax.servlet.context.tempdir struts.multipart.saveDir= struts.multipart.maxSize=2097152 ###加载自定义属性文件 (不要改写struts.properties!) #struts.custom.properties=application,org/apache/struts2/extension/custom ###指定请求url与action映射器,默认为org.apache.struts2.dispatcher.mapper.DefaultActionMapper #struts.mapper.class=org.apache.struts2.dispatcher.mapper.DefaultActionMapper ###指定action的后缀,默认为action struts.action.extension=action ###被 FilterDispatcher使用 ###如果为 true则通过jar文件提供静态内容服务. ###如果为 false则静态内容必须位于 <context_path>/struts struts.serve.static=true ###被 FilterDispatcher使用 ###指定浏览器是否缓存静态内容,测试阶段设置为false,发布阶段设置为true. struts.serve.static.browserCache=true ###设置是否支持动态方法调用,true为支持,false不支持. struts.enable.DynamicMethodInvocation = true ###设置是否可以在action中使用斜线,默认为false不可以,想使用需设置为true. struts.enable.SlashesInActionNames = false ###是否允许使用表达式语法,默认为true. struts.tag.altSyntax=true ###设置当struts.xml文件改动时,是否重新加载. ### -struts.configuration.xml.reload = true ###设置struts是否为开发模式,默认为false,测试阶段一般设为true. struts.devMode = false ###设置是否每次请求,都重新加载资源文件,默认值为false. struts.i18n.reload=false ###标准的UI主题 ###默认的UI主题为xhtml,可以为simple,xhtml或ajax struts.ui.theme=xhtml ###模板目录 struts.ui.templateDir=template #设置模板类型. 可以为 ftl, vm, orjsp struts.ui.templateSuffix=ftl ###定位velocity.properties 文件. 默认 velocity.properties struts.velocity.configfile = velocity.properties ###设置velocity的context. struts.velocity.contexts = ###定位toolbox. struts.velocity.toolboxlocation= ###指定web应用的端口. struts.url.http.port = 80 ###指定加密端口 struts.url.https.port = 443 ###设置生成url时,是否包含参数.值可以为: none, get or all struts.url.includeParams = get ###设置要加载的国际化资源文件,以逗号分隔. #struts.custom.i18n.resources=testmessages,testmessages2 ###对于一些web应用服务器不能处理HttpServletRequest.getParameterMap() ###像 WebLogic, Orion, andOC4J等,须设置成true,默认为false. struts.dispatcher.parametersWorkaround = false ###指定freemarker管理器 #struts.freemarker.manager.classname=org.apache.struts2.views.freemarker.FreemarkerManager ###设置是否对freemarker的模板设置缓存 ###效果相当于把template拷贝到WEB_APP/templates. struts.freemarker.templatesCache=false ###通常不需要修改此属性. struts.freemarker.wrapper.altMap=true ###指定xsltresult是否使用样式表缓存.开发阶段设为true,发布阶段设为false. struts.xslt.nocache=false ###设置struts自动加载的文件列表. struts.configuration.files=struts-default.xml,struts-plugin.xml,struts.xml ###设定是否一直在最后一个slash之前的任何位置选定namespace. struts.mapper.alwaysSelectFullNamespace=false |