Struts2 注解零配置方法(convention插件使用)

jopen 9年前

最近接触到一个新的项目,是做一个使用S2SH的电子商务商城的二次开发。之前使用过S2SH,在此之前的项目中,Struts2 使用的是XML配置而这个项目是使用注解。在这个项目中,注解还不需要使用Action注解,struts会自动识别了指定包下的所有action文件, 我只需要配置result和过滤器就可以了。刚开始接触的时候,有点不习惯,但却觉得这样蛮好用的,后来了解了一下,这个是使用了Struts 2的convertion配置,主要的是要实现“约定优于配置”这个说法,这样做,只需要在配置文件进行少量的配置,然后接下来的开发过程中,开发人员可 以不再需要去配置xml,需要的是进行编码,一切的规则按照前期配置和convertion制定来执行。

 

关于

首先说明一下convention插件,它是Struts 2中进行注解的时候必须导入的包,提供的是注解功能,同时在Struts2的官方文档中说了,它还提供了实现开发零配置的功能,可以使开发者专注于编码,不用一边编写java一边编写xml。

当Struts 2启动的时候,convention插件会进行一次Action的查找,然后按照指定的规则,生成namespaces和Action 的名字,当用户访问的时候,只需要根据对应的规则进行访问,就能访问到指定的Action了。

生成规则

在此说明一下convention插件对Action的查找规则和URL的生成规则

Convention 插件默认扫描继承了action类的子类和文件名以Action结尾的文件

默认找的包是struts, struts2, action or action的包

如:

com.example.actions.MainAction

com.example.actions.products.Display (implements com.opensymphony.xwork2.Action)

com.example.struts.company.details.ShowCompanyDetailsAction

 

找到对应的类后,Convention 插件会根据包名生成namespaces地址

com.example.actions.MainAction -> /

com.example.actions.products.Display -> /products

com.example.struts.company.details.ShowCompanyDetailsAction -> /company/details

 

然后根据类名,去除Action后缀,然后取其余部分小写,若有大小写混合,以-进行连接生成最终访问地址

com.example.actions.MainAction -> /main

com.example.actions.products.Display -> /products/display

com.example.struts.company.details.ShowCompanyDetailsAction -> /company/details/show-company-details

 

对于返回值,Convention 插件会根据Action的名字+分隔符+返回值.jsp 的结果去指定目录下查找对应的结果文件。

 

配置

配置convention插件的主要方式,是在Struts.xml文件中添加相应的配置。说是零配置,实际上是一次配置便不再需要做其他的配置了。

 

要实现如我所说的这种方式,需要添加配置如下

<!-- 不进行扫描的包,用,分割,被包含的包,将不会被扫描成为action -->      <constant name="struts.convention.exclude.packages" value="com.sean.service" />      <!-- 进行扫描的根包,该包会被扫描成action -->      <constant name="struts.convention.action.packages" value="com.sean.action" />      <!-- 返回页面地址 -->      <constant name="struts.convention.result.path" value="/WEB-INF/content/" />      <!-- 用于进行action查找的后缀 -->      <constant name="struts.convention.action.suffix" value="Action" />      <!--用于生成action名字时的分隔符,比如DemoCustAction会被映射成为demo_cust,同时用于形成返回文件,比如访问DemoAction,return的值为input,插件会去指定不睦下,查找demo_input.jsp文件 -->      <constant name="struts.convention.action.name.separator" value="_" />      <!-- 指定的包会被进行扫描 -->      <constant name="struts.convention.package.locators" value="action,actions,struts,struts2" />      <!-- 返回页面类型 -->      <constant name="struts.convention.relative.result.types" value="dispatcher,velocity,freemarker" />      <!-- 开启动态调用函数,这个方法在struts2里面不推荐,可是在这里却可以实现动态方法的调用,不用自写action了 -->      <constant name="struts.enable.DynamicMethodInvocation" value="true" />      <!-- 开发模式 -->      <constant name="struts.devMode" value="true" />

实例

按照上述的配置配置,创建好项目后,我们进行创建两个Action进行测试,这两个Action除了继承了ActionSupport外,其他什么都不添加。

package com.sean.action;    import org.apache.struts2.convention.annotation.Result;  import org.apache.struts2.convention.annotation.Results;    import com.opensymphony.xwork2.ActionSupport;      public class DemoAction extends ActionSupport{        public String index(){          return "index";      }            public String index2(){          return SUCCESS;      }            public String index3(){          return INPUT;      }            public String index4(){          return "test";      }  }

package com.sean.action;    import com.opensymphony.xwork2.ActionSupport;    public class MyDemoAction extends ActionSupport{        public String index(){          return "index";      }  }

同时创建对应的jsp文件:

Struts2 注解零配置方法(convention插件使用)

 

当我们的Action名中含有多个大小写的时候,我们需要按照分隔符的规则进行访问

Struts2 注解零配置方法(convention插件使用)

 

插件会根据返回值,查找到对应的jsp,比如DemoAction的index返回的字符串是index,我们设置的分隔符是_,那么他找到的是demo_index.jsp

Struts2 注解零配置方法(convention插件使用)

进过测试,如果函数返回的值,找不到与其对应的文件的时候,插件会以action名去查找对应的文件,如果还查找不到的话,就会报错。比 如,index4函数返回的是test,按道理应该查找demo_test.jsp,但是因为没有,插件会去查找demo.jsp来返回,如果还是没有, 则报错。

Struts2 注解零配置方法(convention插件使用)

 

最后,说一下这种配置方法的优劣。这种方法,之前说了,就是实现“约定由于配置”这个说法,这样做,在项目开发之初制定好相应的规则,开发人员就可 以按照对应的规则进行开发,使项目更加规范。不过这里面也有一些劣势,因为这是Struts提供的插件,大部分的规则还是得顺着插件来,规则的制定者还是 要收到插件的规则约束的。

 来自:http://www.cnblogs.com/Seanit/p/4620743.html