摘要：
這是我翻譯的 Myeclipse 的一篇關(guān)于創(chuàng)建 Struts 應(yīng)用的文檔。粗略的翻譯，有些我翻譯不了或者認(rèn)為沒有必要的就刪去了。我的表達(dá)能力差，翻譯起來更差勁。讀文檔的時候，感覺很順利，很輕松，于是就想試著翻譯一下，可是一旦做起來，才發(fā)現(xiàn)很難。有些句子的意思很明白，可是一旦轉(zhuǎn)化成中文的時候，感覺就在嘴邊打轉(zhuǎn)，可是又吐不出來。真難受呀。好不容易湊成了一篇，也就貼出來了。讀著讀著發(fā)現(xiàn)自己都讀不下去了。呵呵，慢慢來，總會好的 正如我對自己的評說：一切正向著好的方向前進(jìn)，盡管很慢。
目錄：
1 序
2 介紹
3 必備
4 構(gòu)造一個新項(xiàng)目
5 開始一個 Struts 項(xiàng)目
? Struts 項(xiàng)目的組件
? 搭建應(yīng)用程序
6 運(yùn)行
7 總結(jié)
正文：
1. 序
此文檔適應(yīng) Sun JDK 1.4.2, Eclipse 3.0.1 and MyEclipse 3.8.2. 環(huán)境。所有的屏幕截圖都是基于 Eclipse, MyEclipse Enterprise Workbench, and Windows XP 的默認(rèn)用戶接口設(shè)置。如果你在使用這個文檔的過程中遇到困難，請看用戶反饋部分，以反饋給 MyEclipse documentation team 。
2. 說明
在這個用戶指南中我們將通過 MyEclipse Enterprise Workbench 來開發(fā)和測試一個簡單的 Struts 示例應(yīng)用。這并不需要我們具有 Struts 或者 MyEclipse 的預(yù)備知識。
3. 必備工具
JDK 1.4+ (Sun or IBM)
http://java.sun.com/j2se/downloads/index.html
Eclipse 3.0.x SDK
http://www.eclipse.org/downloads/index.php
MyEclipse 3.8.2
http://www.myeclipseide.com/ContentExpress-display-ceid-10.html
Tomcat 5.0.x ( 首選 5.0.28 P referred, 或其他 Servlet/EJB 容器 )
http://apache.xtelli.net/jakarta/tomcat-5/v5.0.28/bin/jakarta-tomcat-5.0.28.exe
4. 構(gòu)造一個新項(xiàng)目
為了有效的組織我們的開發(fā)，我們需要在添加了 Struts Capabilities 的 MyEclipse 中創(chuàng)建一個新的 Web Module Project 。 你可以創(chuàng)建一個 web project 通過菜單 File > New > Other > Project > J2EE > Web Project ，如下圖所示
圖 1--- 新建 Web Project 對話框
然后鍵入關(guān)于新項(xiàng)目的所有信息 ，如下圖：
圖 2 ---- 設(shè)置 Web Project
一旦創(chuàng)建了 Web Project ，我們需要為 MyEclipse 添加 Struts Capabilities 。這可以通過右擊 Package Explorer 視圖中 項(xiàng)目的名稱，并且依次選擇 MyEclipse > Add Struts Capabilities 做到。如下面圖示：
圖 3 ：在 Web Project 中 添加 Struts Capabilities
對這個應(yīng)用來說， Struts 對話框的默認(rèn)值已經(jīng)很適合了。但是，你可以改變 Base package for new classes 來適應(yīng)你的情況。如下圖 4 所示，我們只是簡單的保留這些默認(rèn)值。
圖 4---- 配置 Struts Capabilities
當(dāng)完成上面的步驟，項(xiàng)目的結(jié)構(gòu)會如下圖 5 所示
圖 5 ---- 配置后的項(xiàng)目結(jié)構(gòu)視圖
現(xiàn)在我們已經(jīng)成功地創(chuàng)建完項(xiàng)目，然后可以開始構(gòu)建 web 的內(nèi)容了，現(xiàn)在轉(zhuǎn)入下一步。
5. 開始一個 Struts 項(xiàng)目
這一部分我們將要集中創(chuàng)建一個 Struts 應(yīng)用示例，這個實(shí)力是在模仿一個簡單的網(wǎng)站登錄屏幕。所以，僅需要 2 個 Jsp 頁面，一個提示用戶登錄，另一個簡要的說明登錄成功。我們分別命名這 2 個 jsp 頁面為 userLogin.jsp 和 userL oginSuccess.jsp 。 如果用戶試圖登錄時存在授權(quán)錯誤，將直接指導(dǎo)用戶返回 LoginUser.jsp 并且顯示錯誤信息。
一般來說，當(dāng)開始一個 Struts 項(xiàng)目的時候，設(shè)計(jì)好應(yīng)用的流程是很有用的。這樣，開發(fā)團(tuán)隊(duì)就會對項(xiàng)目中所有元素的組合有一個更好的認(rèn)識。創(chuàng)建流程最容易的方法就是通過使用 Struts 圖形化設(shè)計(jì)模式。 Struts 編輯器提供了一個可以拖放工具，它可以使你通過快速的復(fù)制頁面流程來構(gòu)造應(yīng)用。這個應(yīng)用示例 Login 的流程就如下圖 6 所示
圖 6 ----- 應(yīng)用程序的流程
我們可以從上面的設(shè)計(jì)視圖中看到此應(yīng)用開始于 userLogin.jsp 頁面的顯示。此登錄頁將要調(diào)用 userLogin 動作（ action ）來執(zhí)行用戶的登錄操作。如果出現(xiàn)驗(yàn)證錯誤或問題， userLogin action 將引導(dǎo)用戶返回 userLogin.jsp 頁面。然而，如果登錄成功，應(yīng)用將轉(zhuǎn)向 userLoginSuccess.jsp 頁面。
5.1 Struts 項(xiàng)目的組件
一個典型的 Struts 項(xiàng)目會包括以下組件
JSPs
Actions
ActionForwards*
ActionForms**
Struts 部署文件 : struts-config.xml
在 MyElcipse 中可以通過 3 個不同的方法創(chuàng)建所有組件或者其中一個組件（除了 struts-config.xml ）
方法 1 ：使用菜單 File > New > Other... > J2EE > Struts 1.1 (or 1.0) ， 如下圖：
圖 7
對話框?qū)⒅苯右龑?dǎo)你并且提示你所有被 Struts 組件支持的值。一些部件要比其他的復(fù)雜。例如：如下圖 8 所示的對話框，你可以看到 Struts Action 支持的所有特征已經(jīng)被賦予了容易理解的值
圖 8----- 對話框：創(chuàng)建新的 Struts Action
方法 2 ：使用 Outline 視圖。從此視圖中，你可以通過右擊任何一個組件類型彈出菜單來創(chuàng)建此類型的新組件。圖 9 如下：
圖 9----Outline 視圖
方法 3 ： Struts 圖形化編輯器（如下圖 10 ）也是一個創(chuàng)建 Struts 組件的方便之路。打開 struts-config.xml 文件，單擊編輯器下面的 Design 標(biāo)簽就可以打開 Struts 圖形化編輯器
圖 10----- 打開 Struts 圖形化編輯器：
然后轉(zhuǎn)到如下圖 11 所示的編輯模式界面：
圖 11 ----- Struts 圖形化設(shè)計(jì)模式視圖
現(xiàn)在我們已經(jīng)知道怎么創(chuàng)建 Struts 部件的不同組件了，我們可以創(chuàng)建 Login 應(yīng)用的不同部分了。下面接著來
5.2 搭建應(yīng)用程序
我們通過集中創(chuàng)建 Jsp 頁面來開始搭建示例應(yīng)用。既然我們的應(yīng)用模擬某個網(wǎng)站登錄界面，那么僅需要 2 個 jsp 頁面： userLogin.jsp 和 userLoginSuccess.jsp 。像大多數(shù) Struts 應(yīng)用程序一樣，如果再登錄過程發(fā)生錯誤，將引導(dǎo)用戶回到 userLogin.jsp 并提示出錯（我們并不需要一個專門的出錯頁面 userLoginFailure.jsp ）。
首先，創(chuàng)建 userLoginSuccess.jsp ?？雌饋硐袷鞘紫葎?chuàng)建最后的頁面，這樣做的目的是我們可以利用 New Form, Action and JSP 來創(chuàng)建 userLogin.jsp, 這個頁面關(guān)聯(lián) Action 和 ActionForm 。
下圖 12 就是開始在 Struts 設(shè)計(jì)模式下創(chuàng)建 userLogin.jsp
圖 12---- 創(chuàng)建 jsp 頁面
在點(diǎn)擊后，系統(tǒng)將提示圖下圖 13 所示的對話框
注意：一定要選 Standard JSP using Struts 1.1
圖 13---- 配置 userLoginSuccess.jsp
在單擊 Finish 之后，設(shè)計(jì)試圖上顯示最新創(chuàng)建的頁面。如下圖 14
圖 14
要完成這個 jsp 頁面就只剩輸出那些告知用戶已經(jīng)成功登錄的信息了！下面給出了 userLoginSuccess.jsp 的源代碼：
|
userLoginSuccess.jsp |
|
<%@ page language= "java"%>
<%@ taglib uri="http://jakarta.apache.org/struts/tags-bean" prefix="bean" %>
<%@ taglib uri="http://jakarta.apache.org/struts/tags-html" prefix="html" %>
<%@ taglib uri="http://jakarta.apache.org/struts/tags-logic" prefix="logic" %>
<%@ taglib uri="http://jakarta.apache.org/struts/tags-tiles" prefix="tiles" %>
<%@ taglib uri="http://jakarta.apache.org/struts/tags-template" prefix="template" %>
<%@ taglib uri="http://jakarta.apache.org/struts/tags-nested" prefix="nested" %>
<!DOCTYPE HTML PUBLIC "-//W 3C//DTD HTML 4.01 Transitional//EN">
<html:html locale="true">
<head>
<title>My Struts 'userLoginSuccess.jsp' ending page</title>
</head>
<body>
Hello <bean:write name="userName" scope="request" />, you successfully logged in!
</body>
</html:html> |
這個頁面很簡單。我們唯一要做的事情 <body> 標(biāo)簽的內(nèi)容：輸出變量 userName 的值，這個變量 userName 是存儲在此應(yīng)用請求過程中。所以，在隨后要創(chuàng)建的 action 中，需要我們放置一個 userName 屬性在請求過程中。
此刻，我們還要創(chuàng)建 userLogin.jsp ， ActionForm 和 Action 。看起來工作量不少啊，但是 MyEclipse 可以通過 New Form and New Form, Action and JSP 對話框 方便的創(chuàng)建他們。
繼續(xù)構(gòu)建這個應(yīng)用，右擊 Struts designer 畫布的空白處。選擇 new ，接著選擇 New Form, Action and JSP 如下圖 15 所示：
圖 15------- 啟動 New Form, Action, JSP
首先出現(xiàn)的是： New Form 對話框。一定要輸入 user case 名稱。下圖 16 展現(xiàn)了你將要填寫的 user case 名稱 的值
圖 16
下面我們將要添加 2 個表單屬性： userName 和 password 。當(dāng)添加 password 域時，選擇 JSP input type 為 password 。如圖 17 所示：
圖 17 ----- 為表單添加屬性
圖 18 -----Form 屬性
在單擊 Next 前，一定要單擊 JSP 標(biāo)簽并如下圖 19 一樣操作。
圖 19
最后我們單擊 Methods 標(biāo)簽，不要選擇任何方法。如下圖 20
圖 20
單擊 Next 按鈕后，出現(xiàn) New Action 對話框，你可以看到已經(jīng)為你填寫了大多數(shù)的值。圖 21 就是這個對話框的截圖。如下：
圖 21
你可以單擊 Forwards 標(biāo)簽來指定 ActionForwards 。如下圖 22
圖 22
在為這個 action 添加完 Forwards 后，單擊 Finish 按鈕。 MyEclipse 會創(chuàng)建資源并更新 struts-config.xml 文件。圖 23 展示了更改后的結(jié)構(gòu)。
圖 23
現(xiàn)在系統(tǒng)的流程已經(jīng)被卻確定，我們需要為這個 Action 添加邏輯來控制 登錄流程。通過雙擊可以快速的跳轉(zhuǎn)到任何資源。就像下圖 24 展示的一樣
圖 24
當(dāng)你第一次打開 UserLoginAction.java 的時候，為 execute （）方法自動生成的代碼如下：
|
UserLoginAction.java |
|
public ActionForward execute(
ActionMapping mapping,
ActionForm form,
HttpServletRequest request,
HttpServletResponse response) {
UserLoginForm userLoginForm = (UserLoginForm) form;
throw new UnsupportedOperationException(
"Generated method 'execute(...)' not implemented.");
} |
修改 userLoginAction.java 的 execute （）方法后如下：
|
UserLoginAction.java |
|
public ActionForward execute(
ActionMapping mapping,
ActionForm form,
HttpServletRequest request,
HttpServletResponse response) {
UserLoginForm userLoginForm = (UserLoginForm) form;
if(userLoginForm.getUserName().equals("myeclipse") && userLoginForm.getPassword().equals("myeclipse"))
{
request.setAttribute("userName", userLoginForm.getUserName());
return mapping.findForward("success");
}
return mapping.findForward("failure");
} |
這里我們做了很簡單的事情，僅僅檢驗(yàn) userName 和 password 是不是都為 myeclipse 。如果是，存儲 userName 在請求過程中，并轉(zhuǎn)向： success ，因此 userLoginSucces.jsp 會顯示出個人化的信息。否則，出錯后將要轉(zhuǎn)向 failse 。在實(shí)際應(yīng)用中，你應(yīng)該添加 ActionMessages 或者 ActionErrors 集合一解釋發(fā)生了什么事情。
6. 運(yùn)行
現(xiàn)在應(yīng)用程序已經(jīng)完成，我們要把它部署到 Tomcat5 。打開 Package Explorer 視圖并且右擊項(xiàng)目，然后依次選擇 MyEclipse > Add and Remove Project Deployments 或者單擊工具條的 Deploy J2EE Project to Server 按鈕。如下圖 25
圖 25
完成部署后檢測部署狀態(tài)來確保正確部署。你可以按照圖 26 做
圖 26
最后按照圖 27 來啟動 Tomcat 來使用應(yīng)用服務(wù)器
圖 27
服務(wù)器啟動的時候， Eclipse 的 Console 視圖會顯示啟動狀態(tài)。如圖 28
圖 28
當(dāng) Tomcat5 運(yùn)行起來，我們就可以通過 MyEclipse 的 Browser 視圖來測試示例應(yīng)用了。選擇菜單 Window > Show View > Other... 截圖如下圖 29 所示
圖 29
在地址欄中輸入網(wǎng)址，如下圖所示
圖 30
說明程序能正常運(yùn)行。按照下圖 31 輸入 userName 和 passwod
圖 31
登錄以后，我們被引導(dǎo)到成功登錄界面。如圖 32
圖 32
7. 總結(jié)
在這個示例中，我們通過 MyEclipse Enterprise Workbench 提供的 Struts 工具開發(fā)了一個簡單的 Struts 應(yīng)用。
我們可以看大 MyEclipse 帶給我們益處：高效，方便。