convention-plugin

1.官方介绍的地址：

http://struts.apache.org/2.1.6/docs/convention-plugin.html

2.struts.xml文件配置

只挑选几个重要的常量说明：

(1) <constant name="struts.locale" value="zh_CN"/>

      <constant name="struts.i18n.encoding" value="UTF-8"/>

struts2.1.6 
现在只需要一个struts.xml文件就可以了。以前配struts.locale=zh_CN，struts.i18n.encoding＝UTF-
8，应用起动时会报一个警告，说没有配置locale，必须要在struts.properties里面配置才不会报错，现在这个问题已经解决了，所有配
置都可以在xml文件中指定了。

(2) <constant name="struts.action.extension" value="action,do,,"/>

扩展名可以指定为空。这样地址栏比较好看。但也会有个问题，就是一些其他servlet映射，如cxf，我们会映射地址为/services/*，现在这
个地址也变成struts2控制范围的地址了，如果按默认的配置会报找不到action的错误。解决办法是修改mapper类。这在以后文章中会提到。

(3)  <constant name="struts.enable.DynamicMethodInvocation" value="true"/>

       <constant name="struts.enable.SlashesInActionNames" value="true"/>

开启动态方法。要实现零配置，就是需要动态方法调用。开启action名称可以有
“/”，一个请求地址有多个“/”，struts2就不会再使用类路径扫描的命名空间，只会使用配置的名称。所以既想action名称里使用“/”，又想
用struts2默认搜索的命名空间，只能自己修改一下convention插件的实现类了。

(4) <constant name="struts.ui.theme" value="simple"/>

不用dojo的及struts2复杂标签样式的就把主题设置为simple，这样可以不加载多余的模板。

(5) <constant name="struts.devMode" value="true"/>

      <constant name="struts.i18n.reload" value="true"/>

      <constant name="struts.configuration.xml.reload" value="true"/>

      <constant name="struts.convention.classes.reload" value="true" />

开启开发者模式，在平时开发时修改action的annotation配置可以不重启，但是修改struts.xml文件还是要重启。修改类的具体内容，debug模式下可以不重启，或是使用javarebel，这个不在讨论范围。

(6)  <constant name="struts.convention.result.path" value="/WEB-INF/pages/"/>

指定结果页面路径。 convention插件会自动在此路径中寻找文件。放到WEB-INF的目的的保护文件资源，只能通过程序内部跳转才能访问，我们的权限拦截器或其他权限处理只要加到action上就可以了。

(7) <constant name="struts.convention.action.suffix" value="Action"/>

     <constant name="struts.convention.action.name.lowercase" value="true"/>

     <constant name="struts.convention.action.name.separator" value="_"/>

一个action名字的获取。比如为HelloWorldAction。按照配置，actionName为hello_world。

(8)<constant name="struts.convention.action.disableScanning" value="false"/>

是否不扫描类。一定要设为false，否则convention插件不起作用，零配置也没有意义。

(9)<constant name="struts.convention.default.parent.package" value="default"/>

设置默认的父包，一般我们都设置一个default包继承自struts-default。大部分类再继承default。如果有特殊的类需要特殊的包，只能在action中再指定父包了。

(10) <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=""/>

　　　确定搜索包的路径。只要是结尾为action的包都要搜索。basePackage按照默认不用配置，如果配置，只会找以此配置开头的包。locators及locators.basePackage都是一组以逗号分割的字符串。

(11)  <constant name="struts.convention.exclude.packages"
value="org.apache.struts.*,org.apache.struts2.*,org.springframework.web.struts.*,org.springframework.web.struts2.*,org.hibernate."/>

　　　排除哪些包不搜索。按默认配置即可。逗号分割字符串。

(12)  <constant name="struts.convention.action.includeJars" value="" />

　　　包括哪些jar包中的action。逗号分割字符串。

(13)<constant name="struts.convention.relative.result.types" value="dispatcher,freemarker,velocity"/>

　　　默认返回的结果类型搜索。按顺序先找相关的dispatcher的jsp文件是否存在。然后再找freemarker，再找velocity。

(14)<constant name="struts.convention.result.flatLayout" value="true"/>

如果此值设为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。

(15) <constant name="struts.convention.action.mapAllMatches" value="false"/>

       <constant name="struts.convention.action.checkImplementsAction" value="false"/>

　   <constant name="struts.mapper.alwaysSelectFullNamespace" value="false"/>

　   <constant name="struts.convention.redirect.to.slash" value="true"/>

这几个配置没有太多的实际意义，本着最小检查的原则就可以。

(16)默认拦截器配置，已经简化了许多，一般不需要chain和
fileupload。modelDriven也没什么用，如果我们要使用restfull插件会有用。其实最简单只要一个params就可以了。我加入

exception是为了开发时的异常。servletConfig是为了包装一下request,reponse等对象，staticParams是为
了可以配置${}形式参数。actionMappingParams是struts2.1新增的，我初步认为是可以在action配置中传参数，这个还有
些疑问。

1. <package name="default" extends="struts-default">
2. <interceptors>
3. <interceptor-stack name="defaultStack">
4. <interceptor-ref name="exception" />
5. <interceptor-ref name="servletConfig"/>
6. <interceptor-ref name="actionMappingParams"/>
7. <interceptor-ref name="staticParams"/>
8. <interceptor-ref name="params" />
9. </interceptor-stack>
10. </interceptors>
11. </package>