文档章节

Struts2 零配置----详解

鱼北子
 鱼北子
发布于 2012/12/25 22:34
字数 2251
阅读 158
收藏 15
从struts2.1开始,struts2不再推荐使用Codebehind作为零配置插件,而是改为使用Convention插件来支持零配置,和Codebehind相比,Convention插件更彻底,该插件完全抛弃配置信息,不仅不需要是使用struts.xml文件进行配置,甚至不需要使用Annotation进行配置,而是由struts2根据约定自动配置。


如何使用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.       Convention插件还允许设置如下三个常量:


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两个常量的作用比较微妙,开发者在利用这两个常量时务必小心。


如:下面Action所在包被映射的命名空间如下:


com.fun.actions.LoginAction 映射到   /


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


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


4.       映射Action的name时,遵循如下两步规则:


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


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


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


5.       默认情况下。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


6.       为了看到struts2应用里的Action等各种资源的影射情况,struts2提供了Config Browser插件。使用方法,将struts2-config-browser-plugin-2.1.6.jar文件复制到struts2应用的WEB-INF\lib目录中。


打开首页地址:http://localhost:8080/应用名字/config-browser/actionNames.action这里可以看到Config Browser插件的首页。


注意:这里不管开发者是否使用struts.xml文件进行配置,一样可以看到struts的配置信息。


7.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”


注意:由于Convention插件根据Action和jsp页面来动态生成映射的,因此不管是Acion的改变,还是JSP页面的改变都需要Convention插件重新加载映射。那么只要我们为struts2应用配置如下两个常量就可以了。


<!--配置struts2应用于开发模式--!>


<constant name=”struts.devMode” value=”true”/>


<!—配置Convention插件自动重加载映射--!>


<constant name=”struts.convention.classes.reload” value=”true”/>


几个重要的常量


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


7.       Convention的Annotation


1)  与Action相关的两个Annotation是@Action 和@Actions


2)  @Action中可指定一个value属性。类似于指定<action name=””/>属性值


3)  @Action中还可以指定一个params属性,该属性是一个字符串数组,用于该Acion指定的参数名和参数值。params属性应遵守如下格式:{“name1”,”value1”,”name2”,”value2”}


4)  @Actions 也用于修饰Action类里的方法,用于将该方法映射到多个URL.@Actions用于组织多个@Action.因此它可将一个方法映射成多个逻辑Action。


如:


package com.fun.actions;








import org.apache.struts2.convention.annotation.Action;


import org.apache.struts2.convention.annotation.Actions;




import com.fun.service.LoginService;


import com.opensymphony.xwork2.ActionSupport;




public class LoginAction extends ActionSupport {


    private String str;


    @Actions({


       @Action(value="login1",params={"str","这是已经注入的了!"}),


       @Action(value="login2")




    })


    public String login(){


       return "str";


    }


    @Action(value="ggg")


    public String abc(){


       return "abc";


    }


    public String getStr() {


       return str;


    }


    public void setStr(String str) {


       this.str = str;


    }




}


我们可以通过/login1.action访问,而在访问时,str这个属性已经有值,为str=”这是已经注入的!” 返回的视图是login1-str.jsp


当我们用/login2.action访问时,str的值为null。返回的视图为 login2-str.jsp


而我们通过/ggg.action调用的是abc()方法,返回的视图为/ggg-abc.jsp


8.       与Result配置相关的Annotation


1)@ResultPath @Result 和Results


2)@Results用于组织多个@Result因此它只需指定一个value属性值,该value属性值为多个@Result


3)@Result相当于struts.xml文件中的<result/>元素的做哟欧诺个。使用@Result必须指定一个name属性,相当于<result name=””/>另外,它还有几个可选的属性。


     ☆ type 相当于<result type=””/>指定返回视图资源的类型


     ☆ location 相当于<result>…..</result>中间部分,用于指定实际视图位置


     ☆ params:该属性相当于<result/>元素里多个<param../>子元素的作用,用于为该Result指定参数值。该属性应满足{“name1”,”value1”,”name2”,”value2”}格式


4)@Result有以下两种用法


1 Action级的Result映射:以@Actions组合多个@Action后修饰的Action类。这种Result映射对该Action里的所有方法都有效。


2方法级Result映射:将多个@Result组成数组后作为@Action的results属性值。这种Result映射仅对被修饰的方法有效。


5)@ResultPath则用于修饰包和Action类,用于改变被修饰Action所对应的物理视图资源的根路径。举例说:默认情况下,Convention都会到WEB-INF/content路径下找物理视图资源,一旦我们使用@ResultPath(“/abc”)修饰该Action,系统将回到abc目录下寻找物理视图资源。举例:在默认情况下,Convention都会到WEB-INF/content路径下需找物理视图资源,一旦我们使用@ResultPath(“/abc”)修饰该Action,系统会到abc目录下寻找物理视图资源。




9 与包和命名空间相关的Annotation:


   @Namespace:修饰Action类或其所在的包。该Annotation中指定一个value属性值,用于指定被修饰的Action所在的命名空间


  @Namespaces:修饰Action类或其所在的包,用于组合多个@Namespace


  @ParentPackage: 用于指定被修饰的Action所在包的夫包。


10 异常处理相关的Annotation


  @ExceptionMappings 用于组织多个@ExceptionMapping,因此它只需指定一个value属性值,该value属性值为多个@ExceptionMapping。


 @ExceptionMapping 用于定义异常类和物理视图之间的对应关系,也相当于struts.xml文件里<exception-mapping../>元素的作用 使用时,必须注意以下两个属性:


  exception: 用于指定异常类


  result : 用于指定逻辑视图


@ExceptionMpping有如下两种用法


   Action级的异常定义:以@ExceptionMappings组合多个@ExceptionMapping后修饰的Action类。这种异常定义对Action中的所有方法有效


  方法级的异常定义: 将多个@ExceptionMapping组成数组后作为@Action的exceptionMappings属性值,这种异常定义仅对被修饰的方法有效。




11.拦截器配置相关的Annotation


 与拦截器配置的Annotation有@InterceptorRef、@InterceptorRefs和@DefaultInterceptorRef


@InterceptorRefs用于组织多个@InterceptorRef,因此它只需要指定一个value属性值,该value属性值为多个@InterceptorRef


@InterceptorRef用于为指定Action引用lanjieq或者是拦截器栈。也就相当于strut.xml中位于<action../>元素内部的<interceptor-ref../>子元素的作用。使用@InterceptorRefAnnotation时,必须制定一个value属性,用于指定所引用的拦截器或拦截器栈的名字。相当于<interceptor-ref../>子元素里name属性的作用。

本文转载自:http://bbs.csdn.net/topics/350194554

鱼北子

鱼北子

粉丝 23
博文 39
码字总数 7139
作品 0
昌平
技术主管
私信 提问
加载中

评论(1)

_凤求凰_
_凤求凰_
挺好。我们项目里就用的这个。。比之前写一大堆xml文件省事多了
Struts2返回JSON对象的方法总结

如果是作为客户端的HTTP+JSON接口工程,没有JSP等view视图的情况下,使用Jersery框架开发绝对是第一选择。而在基于Spring3 MVC的架构下,对HTTP+JSON的返回类型也有很好的支持。但是,在开发...

Zero__One
2013/01/16
7.2K
1
struts2零配置插件-convention-plugin

在工程搭建时候遇到了一个struts2配置的convention-plugin配置错误的问题;将参数“struts.convention.action.packages”配置错误的问题。排除错误同时,复习了一下这个插件的配置。 参考文档...

wayne很忙
2013/04/06
139
0
Java Web学习计划

--- 本月为入门阶段,从零开始,一步一步的做出一个实用的网站。 深入学习Java语言,初步掌握前端技术,使用JSP和MySQL完成一个简单的网站 第1周 Java高级编程学习目标:
1.深入了解JDK环境...

SVD
2016/12/01
167
0
Struts2学习(二):struts2配置详解!

Struts2框架按照以下搜索顺序加载Struts2常量: 1.struts-default.xml---该文件保存在struts2-core-2.x.x.jar文件中 2.struts-pluugin.xml---在struts2一些插件jar包里,比如struts2-xxx-plu...

这个人很懒-啥都没写
2013/07/19
3.9K
1
web项目脚手架--Rapid Framework

基于spring,struts(struts2),hibernate的web项目脚手架 一个类似 ruby on rails 的java web快速开发脚手架,本着不重复发明轮子的原则,框架只是将零散的struts(struts2)+spring+hibernate各个...

匿名
2009/04/28
22.7K
4

没有更多内容

加载失败,请刷新页面

加载更多

3_数组

3_数组

行者终成事
53分钟前
7
0
经典系统设计面试题解析:如何设计TinyURL(二)

原文链接:https://www.educative.io/courses/grokking-the-system-design-interview/m2ygV4E81AR 编者注:本文以一道经典的系统设计面试题:《如何设计TinyURL》的参考答案和解析为例,帮助...

APEMESH
今天
7
0
使用logstash同步MySQL数据到ES

概述   在生成业务常有将MySQL数据同步到ES的需求,如果需要很高的定制化,往往需要开发同步程序用于处理数据。但没有特殊业务需求,官方提供的logstash就很有优势了。   在使用logstas...

zxiaofan666
今天
10
0
X-MSG-IM-分布式信令跟踪能力

经过一周多的鏖战, X-MSG-IM的分布式信令跟踪能力已基本具备, 特点是: 实时. 只有要RX/TX就会实时产生信令跟踪事件, 先入kafka, 再入influxdb待查. 同时提供实时sub/pub接口. 完备. 可以完整...

dev5
今天
7
0
OpenJDK之CyclicBarrier

OpenJDK8,本人看的是openJDK。以前就看过,只是经常忘记,所以记录下 图1 CyclicBarrier是Doug Lea在JDK1.5中引入的,作用就不详细描述了,主要有如下俩个方法使用: await()方法,如果当前线...

克虏伯
今天
8
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部