struts2 convention配置中常见配置选项及说明

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

 <!--开发模式设置开始//-->
 <!--++++++++++++++++++++++++++++++++++++++++++++++++开发状态 -->
 <constant name="struts.devMode" value="true" />
 <!-- 国际化资源重新加载 -->
 <constant name="struts.i18n.reload" value="true" />
 <!-- 配置文件重新加载 -->
 <constant name="struts.configuration.xml.reload" value="true" />
 <!-- convention类从新加载 -->
 <constant name="struts.convention.classes.reload" value="true" />
 <!--++++++++++++++++++++++++++++++++++++++++++++++++开发模式结束 -->
 <!-- 主题 -->
 <constant name="struts.ui.theme" value="simple" />
 <!-- 地区 -->
 <constant name="struts.locale" value="zh_CN" />
 <!-- 国际化编码 -->
 <constant name="struts.i18n.encoding" value="UTF-8" />
 <!-- 扩展-->
 <constant name="struts.action.extension" value="action,do,jsp" />
 <!-- 启用动态方法调用 -->
 <constant name="struts.enable.DynamicMethodInvocation" value="true" />
 <!-- 设置Struts 2是否允许在Action名中使用斜线 -->
 <constant name="struts.enable.SlashesInActionNames" value="false" />
 <!-- 结果资源所在路径 -->
 <constant name="struts.convention.result.path" value="/"/>
 <!-- action后缀 -->
 <constant name="struts.convention.action.suffix" value="Action"/>
 <!-- 名称首字母小写 -->
 <constant name="struts.convention.action.name.lowercase" value="true"/>
 <!-- 分隔符 一个action名字的获取。比如为HelloWorldAction。按照配置，actionName为hello_world。 -->
 <constant name="struts.convention.action.name.separator" value="_"/>
 <!-- 禁用扫描 -->
 <constant name="struts.convention.action.disableScanning" value="false"/>
 <!-- 默认包 -->
 <constant name="struts.convention.default.parent.package" value="default"/>
 <!--确定搜索包的路径。只要是结尾为action的包都要搜索。basePackage按照默认不用配置，如果配置，只会找以此配置开头的包。locators及locators.basePackage都是一组以逗号分割的字符串。 -->
 <constant name="struts.convention.package.locators" value="actions"/>

<!-- 禁用包搜索 -->

<constant name="struts.convention.package.locators.disable" value="false"/>
 <!-- 基于什么包 -->
 <constant name="struts.convention.package.locators.basePackage" value="com.sunflower.actions"/>
 <!-- 排除的包 -->
 <constant name="struts.convention.exclude.packages" value="org.apache.struts.*,org.apache.struts2.*,org.springframework.web.struts.*,org.springframework.web.struts2.*,org.hibernate.*"/>
 <!-- 包含的包 --> <!-- 包括的jar,一般用于大型项目，其action一般打包成jar -->
 <constant name="struts.convention.action.includeJars" value="" />
 <!-- 结果类型 -->
 <constant name="struts.convention.relative.result.types" value="dispatcher,freemarker"/>
 <!-- 如果此值设为true，如果一个action的命名空间为/login，名称为HelloWorldAction。result返回值是success， 默认会找到/WEB-INF/pages/login/hello_world.jsp（如果有hello_world_success.jsp就找这个 文件，连接符“_”是在<constant name="struts.convention.action.name.separator" value="_"/>中配置的）。如果有一个action的result返回值是“error”，就会找/WEB-INF/pages /login/hello_world_error.jsp。 如果此值设为false，如果一个action的命名空间为/login，名称为HelloWorldAction。result返回值是 success，默认会找到/WEB- INF/pages/login/hello_world/index.jsp（如果有success.jsp就找这个文件）。如果有一个action的 result返回值是“error”，就会找/WEB-INF/pages /login/hello_world/error.jsp。 -->
 <constant name="struts.convention.result.flatLayout" value="true"/>
 <constant name="struts.convention.action.mapAllMatches" value="false"/>
 <!-- 检查是否实现action -->
 <constant name="struts.convention.action.checkImplementsAction" value="true"/>
 <constant name="struts.mapper.alwaysSelectFullNamespace" value="false"/>
 <constant name="struts.convention.redirect.to.slash" value="true"/>
 <package name="default" extends="struts-default">
  <interceptors>
   <interceptor-stack name="defaultStack">
    <interceptor-ref name="exception" />
    <interceptor-ref name="servletConfig" />
    <interceptor-ref name="actionMappingParams" />
    <interceptor-ref name="staticParams" />
    <interceptor-ref name="params" />
   </interceptor-stack>
  </interceptors>
 </package>
 </struts>