一、配置web.xml
01 |
< filter > |
02 |
< filter-name >struts2</ filter-name > |
03 |
< filter-class >org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</ filter-class > |
04 |
< init-param > |
05 |
< param-name >actionPackages</ param-name > |
06 |
< param-value >com.test.action</ param-value > |
07 |
</ init-param > |
08 |
</ filter > |
09 |
10 |
< filter-mapping > |
11 |
< filter-name >struts2</ filter-name > |
12 |
< url-pattern >/*</ url-pattern > |
13 |
</ filter-mapping > |
二、加入注解
1 |
@Namespace (value= "/test" ) |
2 |
@Action (value
= "file-manager" , |
3 |
interceptorRefs
= { |
4 |
@InterceptorRef (value
= "fileUpload" ,params={ "maximumSize" , "1024000" , "allowedTypes" , "image/pjpeg" }), |
5 |
@InterceptorRef (value
= "basicStack" )}, |
6 |
results
= { @Result (name
= ActionSupport.SUCCESS, location = "/view/file-manager-sucess.jsp" ), |
7 |
@Result (name
= ActionSupport.ERROR, location = "/view/file-manager-error.jsp" )
}, |
8 |
exceptionMappings
= { @ExceptionMapping (exception
= "java.lang.Exception" ,
result = ActionSupport.ERROR)} |
9 |
) |
验证注解:
1 |
@Validations ( |
2 |
requiredStrings={ |
3 |
@RequiredStringValidator (fieldName= "username" ,message= "用户名不能为空!" ), |
4 |
@RequiredStringValidator (fieldName= "telNum" ,message= "电话号码不能为空!" ) |
5 |
}, |
6 |
regexFields={ @RegexFieldValidator (fieldName= "telNum" ,expression= "^(//+86|0|1)//d{10,11}$" , |
7 |
message= "电话号码格式不正确!" )} |
8 |
) |
跳过验证注解:
@SkipValidation
三、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。
四、与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("/view")修饰该Action,系统将回到view目录下寻找物理视图资源。
五、与包和命名空间相关的Annotation:
@Namespace:修饰Action类或其所在的包。该Annotation中指定一个value属性值,用于指定被修饰的Action所在的命名空间
@Namespaces:修饰Action类或其所在的包,用于组合多个@Namespace
@ParentPackage: 用于指定被修饰的Action所在包的父包。
六、与异常处理相关的Annotation
@ExceptionMappings 用于组织多个@ExceptionMapping,因此它只需指定一个value属性值,该value属性值为多个@ExceptionMapping。
@ExceptionMapping 用于定义异常类和物理视图之间的对应关系,也相当于struts.xml文件里<exception-mapping../>元素的作用 使用时,必须注意以下两个属性:
exception: 用于指定异常类
result:用于指定逻辑视图
@ExceptionMpping有如下两种用法
Action级的异常定义:以@ExceptionMappings组合多个@ExceptionMapping后修饰的Action类。这种异常定义对Action中的所有方法有效
方法级的异常定义:将多个@ExceptionMapping组成数组后作为@Action的exceptionMappings属性值,这种异常定义仅对被修饰的方法有效。
七、与拦截器配置相关的Annotation
与拦截器配置的Annotation有@InterceptorRef、@InterceptorRefs和@DefaultInterceptorRef
@InterceptorRefs用于组织多个@InterceptorRef,因此它只需要指定一个value属性值,该value属性值为多个@InterceptorRef
@InterceptorRef用于为指定Action引用lanjieq或者是拦截器栈。也就相当于strut.xml中位于<action../>元素内部的<interceptor-ref../>子元素的作用。使用@InterceptorRefAnnotation时,必须制定一个value属性,用于指定所引用的拦截器或拦截器栈的名字。相当于<interceptor-ref../>子元素里name属性的作用。
八、查看struts2配置
为了看到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插件的首页。
使用注解完成一个Action的流程必须要如下的7个jar包 :
1.commons-fileupload-1.2.1.jar
2.commons-io-1.3.2.jar
3.freemarker-2.3.15.jar
4.ognl-2.7.3.jar
5.struts2-convention-plugin-2.1.8.1.jar
6.struts2-core-2.1.8.1.jar
7.xwork-core-2.1.6.jar