摘要:
這是我翻譯的 Myeclipse 的一篇關于創建 Struts 應用的文檔。粗略的翻譯,有些我翻譯不了或者認為沒有必要的就刪去了。我的表達能力差,翻譯起來更差勁。讀文檔的時候,感覺很順利,很輕松,于是就想試著翻譯一下,可是一旦做起來,才發現很難。有些句子的意思很明白,可是一旦轉化成中文的時候,感覺就在嘴邊打轉,可是又吐不出來。真難受呀。好不容易湊成了一篇,也就貼出來了。讀著讀著發現自己都讀不下去了。呵呵,慢慢來,總會好的 正如我對自己的評說:一切正向著好的方向前進,盡管很慢。
目錄:
1 序
2 介紹
3 必備
4 構造一個新項目
5 開始一個 Struts 項目
? Struts 項目的組件
? 搭建應用程序
6 運行
7 總結
正文:
1. 序
此文檔適應 Sun JDK 1.4.2, Eclipse 3.0.1 and MyEclipse 3.8.2. 環境。所有的屏幕截圖都是基于 Eclipse, MyEclipse Enterprise Workbench, and Windows XP 的默認用戶接口設置。如果你在使用這個文檔的過程中遇到困難,請看用戶反饋部分,以反饋給 MyEclipse documentation team 。
2. 說明
在這個用戶指南中我們將通過 MyEclipse Enterprise Workbench 來開發和測試一個簡單的 Struts 示例應用。這并不需要我們具有 Struts 或者 MyEclipse 的預備知識。
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. 構造一個新項目
為了有效的組織我們的開發,我們需要在添加了 Struts Capabilities 的 MyEclipse 中創建一個新的 Web Module Project 。 你可以創建一個 web project 通過菜單 File > New > Other > Project > J2EE > Web Project ,如下圖所示

圖 1--- 新建 Web Project 對話框
然后鍵入關于新項目的所有信息 ,如下圖:

圖 2 ---- 設置 Web Project
一旦創建了 Web Project ,我們需要為 MyEclipse 添加 Struts Capabilities 。這可以通過右擊 Package Explorer 視圖中 項目的名稱,并且依次選擇 MyEclipse > Add Struts Capabilities 做到。如下面圖示:

圖 3 :在 Web Project 中 添加 Struts Capabilities
對這個應用來說, Struts 對話框的默認值已經很適合了。但是,你可以改變 Base package for new classes 來適應你的情況。如下圖 4 所示,我們只是簡單的保留這些默認值。
圖 4---- 配置 Struts Capabilities
當完成上面的步驟,項目的結構會如下圖 5 所示

圖 5 ---- 配置后的項目結構視圖
現在我們已經成功地創建完項目,然后可以開始構建 web 的內容了,現在轉入下一步。
5. 開始一個 Struts 項目
這一部分我們將要集中創建一個 Struts 應用示例,這個實力是在模仿一個簡單的網站登錄屏幕。所以,僅需要 2 個 Jsp 頁面,一個提示用戶登錄,另一個簡要的說明登錄成功。我們分別命名這 2 個 jsp 頁面為 userLogin.jsp 和 userL oginSuccess.jsp 。 如果用戶試圖登錄時存在授權錯誤,將直接指導用戶返回 LoginUser.jsp 并且顯示錯誤信息。
一般來說,當開始一個 Struts 項目的時候,設計好應用的流程是很有用的。這樣,開發團隊就會對項目中所有元素的組合有一個更好的認識。創建流程最容易的方法就是通過使用 Struts 圖形化設計模式。 Struts 編輯器提供了一個可以拖放工具,它可以使你通過快速的復制頁面流程來構造應用。這個應用示例 Login 的流程就如下圖 6 所示

圖 6 ----- 應用程序的流程
我們可以從上面的設計視圖中看到此應用開始于 userLogin.jsp 頁面的顯示。此登錄頁將要調用 userLogin 動作( action )來執行用戶的登錄操作。如果出現驗證錯誤或問題, userLogin action 將引導用戶返回 userLogin.jsp 頁面。然而,如果登錄成功,應用將轉向 userLoginSuccess.jsp 頁面。
5.1 Struts 項目的組件
一個典型的 Struts 項目會包括以下組件
JSPs
Actions
ActionForwards*
ActionForms**
Struts 部署文件 : struts-config.xml
在 MyElcipse 中可以通過 3 個不同的方法創建所有組件或者其中一個組件(除了 struts-config.xml )
方法 1 :使用菜單 File > New > Other... > J2EE > Struts 1.1 (or 1.0) , 如下圖:
圖 7
對話框將直接引導你并且提示你所有被 Struts 組件支持的值。一些部件要比其他的復雜。例如:如下圖 8 所示的對話框,你可以看到 Struts Action 支持的所有特征已經被賦予了容易理解的值

圖 8----- 對話框:創建新的 Struts Action
方法 2 :使用 Outline 視圖。從此視圖中,你可以通過右擊任何一個組件類型彈出菜單來創建此類型的新組件。圖 9 如下:

圖 9----Outline 視圖
方法 3 : Struts 圖形化編輯器(如下圖 10 )也是一個創建 Struts 組件的方便之路。打開 struts-config.xml 文件,單擊編輯器下面的 Design 標簽就可以打開 Struts 圖形化編輯器

圖 10----- 打開 Struts 圖形化編輯器:
然后轉到如下圖 11 所示的編輯模式界面:

圖 11 ----- Struts 圖形化設計模式視圖
現在我們已經知道怎么創建 Struts 部件的不同組件了,我們可以創建 Login 應用的不同部分了。下面接著來
5.2 搭建應用程序
我們通過集中創建 Jsp 頁面來開始搭建示例應用。既然我們的應用模擬某個網站登錄界面,那么僅需要 2 個 jsp 頁面: userLogin.jsp 和 userLoginSuccess.jsp 。像大多數 Struts 應用程序一樣,如果再登錄過程發生錯誤,將引導用戶回到 userLogin.jsp 并提示出錯(我們并不需要一個專門的出錯頁面 userLoginFailure.jsp )。
首先,創建 userLoginSuccess.jsp 。看起來像是首先創建最后的頁面,這樣做的目的是我們可以利用 New Form, Action and JSP 來創建 userLogin.jsp, 這個頁面關聯 Action 和 ActionForm 。
下圖 12 就是開始在 Struts 設計模式下創建 userLogin.jsp

圖 12---- 創建 jsp 頁面
在點擊后,系統將提示圖下圖 13 所示的對話框
注意:一定要選 Standard JSP using Struts 1.1

圖 13---- 配置 userLoginSuccess.jsp
在單擊 Finish 之后,設計試圖上顯示最新創建的頁面。如下圖 14

圖 14
要完成這個 jsp 頁面就只剩輸出那些告知用戶已經成功登錄的信息了!下面給出了 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> 標簽的內容:輸出變量 userName 的值,這個變量 userName 是存儲在此應用請求過程中。所以,在隨后要創建的 action 中,需要我們放置一個 userName 屬性在請求過程中。
此刻,我們還要創建 userLogin.jsp , ActionForm 和 Action 。看起來工作量不少啊,但是 MyEclipse 可以通過 New Form and New Form, Action and JSP 對話框 方便的創建他們。
繼續構建這個應用,右擊 Struts designer 畫布的空白處。選擇 new ,接著選擇 New Form, Action and JSP 如下圖 15 所示:

圖 15------- 啟動 New Form, Action, JSP
首先出現的是: New Form 對話框。一定要輸入 user case 名稱。下圖 16 展現了你將要填寫的 user case 名稱 的值
圖 16
下面我們將要添加 2 個表單屬性: userName 和 password 。當添加 password 域時,選擇 JSP input type 為 password 。如圖 17 所示:

圖 17 ----- 為表單添加屬性

圖 18 -----Form 屬性
在單擊 Next 前,一定要單擊 JSP 標簽并如下圖 19 一樣操作。

圖 19
最后我們單擊 Methods 標簽,不要選擇任何方法。如下圖 20

圖 20
單擊 Next 按鈕后,出現 New Action 對話框,你可以看到已經為你填寫了大多數的值。圖 21 就是這個對話框的截圖。如下:

圖 21
你可以單擊 Forwards 標簽來指定 ActionForwards 。如下圖 22

圖 22
在為這個 action 添加完 Forwards 后,單擊 Finish 按鈕。 MyEclipse 會創建資源并更新 struts-config.xml 文件。圖 23 展示了更改后的結構。

圖 23
現在系統的流程已經被卻確定,我們需要為這個 Action 添加邏輯來控制 登錄流程。通過雙擊可以快速的跳轉到任何資源。就像下圖 24 展示的一樣

圖 24
當你第一次打開 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"); } |
這里我們做了很簡單的事情,僅僅檢驗 userName 和 password 是不是都為 myeclipse 。如果是,存儲 userName 在請求過程中,并轉向: success ,因此 userLoginSucces.jsp 會顯示出個人化的信息。否則,出錯后將要轉向 failse 。在實際應用中,你應該添加 ActionMessages 或者 ActionErrors 集合一解釋發生了什么事情。
6. 運行
現在應用程序已經完成,我們要把它部署到 Tomcat5 。打開 Package Explorer 視圖并且右擊項目,然后依次選擇 MyEclipse > Add and Remove Project Deployments 或者單擊工具條的 Deploy J2EE Project to Server 按鈕。如下圖 25
圖 25
完成部署后檢測部署狀態來確保正確部署。你可以按照圖 26 做

圖 26
最后按照圖 27 來啟動 Tomcat 來使用應用服務器

圖 27
服務器啟動的時候, Eclipse 的 Console 視圖會顯示啟動狀態。如圖 28

圖 28
當 Tomcat5 運行起來,我們就可以通過 MyEclipse 的 Browser 視圖來測試示例應用了。選擇菜單 Window > Show View > Other... 截圖如下圖 29 所示
圖 29
在地址欄中輸入網址,如下圖所示
圖 30
說明程序能正常運行。按照下圖 31 輸入 userName 和 passwod

圖 31
登錄以后,我們被引導到成功登錄界面。如圖 32

圖 32
7. 總結
在這個示例中,我們通過 MyEclipse Enterprise Workbench 提供的 Struts 工具開發了一個簡單的 Struts 應用。
我們可以看大 MyEclipse 帶給我們益處:高效,方便。