1. 程式人生 > >Struts2 XML配置詳解

Struts2 XML配置詳解

1.深入Struts2的配置檔案 本部分主要介紹struts.xml的常用配置。 1.1.包配置: Struts2框架中核心元件就是Action、攔截器等,Struts2框架使用包來管理Action和攔截器等。每個包就是多個Action、多個攔截器、多個攔截器引用的集合。 在struts.xml檔案中package元素用於定義包配置,每個package元素定義了一個包配置。它的常用屬性有: name:必填屬性,用來指定包的名字。 extends:可選屬性,用來指定該包繼承其他包。繼承其它包,可以繼承其它包中的Action定義、攔截器定義等。 namespace:可選屬性,用來指定該包的名稱空間。
<!
DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" "http://struts.apache.org/dtds/struts-2.0.dtd"> <struts> <!-- struts2action必須放在一個指定的包空間下定義 --> <package name="default" extends="struts-default"> <!-- 定義處理請求URLlogin.actionAction --> <action
name="login" class="org.qiujy.web.struts.action.LoginAction"> <!-- 定義處理結果字串和資源之間的對映關係 --> <result name="success">/success.jsp</result> <result name="error">/error.jsp</result> </action> </package> </struts>

如上示例的配置,配置了一個名為default的包,該包下定義了一個Action。 1.2.
名稱空間配置:
考慮到同一個Web應用中需要同名的Action,Struts2以名稱空間的方式來管理Action,同一個名稱空間不能有同名的Action。 Struts2通過為包指定namespace屬性來為包下面的所有Action指定共同的名稱空間。 把上示例的配置改為如下形式:
<!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" "http://struts.apache.org/dtds/struts-2.0.dtd"> <struts> <!-- struts2action必須放在一個指定的包空間下定義 --> <package name="qiujy" extends="struts-default"> <!-- 定義處理請求URLlogin.actionAction --> <action name="login" class="org.qiujy.web.struts2.action.LoginAction"> <!-- 定義處理結果字串和資源之間的對映關係 --> <result name="success">/success.jsp</result> <result name="error">/error.jsp</result> </action> </package> <package name="my" extends="struts-default" namespace="/manage"> <!-- 定義處理請求URLlogin.actionAction --> <action name="backLogin" class="org.qiujy.web.struts2.action.LoginAction"> <!-- 定義處理結果字串和資源之間的對映關係 --> <result name="success">/success.jsp</result> <result name="error">/error.jsp</result> </action> </package></struts>
如上配置了兩個包:default和my,配置my包時指定了該包的名稱空間為/manage。 對於包default:沒有指定namespace屬性。如果某個包沒有指定namespace屬性,即該包使用預設的名稱空間,預設的名稱空間總是""。 對於包my:指定了名稱空間/manage,則該包下所有的Action處理的URL應該是“名稱空間/Action名”。如上名為backLogin的Action,它處理的URL為: http://localhost:8080/userlogin_struts2/manage/backLogin.action Struts2的名稱空間的作用等同於struts1裡模組的作用。 1.3.包含配置: 在Struts2中可以將一個配置檔案分解成多個配置檔案,那麼我們必須在struts.xml中包含其他配置檔案。
<struts> <include file="struts-default.xml"/> <include file="struts-user.xml"/> <include file="struts-book.xml"/> <include file="struts-shoppingCart.xml"/>     ...... </struts>
1.4.攔截器配置: 見後面章節介紹。 1.5.常量配置: Struts2框架有兩個核心配置檔案,其中struts.xml檔案主要負責管理應用中的Action對映, 及Action處理結果和物理資源之間的對映關係。除此之外,Struts2框架還包含了一個struts.properties檔案,該檔案主義了Struts2框架的大量常量屬性。但通常推薦也是在struts.xml檔案中來配置這些常量屬性。 如:後面會講到Struts2的國際化,它的資原始檔位置就用常量屬性來指定:
<struts>     ...... <constant name="struts.custom.i18n.resources" value="messages"/> </struts>
表示指定了資原始檔的放置在classes目錄下,基本名是messages,則在classes目錄下您就應該放置類似messages_zh_CN.properties,message_en.properties名的檔案。 2.Struts2的Action 2.1.實現Action類: Struts2中Action是核心內容,它包含了對使用者請求的處理邏輯,我們也稱Action為業務控制器。 Struts2中的Action採用了低侵入式的設計,Struts2不要求Action類繼承任何的Struts2的基類或實現Struts2介面。(但是,我們為了方便實現Action,大多數情況下都會繼承com.opensymphony.xwork2.ActionSupport類,並重寫此類裡的public String execute() throws Exception方法。因為此類中實現了很多的實用介面,提供了很多預設方法,這些預設方法包括獲取國際化資訊的方法、資料校驗的方法、預設的處理使用者請求的方法等,這樣可以大大的簡化Action的開發。) Struts2中通常直接使用Action來封裝HTTP請求引數,因此,Action類裡還應該包含與請求引數對應的屬性,並且為屬性提供對應的getter和setter方法。(當然,Action類中還可以封裝處理結果,把處理結果資訊當作一屬性,提供對應的getter和setter方法) 修改第一部分的使用者登入示例:把Action改成如下:
package org.qiujy.web.struts2.action; import com.opensymphony.xwork2.ActionSupport; /** *@authorqiujy *@version1.0 */ publicclass LoginAction extends ActionSupport{ private String userName; private String password; private String msg; //結果資訊屬性 /** *@returnthemsg */ public String getMsg() { returnmsg;     } /** *@parammsgthemsgtoset */ publicvoid setMsg(String msg) { this.msg = msg;     } /** *@returntheuserName */ public String getUserName() { returnuserName;     } /** *@paramuserNametheuserNametoset */ publicvoid setUserName(String userName) { this.userName = userName;     } /** *@returnthepassword */ public String getPassword() { returnpassword;     } /** *@parampasswordthepasswordtoset */ publicvoid setPassword(String password) { this.password = password;     } /** *處理使用者請求的excute()方法 *@return結果導航字串 *@throwsException */ public String execute() throws Exception{ if("test".equals(this.userName) && "test".equals(this.password)){ msg = "登入成功,歡迎" + this.userName; returnthis.SUCCESS;        }else{ msg = "登入失敗,使用者名稱或密碼錯"; returnthis.ERROR;        }     } }
往success.jsp和error.jsp頁面中新增 ${msg} EL表示式來顯示結果資訊。則最終效果跟以前一樣。 2.2.Action訪問Servlet API Struts2中的Action並沒有和任何Servlet API耦合,這樣框架更具靈活性,更易測試。 但是,對於web應用的控制器而言,不訪問Servlet API幾乎是不可能的,例如跟蹤HTTP Session狀態等。Struts2框架提供了一種更輕鬆的方式來訪問Servlet API。Struts2中提供了一個ActionContext類(當前Action的上下文物件),通過這個類可以訪問Servlet API。下面是該類中提供的幾個常用方法: public static ActionContext getContext() :獲得當前Action的ActionContext例項。 public Object get(Object key) :此方法類似於呼叫HttpServletRequest的getAttribute(String name)方法。 public void put(Object key, Object value) :此方法類似於呼叫HttpServletRequest 的setAttribute(String name, Object o)。 public Map getParameters() :獲取所有的請求引數。類似於呼叫HttpServletRequest物件的getParameterMap() 方法。 public Map getSession() :返回一個Map物件,該Map物件模擬了HttpSession例項。 public void setSession(Map session) : 直接傳入一個Map例項,將該Map例項裡的key-value對轉換成session的屬性名-屬性值對。 public Map getApplication() :返回一個Map物件,該物件模擬了該應用的ServletContext例項。 public void setApplication(Map application) :直接傳入一個Map例項,將該Map例項裡的key-value對轉換成application的屬性名-屬性值對。 修改以上使用者登入驗證示例的Action類中的execute方法:
public String execute() throws Exception{ if("test".equals(this.userName) && "test".equals(this.password)){ msg = "登入成功,歡迎" + this.userName; //獲取ActionContext例項,通過它來訪問Servlet API             ActionContext context = ActionContext.getContext(); //session中是否已經存放了使用者名稱,如果存放了:說明已經登入了; //否則說明是第一次登入成功 if(null != context.getSession().get("uName")){ msg = this.userName + ":你已經登入過了!!!";             }else{                 context.getSession().put("uName", this.userName);             } returnthis.SUCCESS;         }else{ msg = "登入失敗,使用者名稱或密碼錯"; returnthis.ERROR;         }     }
       Struts2中通過ActionContext來訪問Servlet API,讓Action徹底從Servlet API 中分離出來,最大的好處就是可以脫離Web容器測試Action。 另外,Struts2中還提供了一個ServletActionContext類,Action只要繼承自該類,就可以直接訪問Servlet API。具體方法參看struts2的API文件。 3.一個Action內包含多個請求處理方法的處理 Struts1提供了DispatchAction,從而允許一個Action內包含多個請求處理方法。Struts2也提供了類似的功能。處理方式主要有以下三種方式: 3.1.動態方法呼叫: DMI:Dynamic Method Invocation 動態方法呼叫。 動態方法呼叫是指:表單元素的action不直接等於某個Action的名字,而是以如下形式來指定對應的動作名:
<form method="post" action="userOpt!login.action">
則使用者的請求將提交到名為”userOpt”的Action例項,Action例項將呼叫名為”login”方法來處理請求。同時login方法的簽名也是跟execute()一樣,即為public String login() throws Exception。 注意:要使用動態方法呼叫,必須設定Struts2允許動態方法呼叫,通過設定struts.enable.DynamicMethodInvocation常量來完成,該常量屬性的預設值是true。 3.1.1.示例: 修改使用者登入驗證示例,多增加一個註冊使用者功能。 1.修改Action類:
package org.qiujy.web.struts2.action; import com.opensymphony.xwork2.ActionContext; import com.opensymphony.xwork2.ActionSupport; /** *@authorqiujy *@version1.0 */ publicclass LoginAction extends ActionSupport{ private String userName; private String password; private String msg; //結果資訊屬性 /** *@returnthemsg */ public String getMsg() { returnmsg;     } /** *@parammsgthemsgtoset */ publicvoid setMsg(String msg) { this.msg = msg;     } /** *@returntheuserName */ public String getUserName() { returnuserName;     } /** *@paramuserNametheuserNametoset */ publicvoid setUserName(String userName) { this.userName = userName;     } /** *@returnthepassword */ public String getPassword() { returnpassword;     } /** *@parampasswordthepasswordtoset */ publicvoid setPassword(String password) { this.password = password;     } /** *處理使用者請求的login()方法 *@return結果導航字串 *@throwsException */ public String login() throws Exception{ if("test".equals(this.userName) && "test".equals(this.password)){ msg = "登入成功,歡迎" + this.userName; //獲取ActionContext例項,通過它來訪問Servlet API             ActionContext context = ActionContext.getContext(); //session中是否已經存放了使用者名稱,如果存放了:說明已經登入了; //否則說明是第一次登入成功 if(null != context.getSession().get("uName")){ msg = this.userName + ":你已經登入過了!!!";             }else{                 context.getSession().put("uName", this.userName);             } returnthis.SUCCESS;         }else{ msg = "登入失敗,使用者名稱或密碼錯"; returnthis.ERROR;         }     } public String regist() throws Exception{ //將使用者名稱,密碼新增到資料庫中 //... msg = "註冊成功。"; returnthis.SUCCESS;     } }
2.struts.xml檔案:沒有什麼變化,跟以前一樣配置
<!DOCTYPE struts PUBLIC "