struts2基于Convention插件的约定映射使用

一、首先说明一点：所谓的基于Convention插件的约定优于配置的使用，并不是严格意义上的零配置，struts.xml文件并不能完全舍弃。

获得Convention插件功能，所必需的jar包有：｜asm-x.x.jar｜asm-commons-x.x.jar｜struts2-convention-plugin-x.x.jar｜

如果将struts2-config-browser-plugin-x.x.jar放入项目中，则可以通过http://{ip}:{port}/{Application}/config-browser/actionNames.action来查看应用中的映射关系

其中常用的配置信息有

Convention插件的常量

struts.convention.action.disableJarScanning	设置是否从Jar包里搜索Action类。如果开发者喜欢将Acion类打包成JAR，则应将该常量设为true。默认值为true。
struts.convention.action.packages	Convention插件以该常量指定包做为根包来搜索Action类
struts.convention.result.path	设置Convention插件定位仕途资源的根路径。默认值为/WEB-INF/content
struts.convention.result.flatLayout	如果设置为false，则可以将是土页面放置到Action对应的目录下（无须放入WEB-INF/content）
struts.convention.action.suffix	Convention搜索Action类的类名后缀，默认值为Action
struts.convention.action.disableScanning	是否禁止通过包扫描Action。默认值是false
struts.convention.action.mapAllMatches	设置即使没有@Action注解，依然创建Action影射。默认值为false
struts.convention.action.checkImplementsAction	设置是否将实现了Action接口的类映射成Action,默认值是false
struts.convention.default.parent.package	设置Convention映射的Action所在包的默认父包，默认值是convention-default
struts.convention.action.name.lowercase	设置映射Action时，是否将Action的name属性值转换为所有字母小写，默认值是false
struts.convention.action.name.separator	设置映射Action时指定Acion的name属性值各单词之间的分隔符，默认值是中划线
struts.convention.package.locators	Convention插件使用该常量指定的包做为搜索Action的根包。默认值是action，actions，struts，struts2
struts.convention.package.locators.disable	指定禁止从Action的根包里搜寻Action。默认值是false
struts.convention.exclude.packages	指定排除在搜索Action之外的包。默认值为org.apache.struts.*,org.apache.struts2.*,
struts.convention.packae.locators.basePackage	如果指定了该常量，Convention只会从以该常量值开始的包中搜索Action类
struts.convention.relative.result.types	指定Convention映射Result时默认支持的结果类型，默认值是dispatcher,velocity,freemarker
struts.convention.redirect.to.slash	设置是否重定向到斜线（／）。例如用户请求/foo，但/foo不存在时，如果设置该常量为true则可重定向到/foo/。默认值是true

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

二、每个Action的name属性，根据该Action的类名映射，映射Action的name时，遵循如下两步规则。

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

2.将Action类名的驼峰写法转成中划线写法，所有字母小写。

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

 

三、Action处理用户请求以后会返回一个字符串做为逻辑视图，该逻辑视图必需映射到实际的物理视图。Convention默认也为作为逻辑视图和物理视图之间的映射提供了约定。

默认情况下，Convention总会到Web应用的WEB-INF/content路径下定位物力资源，定位资源的约定时actionName+resultcode+suffix。当某个逻辑视图找不到对应的物理视图资源时，Convention会自动试图使用actionName＋suffix作为物理视图资源。

 

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

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

2.第二个Action与第一个Action处于同一个包下

3.第二个Action映射的URL为：firstactionName+resultcode

例如第一个Action类名为FirstAction，并且返回second字符串，则第二个Action的类名为FirstSecondAction，且两个Action在同一个包下，且视图资源中没有first-second.jsp或者first.jsp的物理视图资源。