收藏私塾在线
 

欢迎您来到私塾在线网!   

请登录! 

免费注册 


struts2的笔记
状态: 离线
人气:566209
访问用户量:841
笔记经验:470
总积分:567
级别:普通会员
搜索本笔记
ta的交流分类
ta的交流主题贴(5)
ta的所有交流贴(5)
ta的全部笔记
全部笔记(89)
未分类笔记(3)
研磨struts2(86)
存档
2012-04(85)
2012-03(4)

2012-07-30 15:28:45
《研磨struts2》第二十一章 零配置 之 21.2 约定大于配置
浏览(8349)|评论(2)   交流分类:Java|笔记分类: 研磨struts2

21.2  约定大于配置

21.2.1  约定大于配置的HelloWorld

先来做一个示例,让大家体会一下什么是约定大于配置。

1:Convention Plugin

从Struts2.1版本起,Struts2官方就推荐使用Convention Plugin替换Codebehind Plugin来实现零配置。相对Codebehind Plugin而言,Convention Plugin有如下一些特点:

  • 通过包的命名习惯来指定Action的位置
  • 通过命名习惯来约定Result(包括Jsp、FreeMarker等)的路径
  • 类名对应于URL的约定转换
  • 包名对应于命名空间的约定转换
  • 遵循SEO规范的链接地址,比如:使用test-action来替换TestAction
  • 基于注解的Action名称约定
  • 基于注解的拦截器约定
  • 基于注解的命名空间约定
  • 基于注解的XWork包
  • 默认action以及默认的Result

等等。总之,使用Convention Plugin来实现零配置,会更灵活、更彻底,基本上可以做到不需要struts.xml来进行配置,甚至不需要注解进行配置,完全由Struts2依靠约定进行自动配置即可。

2:设置环境

要使用Convention Plugin,需要把struts2-convention-plugin-2.1.8.1.jar包拷贝到web工程的WEB-INF\lib包里面。

3:最简单的HelloWorld

要示范零配置,当然首先去掉struts.xml文件,缺省情况下,Convention Plugin会约定所有的结果页面都存放在WEB-INF\content文件夹下。

在WEB-INF文件夹下新建一个content文件夹,然后在content文件夹下新建一个名称为helloworld.jsp的文件,内容示例如下:

 

java代码:
<%@ page contentType="text/html; charset=gb2312" pageEncoding="gb2312"%>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
<title>Insert title here</title>
</head>
<body>
	约定配置,Hell World
</body>
</html>

访问的方式是:在web上下文后面直接访问这个页面,不用加后缀,直接用名字就可以了,也就是URL为:http://localhost:9080/helloworld/helloworld,运行结果如下:

图21.1  约定配置示例

4:说明

在这个HelloWorld里面,根本就没有写Action,当然也不存在struts.xml文件,完全是按照Convention Plugin的约定来运行,直接到WEB-INF/content文件夹下面,根据请求的url来找到对应的helloworld.jsp,然后直接运行这个页面就得到了如上的运行结果。

那么对于Convention Plugin来说,到底有哪些约定呢?

21.2.2  常见的约定

1默认把所有的结果页面都存储在WEB-INF/content文件夹下,这个值可以通过在struts.xml或者struts.properties文件中设置struts.convention.result.path这个属性的值来改变到其他路径。示例如下:

 

java代码:
<constant name="struts.convention.result.path" value="/WEB-INF/mypage" />

       这样就将默认的result页面路径设置到了WEB-INF/mypage文件夹里面。

2在应用启动的时候,Convention插件会自动搜索位于action、actions、struts、struts2的包及其子包下的所有Java类,以搜索Action类。

       可以通过在struts.xml或者struts.properties文件中设置struts.convention.package.locators这个属性的值来改变搜索的文件夹。示例如下:

 

java代码:
<constant name="struts.convention.package.locators" value="web,s2" />

       上面的示例定义了:在项目中,包路径中包含web和s2的将被视为包含Action类的路径而被搜索。

3在应用启动的时候,Convention插件在上述包及其子包的路径下搜索满足如下条件的类来作为Action类:

(1)       实现com.opensymphony.xwork2.Action的类

(2)       类名以Action结尾的Java类

比如:在cn.javass.testproject.action包下面,有一个HelloAction的类,那么Convention插件会自动把这个HelloAction类当作Action来进行处理。

4在映射Action的名称的时候,通常遵循如下规则:

(1)       如果该Action类名以Action作为后缀,那么会将后缀的Action去掉,其他的不做处理。

(2)       如果该Action类名采用驼峰式的写法,也就是每个单词首字母大写的写法,那么需要把所有字母变成小写,单词与单词之间以中画线隔开。
    比如有一个Action的名称为HelloWorldAction,那么对应的映射资源的名称为hello-world。

(3)       如果是单个词的Action名称,那么把它的所有字母变成小写,作为对应的映射资源的名称。比如Action类名为HelloAction,它是以Action作为后缀的,那么对应的映射资源的名称为先去掉Action后缀,得到Hello,又是单个词的名称,变成小小,那么最终对应的映射资源的名称为hello。

5:命名空间

从定义的package.locators开始到包结束的部分,就是命名空间。比如有一个Action类位于如下包中:cn.javass.testproject.action.t1.t2,那么命名空间就是/t1/t2。

命名空间对应着访问的url中的path部分,位于web上下文之后,具体的资源名称之前的部分,比如访问的url为:http://localhost:9080/helloworld/t1/t2/hello-world,其中的helloworld就是web上下文,而后面的hello-world就是要访问的资源的名称,中间的/t1/t2就是url的path部分。

命名空间还对应着WEB-INF/content文件夹下的子文件夹路径,如果命名空间为/t1/t2,那就以为着对应的result页面,应该放在WEB-INF/content/t1/t2文件夹下。

6:对应resutl页面的约定

(1)       Result页面默认的都以WEB-INF/content作为定位的起点。

(2)       如果没有对应的Action存在,那么访问资源的名称就直接和页面的名称对应,要注意都是小写的

(3)       如果有对应的Action存在,那么对应的方式是:优先按照“Action的URL+Result的字符串+文件类型的后缀”的方式进行对应,如果没有对应的页面,那么也可以按照“Action的URL+文件类型的后缀”的方式进行对应。

7:Action链的约定

如果一个Action执行完成后,希望进入到另外一个Action,从而形成Action链,基本的约定如下:

(1)       第一个Action返回的result没有对应的页面存在。

(2)       第二个Action和第一个Action在同一个包中,而且第二个Action映射的URL为:第一个Action映射的URL+返回的result字符串,而且名称采用驼峰式的写法,也就是首字母大写。

21.2.3  示例常见的约定

看了上面的约定,感觉如何,很糟糕是不是,这些约定的规则太抽象了,具体怎么使用呢?接下来就通过示例来说明。

1:没有Action的时候,就如同前面约定大于配置的HelloWorld那样,访问的URL为:http://localhost:9080/helloworld/helloworld,由于没有对应的Action,因此直接到WEB-INF的content文件夹下面,寻找名称为“helloworld”,后缀可以为“.jsp”、“.htm”、“.html”等的页面,找到后就直接运行。

2:如果有如下的包结构和类的定义:

图21.2  示例的包结构

(1)如果要运行HelloWorldAction的话,对应的URL应该为:http://localhost:9080/helloworld/t1/t2/hello-world,而且在content文件夹下应该有t1文件夹,t1文件夹下应该有t2文件夹,t2文件夹下应该有相应的result页面,如下图:

图21.3  t2文件夹示例

像这个示例中,同时存在hello-world-success.jsp和hello-world.jsp,那么会优先匹配到hello-world-success.jsp,如果不存在hello-world-success.jsp才匹配hello-world.jsp。

(2)先看看ConventionAction的实现,示例代码如下:

 

java代码:
public class ConventionAction extends ActionSupport{
	public String msg = "";
	public String userId = "";	
	
	public String execute() throws Exception {
		System.out.println("now in ConventionAction");
		if(userId==null || userId.trim().length()==0){
			msg = "用户编号不能为空";
			return "toadd";
		}
		msg = "用户编号输入正确";
		return SUCCESS;
	}
}

此时在content文件夹下,有如下图所示的页面:

图21.4 content文件夹

如果运行的URL为:http://localhost:9080/helloworld/convention?userId=22,那么会匹配到ConventionAction这个类,运行结束后,返回success。接下来到content文件夹下去优先匹配到convention-success.jsp,然后运行这个页面,展示给用户。

如果运行的URL为:http://localhost:9080/helloworld/convention,那么会匹配到ConventionAction这个类,运行结束后,返回toadd。接下来到content文件夹下去优先匹配到convention-toadd.jsp,然后运行这个页面,展示给用户。

如果此时把convention-toadd.jsp文件去掉,然后再次运行,运行的URL同样为:http://localhost:9080/helloworld/convention,那么会匹配到ConventionAction这个类,运行结束后,返回toadd。接下来到content文件夹下去寻找匹配的页面,没有能匹配上的,那么就会到ConventionAction这个类的同包下,寻找是否有ConventionToaddAction这个类,有这个类,那么就会运行这个类,相当于是Action链了。

 

私塾在线网站原创《研磨struts2》系列

转自请注明出处:【http://sishuok.com/forum/blogPost/list/0/4184.html

欢迎访问http://sishuok.com获取更多内容

相关笔记推荐
精品视频课程推荐

Weblogic实战视频教程
WebLogic基础知识:WebLogic基本概念、正确安装WebLogic、建域、应用部署于JDBC选择、对WebLogic的监控和日志查看、集群的高可用性;课程目标:彻底掌握WebLogic的基本概念,在理解基本概念的基础上做到正确的安装WebLogic,根据不同的需求创建域,合理选择应用部署和JDBC配置。熟练掌握WebLogic的console监控,了解各种性能和运行指标,以及对监控结果的分析,运用集群的高可用性,对集群架设。

研磨设计模式——跟着cc学设计系列视频教程
本视频课程是北京Java私塾原创精品书籍《研磨设计模式》一书的配套学习视频,由《研磨设计模式》的第一作者CC录制 课程目标:全面、系统的掌握GoF设计模式的知识,达到可以在实际项目开发中运用的能力 技术要点:如何实现可配置、如何实现缓存以及缓存的管理、如何实现用缓存来控制多实例的创建、如何实现参数化工厂、 如何实现可扩展工厂、如何实现原型管理器、如何实现Java的静态代理和动态代理、如何实现多线程处理队列请求、 如何实现命令的参数化配置、可撤销的操作、宏命令、队列请求和日志请求、如何实现翻页迭代、如何检测环状结构、 如何实现通用的增删改查、如何模拟工作流来处理流程、如何实现简单又通用的XML读取、如何实现模拟AOP的功能......

struts2防重复提交视频教程
深入浅出的讲解在Struts2开发中,如何防止页面的重复提交

深入浅出学Spring Web MVC视频教程
系统、完整的学习Spring Web MVC开发的知识。包括:Spring Web MVC入门;理解DispatcherServlet;注解式控制器开发详解;数据类型转换;数据格式化;数据验证; 拦截器;对Ajax的支持;文件上传下载;表单标签等内容;最后以一个综合的CRUD带翻页的应用示例来综合所学的知识

DWR开发初步视频教程
全面、系统的掌握DWR的核心开发知识,达到能使用DWR框架进行开发的水平 包括:DWR基本运行流程、DWR的体系结构、DWR的基本配置、构建器、转换器、DWR处理集合类型的数据、DWR结合Servlet,Struts2结合DWR

浏览(8349)|评论(2)   交流分类:Java|笔记分类: 研磨struts2

评论(2)
2楼 平常心  2012-07-30 引用
还有,<constant name="struts.convention.action.suffix" value="Controller"/>这个有什么作用?
1楼 平常心  2012-07-30 引用
为什么我用了它之后@Action(value="")注解就用不了了,是需要进行什么配置么 ?
请登录后评论 登录

关于我们 | 联系我们 | 用户协议 | 私塾在线服务协议 | 版权声明 | 隐私保护

版权所有 Copyright(C)2009-2012 私塾在线学习网