struts 2读书笔记-----Convention插件与“约定”支持

Convention插件的主要特点是“约定优于配置”。

Action的搜索和映射约定

为了能够使用Convention插件，必须在Struts 2 应用中安装Convention插件，即将Struts2-convention-plugin.jar文件复制到Struts 2应用的WEB-INF/lib路径下。

对于convention插件而言，他会对以下两种java类的Action处理：

1、 所有实现了com.opensymphony.xwork2.Action的java类

2、 所有类名以Action结尾的java类

Struts 2的convention插件还允许设置如下三个常量

常量	说明
Struts.convention.exclude.packages	指定不扫描那些包的java类，位于这些包结构下的java类将不会被自动映射成Action
Struts.convention.package.locators	Convention插件使用该常量指定的包作为搜索Action的根包。如：对于action.user.LoginAction类，按约定本应映射到/user/login； 如果将该常量设置为user,则该Action将会映射到/login
Struts.convention.action.packages	Convention插件以该常量指定包作为根包来搜索Action类。

当找到合适的Action类后，Convention插件将会按照约定部署这些Action。部署Action时，actions、action、struts、struts2包会映射成根命名空间，而这些包下的子包则会被映射成对应的命名空间。

如：

Com.app.action.books.GetBooks 映射到/books

Com.app.action.RegistAction 映射到/

Com.app.action.struts.manage.user.UserAction 映射到/manage/user

按约定映射name属性

Action的name属性（即该action所要处理的URL），根据该Action的类名映射，映射Action的name时，需要遵循如下两个步骤：

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

2、 将Action类名的写法（每个单词首字母大写、其他字幕小写）转成中划线写法（有字母小写，单词与单词之间用中划线隔开）。

如：

Com.app.action.LoginAction 映射到：/login.action

Com.app.action.user.loginAction 映射到：user/login.action

Com.app.action.user.loginRegistAction 映射到：user/login-regist.action

对于Action类的代码依然不需要做任何的改变。

按约定映射result

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

默认情况下，convention总会到Web应用的WEB-INF\content路径下定位物理资源。故定位资源约定为、：actionName+resultCode+suffix。当某个逻辑视图找不到对应的视图资源是，convention会自动试图使用actionName+suffix作为物理视图资源

如:假定所有的结果类型全部为：Dispatcher

Action的URL	返回的逻辑视图名	对应的物理视图
/login	success	\WEB-INF\content\login-success.jsp
/user/login	success	\WEB-INF\content\user\login-success.jsp
/user/regist	error	\WEB-INF\content\user\regist-error.jsp

Action键的约定

如果想一个Action处理结束后不是进入视图页面，而是进入另一个Action形成Action链。则只需要遵守下面三个约定：

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

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

3、第三个Action映射的URL为：firstactionname+resultcode

下面是一个实例：

第一个Action处理用户请求后、转到第二个Action继续处理。再由第二个Action转到视图页面，并打印相应的信息

第一个Action：FirstActionjava

public class FirstAction extends ActionSupport{
	private String tip1;

	public String getTip1() {
		return tip1;
	}
	
	public void setTip1(String tip1) {
		this.tip1 = tip1;
	}

	public String execute(){
		setTip1("第一个action提示");
		return "second";
	}
}

该Action处理用户请求后返回“second”字符串，为了让该Action处理结束后进入第二个Action。对于这个返回的字符串，第二个Action的映射的URL应为：first-second。

所以第二个Action的类名为：FirstSecondAction。

下面是第二个Action：FirstSecondAction.jsp

public class FirstSecondAction extends ActionSupport {

	private String tip2;
	
	public String getTip2() {
		return tip2;
	}

	public void setTip2(String tip2) {
		this.tip2 = tip2;
	}

	public String execute() throws Exception {
		setTip2("第二个action 提示....");
		return SUCCESS;
	}
	
}

当firstAction处理用户请求之后，系统将会自动调用FirstSecondAction处理用户请求。然后转到视图资源。

第一个jsp页面：thefirst.jsp点击按钮后，转到第一个action处理用户请求 该Action=”first“

<form action="first">            
    	<input type="submit" value="点击链接第二个action">
</form>

第二个jsp页面：第二个视图资源。当第二个Action处理用户请求完后，转到该视图资源。并打印相应的信息 。

由于第二个Actiond的result的映射是：first-second-success。所以该视图资源的名字为：first-second-success.jsp

	${tip1 }<Br />
   	${tip2 }<br />

将会得到下面的显示页面：

读李刚《轻量级java EE企业应用实战（第三版）—struts 2+Spring 3+Hibernate整合开发》