有Struts 1.x經驗的朋友都知道Action是Struts的核心內容,當然Struts 2.0也不例外。不過,Struts 1.x與Struts 2.0的Action模型很大的區別。
Struts 1.x Stuts 2.0 接口 必須繼承org.apache.struts.action.Action或者其子類 無須繼承任何類型或實現任何接口 表單數據 表單數據封裝在FormBean中 表單數據包含在Action中,通過Getter和Setter獲取
雖然,理論上Struts 2.0的Action無須實現任何接口或繼承任何類型,但是,我們為了方便實現Action,大多數情況下都會繼承com.opensymphony.xwork2.ActionSupport類,並重載(Override)此類裡的String execute()方法。具體的實現,如例1所示:
<% @ page contentType = " text/html; charset=UTF-8 " %>
<% @ taglib prefix = " s " uri = " /struts-tags " %>
< html >
< head >
< title > Hello World! </ title >
</ head >
< body >
< h2 >< s:property value ="message" /></ h2 >
</ body >
</ html >
例1 HelloWorld.jsp
package tutorial;
import java.text.DateFormat;
import java.util.Date;
import com.opensymphony.xwork2.ActionSupport;
public class HelloWorld extends ActionSupport {
private String message;
public String getMessage() {
return message;
}
@Override
public String execute() {
message = " Hello World, Now is " + DateFormat.getInstance().format( new Date());
return SUCCESS;
}
}
例1 classes/tutorial/HelloWorld.java
< package name ="ActionDemo" extends ="struts-default" >
< action name ="HelloWorld" class ="tutorial.HelloWorld" >
< result > /HelloWorld.jsp </ result >
</ action >
</ package >
例1 classes/struts.xml中HelloWorld Action的配置
在浏覽器地址欄中鍵入http://localhost:8080/Struts2_Action/HelloWorld.action,可以看到如圖1所示頁面。
圖1 HelloWorld輸出頁面
參考JavaDoc,可知ActionSupport類實現了接口:
com.opensymphony.xwork2.Action
com.opensymphony.xwork2.LoaleProvider
com.opensymphony.xwork2.TextProvider
com.opensymphony.xwork2.Validateable
com.opensymphony.xwork2.ValidationAware
com.uwyn.rife.continuations.ContinuableObject
java.io.Searializable
java.lang.Cloneable
默認情況下,當請求HelloWorld.action發生時,Struts運行時(Runtime)根據struts.xml裡的Action映射集(Mapping),實例化tutoiral.HelloWorld類,並調用其execute方法。當然,我們可以通過以下兩種方法改變這種默認調用。這個功能(Feature)有點類似Struts 1.x中的LookupDispathAction。
在classes/sturts.xml中新建Action,並指明其調用的方法;
訪問Action時,在Action名後加上“!xxx”(xxx為方法名)。
實現方法請參考例2:
在classes/tutorial/HelloWorld.java中加入以下方法:
public String aliasAction() {
message ="自定義Action調用方法";
return SUCCESS;
}
例2 classes/tutorial/HelloWorld.java代碼片段
實現方法一,在classes/sturts.xml中加入下面代碼:
<action name="AliasHelloWorld" class="tutorial.HelloWorld" method="aliasAction">
<result>/HelloWorld.jsp</result>
</action>
例2 classes/struts.xml中AlaisHelloWorld Action的配置
實現方法二,使用http://localhost:8080/Struts2_Action/HelloWorld!aliasAction.action地址來訪問HelloWorld Action。
在浏覽器地址欄中鍵入http://localhost:8080/Struts2_Action/AliasHelloWorld.action或 http://localhost:8080/Struts2_Action/HelloWorld!aliasAction.action,可以看到如圖2所示頁面。
圖2 自定義Action調用方法頁面
通過上面的兩個例子,細心的朋友應該可能會發現classes/tutorial/HelloWorld.java中Action方法(execute和aliasAction)返回都是SUCCESS。這個屬性變量我並沒有定義,所以大家應該會猜到它在ActionSupport或其父類中定義。沒錯,SUCCESS在接口com.opensymphony.xwork2.Action中定義,另外同時定義的還有ERROR, INPUT, LOGIN, NONE。
此外,我在配置Action時都沒有為result定義名字(name),所以它們默認都為success。值得一提的是Struts 2.0中的result不僅僅是Struts 1.x中forward的別名,它可以實現除forward外的很激動人心的功能,如將Action輸出到FreeMaker模板、Velocity模板、JasperReports和使用XSL轉換等。這些都過result裡的type(類型)屬性(Attribute)定義的。另外,您還可以自定義result類型。
下面讓我們來做一個Velocity模板輸出的例子,首先在classes/struts.xml中新建一個Action映射(Mapping),將其result類型設為velocity,如以下代碼所示:
<action name="VMHelloWorld" class="tutorial.HelloWorld">
<result type="velocity">/HelloWorld.vm</result>
</action>
例3 classes/struts.xml中VMHelloWorld Action的配置
新建HelloWorld.vm,內容如下所示:
<html>
<head>
<title>Velocity</title>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
</head>
<body>
<h2>Message rendered in Velocity: $message</h2>
</body>
</html>
例3 HelloWorld.vm
在浏覽器地址欄中鍵入http://localhost:8080/Struts2_Action/VMHelloWorld.action,頁面輸出如下圖3所示。
圖3 HelloWorld.vm的輸出頁面
要運行例3需要在WEB-INF/lib中添加以下幾個包:
commons-collections-3.2.jar
velocity-1.4.jar
velocity-tools-view-1.2.jar
avalon-logkit-2.1.jar
前面,我花了不少的時間討論Action的輸出。我老板有句名言——程序無非就是輸入、操作和輸出。因此,現在我們要討論一下輸入——表單輸入。
使用Struts 2.0,表單數據的輸入將變得非常方便,和普通的POJO一樣在Action編寫Getter和Setter,然後在JSP的UI標志的name與其對應,在提交表單到Action時,我們就可以取得其值。
讓我們看一個例子,新建Login Action,它通過Login.jsp的表單獲得用戶名和密碼,驗查用戶名是否為“max”,密碼是否則為“secret”。如果,兩者都符合,就在HelloWorld中顯示“Welcome, max”,否則顯示“Invalid user or Password”。
package tutorial;
import com.opensymphony.xwork2.ActionSupport;
publicclass Login extends ActionSupport {
private String name;
private String password;
private String message;
public String getName() {
return name;
}
publicvoid setName(String name) {
this.name = name;
}
public String getPassword() {
return password;
}
publicvoid setPassword(String password) {
this.password = password;
}
public String getMessage() {
return message;
}
@Override
public String execute() {
if("max".equals(name) &&"Secret".equals(password)) {
message ="Welcome, "+ name;
}else{
message ="Invalid user or password";
}
return SUCCESS;
}
}
例4 classes/tutorial/Login.java
<%@ page contentType="text/html; charset=UTF-8" %>
<%@ taglib prefix="s" uri="/struts-tags"%>
<html>
<head>
<title>Login</title>
</head>
<body>
<s:form action="Login" method="POST">
<s:textfield name="name" label="User name"/>
<s:password name="password" label="Password"/>
<s:submit value="Submit"/>
</s:form>
</body>
</html>
例4 Login.jsp
<action name="Login" class="tutorial.Login">
<result>/HelloWorld.jsp</result>
</action>
例4 classes/struts.xml中Login Action的配置
運行Tomcat,在浏覽器地址欄中鍵入http://localhost:8080/Struts2_Action/Login.jsp,出現如圖4所示頁面。
圖4 Login.jsp輸出頁面
分別在User name中輸入“max”和“secret”,點擊“Submit”按鈕,出現如圖5所示頁面。
圖5 Login成功頁面
在浏覽器地址欄中鍵入http://localhost:8080/Struts2_Action/Login.jsp,分別在User name中輸入“Scott”和“password”,點擊“Submit”按鈕,出現如圖6所示頁面。
圖6 Login失敗頁面
Struts 2.0更厲害的是支持更高級的POJO訪問,如user.getPassword()。我們可以用另一寫法實現例4。首先,將name和password從Login類中分離出來,到新建類User中。這樣對我們開發多層系統尤其有用。它可以使系統結構更清晰。
package tutorial;
import com.opensymphony.xwork2.ActionSupport;
publicclass LoginX extends ActionSupport {
private User user;
private String message;
publicvoid setUser(User user) {
this.user = user;
}
public User getUser() {
return user;
}
public String getMessage() {
return message;
}
@Override
public String execute() {
if("max".equals(user.getName()) &&"secret".equals(user.getPassword())) {
message ="Welcome, "+ user.getName();
}else{
message ="Invalid user or password";
}
return SUCCESS;
}
}
例5 classes/tutorial/LoginX.java
<%@ page contentType="text/html; charset=UTF-8" %>
<%@ taglib prefix="s" uri="/struts-tags"%>
<html>
<head>
<title>Login</title>
</head>
<body>
<s:form action="LoginX" method="POST">
<s:textfield name="user.name" label="User name"/>
<s:password name="user.password" label="Password"/>
<s:submit value="Submit"/>
</s:form>
</body>
</html>
例5 LoginX.jsp
<action name="LoginX" class="tutorial.LoginX">
<result>/HelloWorld.jsp</result>
</action>
例5 classes/struts.xml中的LoginX Action配置
很多時候我的同事會問我:“如果我要取得Servlet API中的一些對象,如request、response或session等,應該怎麼做?這裡的execute不像Struts 1.x的那樣在參數中引入。”開發Web應用程序當然免不了跟這些對象打交道。在Strutx 2.0你可以有兩種方式獲得這些對象:非IoC(控制反轉Inversion of Control)方式和IoC方式。
非IoC方式
要獲得上述對象,關鍵Struts 2.0中com.opensymphony.xwork2.ActionContext類。我們可以通過它的靜態方法getContext()獲取當前Action的上下文對象。 另外,org.apache.struts2.ServletActionContext作為輔助類(Helper Class),可以幫助您快捷地獲得這幾個對象。
HttpServletRequest request = ServletActionContext.getRequest();
HttpServletResponse response = ServletActionContext.getResponse();
HttpSession session = request.getSession();
如果你只是想訪問session的屬性(Attribute),你也可以通過ActionContext.getContext().getSession()獲取或添加session范圍(Scoped)的對象。
IoC方式
要使用IoC方式,我們首先要告訴IoC容器(Container)想取得某個對象的意願,通過實現相應的接口做到這點。具體實現,請參考例6 IocServlet.java。
package tutorial;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import javax.servlet.http.HttpSession;
import org.apache.struts2.ServletActionContext;
import com.opensymphony.xwork2.ActionContext;
import com.opensymphony.xwork2.ActionSupport;
publicclass NonIoCServlet extends ActionSupport {
private String message;
public String getMessage() {
return message;
}
@Override
public String execute() {
ActionContext.getContext().getSession().put("msg", "Hello World from Session!");
HttpServletRequest request = ServletActionContext.getRequest();
HttpServletResponse response = ServletActionContext.getResponse();
HttpSession session = request.getSession();
StringBuffer sb =new StringBuffer("Message from request: ");
sb.append(request.getParameter("msg"));
sb.append("<br>Response Buffer Size: ");
sb.append(response.getBufferSize());
sb.append("<br>Session ID: ");
sb.append(session.getId());
message = sb.toString();
return SUCCESS;
}
}
例6 classes/tutorial/NonIoCServlet.java
package tutorial;
import java.util.Map;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import javax.servlet.http.HttpSession;
import org.apache.struts2.interceptor.ServletRequestAware;
import org.apache.struts2.interceptor.ServletResponseAware;
import org.apache.struts2.interceptor.SessionAware;
import com.opensymphony.xwork2.ActionContext;
import com.opensymphony.xwork2.ActionSupport;
publicclass IoCServlet extends ActionSupport implements SessionAware, ServletRequestAware, ServletResponseAware {
private String message;
private Map att;
private HttpServletRequest request;
private HttpServletResponse response;
public String getMessage() {
return message;
}
publicvoid setSession(Map att) {
this.att = att;
}
publicvoid setServletRequest(HttpServletRequest request) {
this.request = request;
}
publicvoid setServletResponse(HttpServletResponse response) {
this.response = response;
}
@Override
public String execute() {
att.put("msg", "Hello World from Session!");
HttpSession session = request.getSession();
StringBuffer sb =new StringBuffer("Message from request: ");
sb.append(request.getParameter("msg"));
sb.append("<br>Response Buffer Size: ");
sb.append(response.getBufferSize());
sb.append("<br>Session ID: ");
sb.append(session.getId());
message = sb.toString();
return SUCCESS;
}
}
例6 classes/tutorial/IoCServlet.java
<%@ page contentType="text/html; charset=UTF-8" %>
<%@ taglib prefix="s" uri="/struts-tags"%>
<html>
<head>
<title>Hello World!</title>
</head>
<body>
<h2>
<s:property value="message" escape="false"/>
<br>Message from session: <s:property value="#session.msg"/>
</h2>
</body>
</html>
例6 Servlet.jsp
<action name="NonIoCServlet" class="tutorial.NonIoCServlet">
<result>/Servlet.jsp</result>
</action>
<action name="IoCServlet" class="tutorial.IoCServlet">
<result>/Servlet.jsp</result>
</action>
例6 classes/struts.xml中NonIocServlet和IoCServlet Action的配置
運行Tomcat,在浏覽器地址欄中鍵入http://localhost:8080/Struts2_Action/NonIoCServlet.action?msg=Hello%20World! 或http://localhost:8080/Struts2_Action/IoCServlet.action?msg=Hello%20World!,出現如圖7所示頁面。
圖7 Servlet.jsp的輸出頁面