一、配置web.xml
<filter>
<filter-name>struts2</filter-name>
<filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</filter-class>
<init-param>
<param-name>actionPackages</param-name>
<param-value>com.test.action</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>struts2</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
二、加入注解
@Namespace(value="/test")
@Action(value = "file-manager",
interceptorRefs = {
@InterceptorRef(value = "fileUpload",params={"maximumSize","1024000","allowedTypes","image/pjpeg"}),
@InterceptorRef(value = "basicStack")},
results = {@Result(name = ActionSupport.SUCCESS, location = "/view/file-manager-sucess.jsp"),
@Result(name = ActionSupport.ERROR, location = "/view/file-manager-error.jsp") },
exceptionMappings = {@ExceptionMapping(exception = "java.lang.Exception", result = ActionSupport.ERROR)}
)
驗證注解：
@Validations(
requiredStrings={
@RequiredStringValidator(fieldName="username",message="用戶名不能為空!"),
@RequiredStringValidator(fieldName="telNum",message="電話號碼不能為空!")
},
regexFields={@RegexFieldValidator(fieldName="telNum",expression="^(//+86|0|1)//d{10,11}$",
message="電話號碼格式不正確！")}
)
跳過驗證注解：
@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插件的首頁。
struts2注解實例:
使用注解完成一個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
如下用戶登錄的Action通過注解的方式驗證通過:
- package com.huawei.action;
- import org.apache.struts2.convention.annotation.Action;
- import org.apache.struts2.convention.annotation.ExceptionMapping;
- import org.apache.struts2.convention.annotation.ExceptionMappings;
- import org.apache.struts2.convention.annotation.Namespace;
- import org.apache.struts2.convention.annotation.ParentPackage;
- import org.apache.struts2.convention.annotation.Result;
- import org.apache.struts2.convention.annotation.Results;
- import com.opensymphony.xwork2.ActionSupport;
- /**
- * @name
- * @date 2011-3-24
- * @action LoginAction.java
- * @time 下午11:23:58
- * @package_name com.huaweiaction
- * @project_name steutsAction
- */
- /*
- * 這個小Demo的主要作用就是溫故一下Struts2 Action的注解
- * 一般在一個項目實施開發中是不會配置struts.xml進行Action的轉發或重定向的,其都是通過注解的方式來配置Action的
- */
- ///////////使用注解來配置Action///////////////////////////
- @ParentPackage("struts-default")
- // 父包
- @Namespace("")
- @Results( {
- @Result(name = com.opensymphony.xwork2.Action.SUCCESS, location = "/msg.jsp"),
- @Result(name = com.opensymphony.xwork2.Action.ERROR, location = "/erlogin.jsp") })
- // @ExceptionMappings 一級聲明異常的數組
- // @ExceptionMapping 映射一個聲明異常
- @ExceptionMappings( {
- @ExceptionMapping(exception = "java.lange.RuntimeException", result = "error") })
- public class LoginAction extends ActionSupport {
- private static final long serialVersionUID = -2554018432709689579L;
- private String loginname;
- private String pwd;
- // @Action(value="login") 指定某個請求處理方法的請求URL。注意，它不能添加在Action類上，要添加到方法上。
- @Action(value = "loginName")
- public String login() throws Exception {
- if ("HEFE".equalsIgnoreCase(loginname.trim())&&"123".equalsIgnoreCase(pwd.trim())) {
- return SUCCESS;
- }
- else {
- System.out.println("===========");
- return ERROR;
- }
- }
- @Action(value = "add", results = { @Result(name = "success", location = "/index.jsp") })
- public String add() throws Exception {
- return SUCCESS;
- }
- public String getLoginname() {
- return loginname;
- }
- public void setLoginname(String loginname) {
- this.loginname = loginname;
- }
- public String getPwd() {
- return pwd;
- }
- public void setPwd(String pwd) {
- this.pwd = pwd;
- }
- }