一、配置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