Struts2 Convention Plugin 配置

Struts2使用Convention插件,实现零配置。零配置并不是没有配置，而是通过约定大于配置的方式，大量通过约定来调度页面的跳转而使得配置大大减少。struts.xml 代码如下：

<?xml version="1.0" encoding="UTF-8" ?>                                                                                                                                                                                                                                                                                                                                                                  
 <!DOCTYPE struts PUBLIC                                                                                                                                                                                                                                                                                                                                                                                  
   "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"                                                                                                                                                                                                                                                                                                                                      
   "http://struts.apache.org/dtds/struts-2.0.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" />
	<!-- 开发模式结束 -->
	<!-- 主题， 不用dojo的及struts2复杂标签样式的就把主题设置为simple，这样可以不加载多余的模板。  -->
	<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名中使用斜线 。
		如果开启action名称可以有“/”，一个请求地址有多个“/”，struts2就不会再使用类路径扫描的命名空间，只会使用配置的名称。
		所以既想action名称里使用“/”，又想用struts2默认搜索的命名空间，只能自己修改一下convention插件的实现类了。
	-->
	<constant name="struts.enable.SlashesInActionNames" value="false" />
	<!--
		结果资源所在路径。
		convention插件会自动在此路径中寻找文件。默认放到WEB-INF的目的的保护文件资源，只能通过程序内部跳转才能访问，
		我们的权限拦截器或其他权限处理只要加到action上就可以了。
	-->
	<constant name="struts.convention.result.path" value="/" />
	<!-- action后缀。比如为HelloWorldAction。按照配置，actionName为hello_world。 -->
	<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="_" />
	<!-- 是否禁用扫描。一定要设为false，否则convention插件不起作用，零配置也没有意义。  -->
	<constant name="struts.convention.action.disableScanning"
		value="false" />
	<!--
		设置默认的父包，一般我们都设置一个default包继承自struts-default。大部分类再继承default。
		如果有特殊的类需要特殊的包，只能在action中再指定父包了。
	-->
	<constant name="struts.convention.default.parent.package"
		value="default" />
	<!--
		确定搜索包的路径。只要是包含action的包都要搜索。basePackage按照默认不用配置，如果配置，只会找以此配置开头的包。locators及locators.basePackage都是一组以逗号分割的字符串。
	-->
	<constant name="struts.convention.package.locators" value="action" />
	<!-- 禁用包搜索 -->
	<constant name="struts.convention.package.locators.disable"
		value="false" />
	<!-- 只会搜索以该配置开头的包  -->
	<constant name="struts.convention.package.locators.basePackage"
		value="com.skyon.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="" />
	<!-- 结果类型 。按顺序先找相关的dispatcher的jsp文件是否存在。然后再找freemarker 。-->
	<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>