Struts2 struts2-convention-plugin(零配置)基础

零配置并不是没有配置，而是通过约定大于配置的方式，大量通过约定来调度页面的跳转而使得配置大大减少。

 

一、如何使用Convention

1. 将struts-Convention-plugin-2.1.6.jar文件复制到WEB-INF/lib路径下

2. 对于Convention插件而言，它会自动搜索位于action，actions，struts，struts2包下的所有java类，Convention插件会把如下两种java类当成Action处理：

(1） 所有实现了com.opensymphony.xwork2.Action接口的java类

(2） 所有类名以Action结尾的java类

 

3. 映射Action的name时，遵循如下两步规则：

1） 如果该Action类名包含Action后缀，将该Action类名的Action后缀去掉。否则不做任何处理。

2） 将Action类名的驼峰写法（每个单词首字母大写、其他字母小写的写法）转成中画线写法（所有字母小写，单词与单词之间以中画线隔开）

如：LoginAction映射的Acion的name属性为login，GetBooks映射的Action的name的属性为get-books，AddEmployeeAction映射的Action的name属性为add-employee

 

 

下面是actiong和结果模版的映射关系：

URL Result 

File that could match Result Type

/hello success /WEB-INF/content/hello.jsp Dispatcher

/hello success /WEB-INF/content/hello-success.htm Dispatcher

/hello success /WEB-INF/content/hello.ftl FreeMarker

/hello-world input /WEB-INF/content/hello-world-input.vm Velocity

/test1/test2/hello error /WEB-INF/content/test/test2/hello-error.html Dispatcher如：下面Action所在包被映射的命名空间如下：

com.fun.actions.LoginAction 映射到 /

com.fun.actions.myoffice.CarInfoAction 映射到 /myoffice

com.fun.struts.myoffice.EntINfoAction 映射到 /myofiice

 

4. 默认情况下。Convention总会到WEB应用的WEB-INF/content路径下定位物理资源，定位资源的约定是：actionRUL+resultCODE+suffix。当某个逻辑视图找不到对应的试图资源时，Convention会自动视图使用ActionURL+suffix作为物理视图资源。

如：actions.fore.LoginAction 返回success字符串时，Convention优先考虑使用WEB-INF/content/fore目录下的login-success.jsp作为视图资源。如果找不到该文件，login.jsp也可作为对应的试图资源。如果返回input字符串，Convention会将WEB-INF/content/fore里面查找login-input.jsp

5.Action链的约定

如果希望一个Action处理结束后不是进入一个试图页面，而是进行另一个Action形成的Action链。通过Convention插件则只需遵守如下三个约定即可。

1） 第一个Action返回的逻辑视图字符串没有对应的视图资源

2） 第二个Action与第一个Action处在同一个包下

3） 第二个Action影射的URL为：firstActionURL+resultCODE

如，第一个Action为OneAction，里面有个方法返回为“two”,那么就得保证，WEB-INF/content/下没有one.jsp或one-two.jsp 对于第二个action 它的名字应该是OneTwoAction，而对应的url应该是：“one-two.action”

 

 

 

几个重要的常量

struts.convention.action.disableJarScanning---是否从包中搜索Action

struts.convention.action.package--------Convention插件以该常量指定包作为根包

struts.convention.result.path ---设置Convention插件定位视图资源的根路径。默认值为/WEB-INF/content

struts.convention.result.flatLayout—如果是为false则可以将试图放置Action对应的目录下，无需放入WEB-INF/content

 

注：

 

1） struts.Convention.exclude.packges:指定不扫描哪些包下的java类，位于这些包结构下的java类将不会自动映射成Action；

2） struts.convention.package.locators:Convention插件使用该常量指定的包作为搜寻Action的根包。对于actions.fore.LoginAction类，按约定原本应映射到/fore/login;如果将该常量设为fore，则该Action将会映射到/login

3） struts.convention.action.packages:Convention插件以该常量指定包作为根包来搜索Action类。Convention插件除了扫描action,actions,struts,struts2四个包的类以外，还会扫描该常量指定的一个或多个包，Convention会试图从中发现Action类。

注意：struts.convention.package.locators和struts.convention.action.packages两个常量的作用比较微妙，开发者在利用这两个常量时务必小心。