Struts2【開發Action】
前言
前面Struts博文基本把Struts的配置資訊講解完了…..本博文主要講解Struts對資料的處理
Action開發的三種方式
在第一次我們寫開發步驟的時候,我們寫的Action是繼承著ActionSupport類的…為啥我們繼承了ActionSupport類呢?下面我就會講解到
繼承ActionSupport類
我們來看一下ActionSupport幹了什麼:
這裡寫圖片描述
也就是說,如果我們在Action類中需要用到Struts為我們提供的資料校驗等Struts已經幫我們實現的功能,我們就繼承著ActionSupport類..
實現Action介面
我們再來看看Action接口乾了什麼:
這裡寫圖片描述
當然啦,ActionSuppot也繼承著Action介面,所以ActionSuppot擁有Action介面的全部功能….因此,這種開發方式我們是比較少用的…
不繼承任何類、不實現任何介面
開發此類的Action,它是不繼承任何類、不實現任何介面的…也就是說,它就是一個普通的Java類….
- Action類
public class PrivilegeAction { public String login() { System.out.println("我是普通的javaAction,不繼承任何的類、不實現任何的介面"); return "success"; } }
- 在配置檔案中配置:
<struts>
<package name="privilige" extends="struts-default">
<action name="login" class="privilegeaction.PrivilegeAction" method="login">
<result name="success">/index.jsp</result>
</action>
</package>
</struts>
- 效果:
這裡寫圖片描述
小總結
- 如果我們使用到了Struts2一些特用的功能,我們就需要繼承ActionSupport
- 如果我們沒用到Struts2的特殊功能,只要平凡寫一個Java類行了。
- 大多情況下,我們還是會繼承ActionSupport的。
請求資料封裝
一般地,我們使用Servlet的時候都是分為幾個步驟的:
- 得到web層的資料、封裝資料
- 呼叫service層的邏輯業務程式碼
- 將資料儲存在域物件中,跳轉到對應的JSP頁面
現在問題來了,我們自己編寫的Action類是沒有request、response、Session、application之類的物件的….我們是怎麼得到web層的資料、再將資料存到域物件中的呢??
前面已經說過了,Struts預先幫我們完成了對資料封裝的功能,它是通過params攔截器來實現資料封裝的
<interceptor name="params" class="com.opensymphony.xwork2.interceptor.ParametersInterceptor"/>
register.jsp
首先,我們填寫表單頁面的資料,請求Action處理資料
<form action="${pageContext.request.contextPath}/date01" method="post">
使用者名稱:<input type="text" name="username"><br>
密碼:<input type="text" name="psd"><br>
年齡:<input type="text" name="age"><br>
生日:<input type="text" name="birthday"><br>
<input type="submit" value="註冊"><br>
</form>
Action封裝基本資訊
在Action設定與JSP頁面相同的屬性,併為它們編寫setter方法
private String username;
private String psd;
private int age;
private Date birthday;
public void setUsername(String username) {
this.username = username;
}
public void setPsd(String psd) {
this.psd = psd;
}
public void setAge(int age) {
this.age = age;
}
public void setBirthday(Date birthday) {
this.birthday = birthday;
}
我們直接在業務方法中訪問這些變數,看是否能得到表單的值。
這裡寫圖片描述
Action封裝物件
一般地,我們註冊的時候,都是在Servlet上把基本資訊封裝到物件上…那麼在Struts怎麼做呢?
- 建立一個User類,基本的資訊和JSP頁面是相同的。
package qwer;
import java.util.Date;
/**
* Created by ozc on 2017/4/27.
*/
public class User {
private String username;
private String psd;
private int age;
private Date birthday;
public String getUsername() {
return username;
}
public void setUsername(String username) {
this.username = username;
}
public String getPsd() {
return psd;
}
public void setPsd(String psd) {
this.psd = psd;
}
public int getAge() {
return age;
}
public void setAge(int age) {
this.age = age;
}
public Date getBirthday() {
return birthday;
}
public void setBirthday(Date birthday) {
this.birthday = birthday;
}
}
- 在Action中定義User物件出來,並給出setter和getter方法….值得注意的是:基本資訊只要setter就夠了,封裝到物件的話,需要setter和getter
public class ccAction extends ActionSupport {
private User user;
public User getUser() {
return user;
}
public void setUser(User user) {
this.user = user;
}
public String register() {
System.out.println(user.getUsername());
System.out.println(user.getPsd());
System.out.println(user.getAge());
System.out.println(user.getBirthday());
return "success";
}
}
- 在JSP頁面,提交的name要寫成
user.username
之類的
<form action="${pageContext.request.contextPath}/register" method="post">
使用者名稱:<input type="text" name="user.username"><br>
密碼:<input type="text" name="user.psd"><br>
年齡:<input type="text" name="user.age"><br>
生日:<input type="text" name="user.birthday"><br>
<input type="submit" value="註冊"><br>
</form>
這裡寫圖片描述
得到域物件
Struts怎麼把資料儲存在域物件中呢???Struts提供了三種方式
一、得到Servlet API
我們可以通過ServletActionContext得到Servlet API
由於每個使用者擁有一個Action物件,那麼底層為了維護使用者拿到的是當前執行緒的request等物件,使用ThreadLocal來維護當前執行緒下的request、response等物件…
//通過ServletActionContext得到Servlet API
javax.servlet.ServletContext context = ServletActionContext.getServletContext();
HttpServletRequest request = ServletActionContext.getRequest();
HttpSession session = request.getSession();
HttpServletResponse response = ServletActionContext.getResponse();
二、ActionContext類
我們還可以通過ActionContext類來得到request、response、session、application被Struts封裝的Map集合
//得到ActionContext 物件
ActionContext context = ActionContext.getContext();
Map<String, Object> session = context.getSession();
Map<String, Object> application = context.getApplication();
//這是request的Map
Map<String, Object> request = context.getContextMap();
三、實現介面
當web容器發現該Action實現了Aware介面,會把相對應的資源通過Aware介面注射進去,實際上就是一種IOC。
Aware實際就是一種攔截器,攔截程式碼在執行Action之前執行、將資源注射到Action中
實現SessionAware, RequestAware, ApplicationAware介面,它就要在程式中實現三個方法:
private Map<String, Object> request;
private Map<String, Object> session;
private Map<String, Object> application;
@Override
public void setApplication(Map<String, Object> map) {
this.application = map;
}
@Override
public void setRequest(Map<String, Object> map) {
this.request = map;
}
@Override
public void setSession(Map<String, Object> map) {
this.session = map;
}
通過這些方法,我們就可以得到對應的Map物件…..
小總結
那麼,我們有三種方法可以得到Servlet對應的物件,那麼該使用哪一種呢???
分析:
- 第一種方法:需要匯入Servlet的包,與Struts耦合了
- 第二種方法:只能在業務方法中使用ActionContext類得到對應的Map物件,如果有多個方法,那麼每個方法都需要寫類似的程式碼
- 第三種方法:可以在類上定義成員變數,以至於整個類都能使用。但是需要實現類、實現對應的方法
如果我們需要使用到物件的其他方法,類似getContextPath()之類的,那麼只能使用第一種
如果我們就按照平常的開發,我們就使用第二種【獲取簡單,沒有耦合】
至於第三種,當我們將來可能開發BaseAction的時候,就使用它!
日期轉換問題
前面博文已經講解了,Struts2為我們實現了資料自動封裝…由上篇的例子我們可以看出,表單提交過去的資料全都是String型別的,但是經過Struts自動封裝,就改成是JavaBean對應成員變數的型別了。
但是呢,日期型別只支援是yyyy-MM-dd這種格式的,因為我們在上個例子中直接使用的是Struts支援的格式,因此沒有報錯…本篇博文就是講解Struts如何對日期型別的格式更好地支援
當我們使用的是yyyyMMdd這種格式的時候,我們看看Struts的自動封裝能不能解析出相對應的日期
這裡寫圖片描述
直接丟擲了異常
這裡寫圖片描述
這裡寫圖片描述
分析
那麼,我們怎麼讓Struts能夠支援更多的日期格式呢??比如,我想Struts在自動封裝資料的時候支援yyyyMMdd,yyyy年MM月dd日這樣的日期格式…..
Struts提供了轉換器給我們使用,也就是,我們可以自定義轉換器,我們定義了什麼格式,Struts就可以根據對應的格式進行自動封裝…
當我們寫完自定義轉換器,是需要向Struts說明我們寫了,不然的話,Struts是不知道我們自定義了轉換器類的…
也就是說,我們要想實現型別轉換,需要兩步:
- 編寫自定義轉換器類
- 告訴Struts我們寫了轉換器類
自定義轉換器類
一般地,我們想要編寫自定義轉換器類,都是實現StrutsTypeConverter類的….
/**
* Created by ozc on 2017/5/1.
* 自定義異常轉換器類
*
* 我們要實現的就是:在Struts轉換的時候,
*
*/
public class MyConvter extends StrutsTypeConverter {
//需求,當Struts自動封裝資料時,也支援yyyyMMdd,yyyy年MM月dd日等格式的支援
SimpleDateFormat[] format = {new SimpleDateFormat("yyyy-MM-dd"), new SimpleDateFormat("yyyyMMdd"), new SimpleDateFormat("yyyy年MM月dd日")};
/**
* 把String轉換為指定的型別 【String To Date】
*
*
* @param map
* 當前上下文環境
* @param strings
* jsp表單提交的字串的值
* @param aClass
* 要轉換為的目標型別
*/
@Override
public Object convertFromString(Map map, String[] strings, Class aClass) {
//判斷是否有值
if (strings == null) {
return null;
}
//判斷是否是日期型別的
if (Date.class != aClass) {
return null;
}
//遍歷迴圈
for (SimpleDateFormat dateFormat : format) {
try {
//解析傳遞進來的第一個就行啦
dateFormat.parse(strings[0]);
} catch (ParseException e) {
//如果格式不對,那麼就跳出當前的迴圈
continue;
}
}
return null;
}
@Override
public String convertToString(Map map, Object o) {
return null;
}
}
告訴Struts,我寫了轉換器類
告訴Struts我寫了一個轉換器類,也分兩種方式
- 定義了局部轉換器類,就當前包下的Action類有效
- 定義了全域性轉換器類,整個專案有效
全域性轉換器
步驟:
- 在src目錄下建立一個名為
xwork-conversion.properties
的檔案 - 配置檔案的內容:需要轉換的類型別=轉換器類的全名
java.util.Date=qwer.MyConvter
區域性轉換器類
步驟:
- 在當前的Action包下建立名為
Action名-conversion.properties
的檔案 - 檔案的內容為:需要轉換的欄位【如果是JavaBean裡的欄位,需要寫上JavaBean的】=轉換器類的全名
user.birthday=qwer.MyConvter
效果
這裡寫圖片描述
這裡寫圖片描述
錯誤提示頁面
當發生了日期轉換的異常時,Struts給出的頁面是這樣子的:
這裡寫圖片描述
這個我們稱之為input檢視,我們要做的就是給出使用者更友好的提示,於是在struts.xml檔案中配置:如果返回的是input檢視,那麼跳轉到我們相對應的頁面上
<result name="input">/error.jsp</result>
這裡寫圖片描述
檔案上傳和下載
在講解開山篇的時候就已經說了,Struts2框架封裝了檔案上傳的功能……..本博文主要講解怎麼使用Struts框架來完成檔案上傳和下載
回顧以前的檔案上傳
首先,我們先來回顧一下以前,我們在web中上傳檔案是怎麼做的….http://blog.csdn.net/hon_3y/article/details/66975268
可以使用FileUpload或者SmartUpload元件來完成檔案上傳的功能。但是呢,FileUpload元件使用起來是比較麻煩的…而SmartUPload解決中文的問題也非常麻煩
使用Struts進行檔案上傳
從要匯入的jar包我們就可以知道:Struts內部還是使用fileUpload上傳元件….但是它極大的簡化地我們的具體操作
那我們怎麼用它呢??看下面的圖
這裡寫圖片描述
- 在Action中使用在表單中定義的name,就可以獲取代表的上傳檔案的File物件
- 在Action中使用在表單中定義的name+FileName,就得到上傳檔案的名字
JSP頁面
在註冊頁面上擁有兩個上傳檔案控制元件
<form action="${pageContext.request.contextPath}/register" method="post" enctype="multipart/form-data">
<input type="file" name="photo"><br>
<input type="file" name="photo1"><br>
<input type="submit" value="註冊"><br>
</form>
Action
得到相對應的File物件、上傳檔名稱、上傳檔案的型別
package fileupload;
import java.io.File;
/**
* Created by ozc on 2017/5/2.
*/
public class FileUploadAction {
//上傳檔案對應的File物件
private File photo;
private File photo1;
//得到上傳檔案的名稱
private String photoFileName;
private String photo1FileName;
//得到上傳檔案的型別
private String photoContentType;
private String photo1ContentType;
//給出相對應的setter
public void setPhoto(File photo) {
this.photo = photo;
}
public void setPhoto1(File photo1) {
this.photo1 = photo1;
}
public void setPhotoFileName(String photoFileName) {
this.photoFileName = photoFileName;
}
public void setPhoto1FileName(String photo1FileName) {
this.photo1FileName = photo1FileName;
}
public void setPhotoContentType(String photoContentType) {
this.photoContentType = photoContentType;
}
public void setPhoto1ContentType(String photo1ContentType) {
this.photo1ContentType = photo1ContentType;
}
public String register() {
System.out.println(photo1FileName);
System.out.println(photoFileName);
return "success";
}
}
成功得到資料:
這裡寫圖片描述
這裡寫圖片描述
Action業務程式碼:
public String register() throws IOException {
//得到上傳的路徑
String path = ServletActionContext.getServletContext().getRealPath("upload");
System.out.println(path);
//建立檔案物件
File destFile = new File(path,photoFileName);
//呼叫工具類方法,將檔案拷貝過去
FileUtils.copyFile(photo, destFile);
return "success";
}
- 效果:
這裡寫圖片描述
檔案下載
我們以前是通過設定request訊息頭來實現檔案下載的…..那麼在Struts又如何實現檔案下載呢??
我們請求伺服器處理都是通過Action類來完成的,但是呢,Action類的業務方法都是返回字串。因此,Struts在<result>
節點中提供了型別為stream的type值。通過stream來配置相對應的資訊,從而實現下載!
列出所有可以下載的檔案
- Action類的業務方法
public class downLoadAction {
//列出所有可以下載的檔案
public String list() {
//得到upload資料夾
String path = ServletActionContext.getServletContext().getRealPath("/upload");
//建立file物件
File file = new File(path);
//列出檔案下所有的檔案
File[] files = file.listFiles();
//將這些檔案存到request域中
HttpServletRequest request = ServletActionContext.getRequest();
request.setAttribute("files", files);
return "list";
}
}
- Struts配置檔案
<action name="down_*" class="fileupload.downLoadAction" method="{1}">
<result name="{1}">/list.jsp</result>
<!-- <result name="{1}" type="stream">/index.jsp</result>-->
</action>
- JSP顯示頁面
<c:if test="${files==null}">
對不起,沒有下載的頁面
</c:if>
<c:if test="${files!=null}">
<table border="1px">
<tr>
<td>編號</td>
<td>檔名稱</td>
<td>操作</td>
</tr>
<c:forEach items="${files}" varStatus="file" var="fileName">
<tr>
<td>${file.count}</td>
<%--如果直接寫fileName,輸出的名字帶有路徑,使用EL方法庫來擷取--%>
<td>${fn:substringAfter(fileName, "upload\")}</td>
<td>
<%--使用url標籤來構建url,不然超連結帶有中文,會出現亂碼--%>
<c:url var="url" value="down_downLoad">
<c:param name="fileName">${fn:substringAfter(fileName, "upload\")}</c:param>
</c:url>
<a href="${url}">下載</a>
</td>
</tr>
</c:forEach>
</table>
</c:if>
- Action程式碼:
/**
* 訪問Action的業務方法僅僅返回的是字串。因此Struts在result節點提供了stream型別的type,
* 指定了stream就代表著我這是要下載的...
* <p>
* 既然要下載檔案,那麼肯定需要幾樣東西:
* 1、檔名
* 2、代表檔案的流
*/
public String downLoad() {
return "downLoad";
}
//得到要下載的檔名,Struts提供了自動封裝的功能
private String fileName;
//如果檔名是中文的,那麼需要手動轉換,因為超連結是get方法提交
public void setFileName(String fileName) throws UnsupportedEncodingException {
fileName = new String(fileName.getBytes("ISO8859-1"), "UTF-8");
this.fileName = fileName;
System.out.println(fileName);
}
//得到代表下載檔案流,該方法由Struts呼叫
public InputStream getAttrInputStream() {
return ServletActionContext.getServletContext().getResourceAsStream("/upload/" + fileName);
}
//下載時,顯示的名稱【如果是中文,可能會亂碼,因此要URLencode】---->在Struts.xml檔案中通過${}可獲取
public String getDownFileName() throws UnsupportedEncodingException {
fileName = URLEncoder.encode(fileName, "UTF-8");
return fileName;
}
- Struts.xml
<action name="down_*" class="fileupload.downLoadAction" method="{1}">
<result name="{1}">/list.jsp</result>
<result name="downLoad" type="stream">
<!--執行下載的型別,指定為所有的二進位制檔案-->
<param name="contentType">application/octet-stream</param>
<!-- 對應的是Action中屬性: 返回流的屬性【其實就是getAttrInputStream()】 -->
<param name="inputName">attrInputStream</param>
<!-- 下載頭,包括:瀏覽器顯示的檔名 --> <!--${}這裡不是EL表示式-->
<param name="contentDisposition">attachment;filename=${downFileName}</param>
<!-- 緩衝區大小設定 -->
<param name="bufferSize">1024</param>
</result>
</action>
模型驅動
什麼是模型驅動
在Struts2中模型驅動就是用來封裝資料的..完成資料的自動封裝.
為什麼要使用模型驅動?
我們之前就使用過Sturts2的資料自動封裝功能,是用params攔截器完成的…既然有了params攔截器,為啥還要模型驅動??
當我們使用params攔截器完成資料自動封裝的時候,如果要封裝的是JavaBean物件,那麼在web表單中就必須的name寫上javaBean.屬性名
….
這樣的話,web層和Action層就耦合了…因為在web層必須要知道封裝的JavaBean物件是什麼才能夠實現自動封裝!
而模型驅動就解決了這個問題!即時不知道Action層的JavaBean物件是什麼,也能夠完成資料自動封裝!
模型驅動的實現原理
實現模型驅動功能也是由攔截器完成的,我們來看看攔截器到底做了什麼吧….
<interceptor name="modelDriven" class="com.opensymphony.xwork2.interceptor.ModelDrivenInterceptor"/>
攔截方法的原始碼是這樣的:
public String intercept(ActionInvocation invocation) throws Exception {
//得到當前要執行的Action物件
Object action = invocation.getAction();
//判斷該Action物件是否實現了ModelDriven介面
if(action instanceof ModelDriven) {
ModelDriven modelDriven = (ModelDriven)action;
//獲取值棧物件
ValueStack stack = invocation.getStack();
//得到model的物件
Object model = modelDriven.getModel();
//把物件存到值棧物件中
if(model != null) {
stack.push(model);
}
if(this.refreshModelBeforeResult) {
invocation.addPreResultListener(new ModelDrivenInterceptor.RefreshModelBeforeResult(modelDriven, model));
}
}
return invocation.invoke();
}
把model物件放到值棧物件之後,**Parameters 攔截器將把表單欄位對映到 ValueStack 棧的棧頂物件的各個屬性中. **
也就是說,使用模型驅動是需要配合Params攔截器完成的!
使用資料模型驅動
實現ModelDriven介面
- 實現ModelDriven介面,重寫方法….實現介面時,要封裝的物件是什麼,形參型別就給什麼
public class UserAction extends ActionSupport implements ModelDriven<User> {
public String login() {
return SUCCESS;
}
@Override
public User getModel() {
return null;
}
}
物件例項化
public class UserAction extends ActionSupport implements ModelDriven<User> {
//這裡一定要例項化
User user = new User();
public User getUser() {
return user;
}
public void setUser(User user) {
this.user = user;
}
@Override
public User getModel() {
return user;
}
}
測試
JSP提交頁面,直接寫上JavaBean物件的屬性就行了..不需要寫上JavaBean物件的名稱!
<form action="${pageContext.request.contextPath}/user_execute">
<table border="1">
<tr>
<td>使用者名稱:<input type="text" name="username"></td>
</tr>
<tr>
<td> 密碼:<input type="password" name="password"></td>
</tr>
<tr>
<td>電話:<input type="text" name="cellphone"></td>
</tr>
<tr>
<td> 郵箱:<input type="text" name="email"></td>
</tr>
<tr>
<td><input type="submit" value="提交"></td>
</tr>
</table>
</form>
- 在Action業務方法中輸出User物件的資料
@Override
public String execute() throws Exception {
System.out.println(user);
return SUCCESS;
}
這裡寫圖片描述