js|建立 本例中,視圖包括兩個組件:
·一個JSP檔案:hello.jsp
·一個ActionForm Bean: HelloForm Bean
下面分別講述如何建立這兩個組件。
建立JSP檔案
hello.jsp提供使用者介面,能夠接受使用者輸入的姓名。此外,本Web應用的所有輸出結果也都由hello.jsp顯示給使用者。圖2-1顯示了hello.jsp提供的網頁。
圖2-1 hello.jsp的網頁
在圖2-1中,使用者輸入姓名"Weiqin"後,按提交表單,本應用將返回"Hello Weiqin!",參見圖2-2。
圖2-2 hello.jsp接受使用者輸入後正常返回的網頁
常式2-1為hello.jsp檔案的原始碼。
常式2-1 hello.jsp <%@ page contentType="text/html;charset=UTF-8" language="java" %><%@ taglib uri="/WEB-INF/struts-bean.tld" prefix="bean" %><%@ taglib uri="/WEB-INF/struts-html.tld" prefix="html" %><%@ taglib uri="/WEB-INF/struts-logic.tld" prefix="logic" %><html:html locale="true"> <head> <title><bean:message key="hello.jsp.title"/></title> <html:base/> </head> <body bgcolor="white"><p> <h2><bean:message key="hello.jsp.page.heading"/></h2><p> <html:errors/><p> <logic:present name="personbean" scope="request"> <h2> <bean:message key="hello.jsp.page.hello"/> <bean:write name="personbean" property="userName" />!<p> </h2> </logic:present> <html:form action="/HelloWorld.do" focus="userName" > <bean:message key="hello.jsp.prompt.person"/> <html:text property="userName" size="16" maxlength="16"/><br> <html:submit property="submit" value="Submit"/> <html:reset/> </html:form><br> <html:img page="/struts-power.gif" alt="Powered by Struts"/> </body></html:html> |
以上基於Struts架構的JSP檔案有以下特點:
·沒有任何Java程式碼
·使用了許多Struts的客戶化標籤,例如<html:form>和<logic:present>標籤
沒有直接提供常值內容,取而代之的是<bean:message>標籤,輸出到網頁上的常值內容都是由<bean:message> 標籤來產生的。例如:
<bean:message key="hello.jsp.prompt.person"/>
Struts客戶化標籤是聯絡視圖組件和Struts架構中其它組件的紐帶。這些標籤可以訪問或顯示來自於控制器和模型組件的資料。在本書第12章至16章講專門介紹Struts標籤的用法,本節先簡單介紹幾種重要的Struts標籤。
hello.jsp開頭幾行用於聲明和載入Struts標籤庫:
<%@ taglib uri="/WEB-INF/struts-bean.tld" prefix="bean" %><%@ taglib uri="/WEB-INF/struts-html.tld" prefix="html" %><%@ taglib uri="/WEB-INF/struts-logic.tld" prefix="logic" %> |
以上代碼錶明該JSP檔案使用了Struts Bean、Html和Logic 標籤庫,這是載入客戶化標籤庫的標準JSP文法。
hello.jsp中使用了來自 Struts HTML標籤庫中的標籤,包括<html:errors>, <html:form>和<html:text>:
·<html:errors>:用於顯示Struts架構中其他組件產生的錯誤訊息。
·<html:form>:用於建立HTML表單,它能夠把HTML表單的欄位和ActionForm Bean的屬性關聯起來。
·<html:text>:該標籤是<html:form>的子標籤,用於建立HTML表單的文字框。它和ActionForm Bean的屬性相關聯。
hello.jsp中使用了來自Struts Bean標籤庫的兩個標籤<bean:message>和<bean:write>:
<bean:message>:用於輸出本地化的常值內容,它的key屬性指定訊息key,和訊息key匹配的常值內容來自於專門的Resource Bundle,關於Resource Bundle的概念參見本書第9章(Struts應用的國際化)。
<bean:write>:用於輸出JavaBean的屬性值。本例中,它用於輸出personbean對象的userName屬性值:
<bean:write name="personbean" property="userName" />
hello.jsp使用了來自Struts Logic標籤庫的<logic:present>標籤。<logic:present>標籤用來判斷JavaBean在特定的範圍內是否存在,只有當JavaBean存在,才會執列標籤主體中的內容:
<logic:present name="personbean" scope="request"> <h2> Hello <bean:write name="personbean" property="userName" />!<p> </h2></logic:present> |
本例中,<logic:present>標籤用來判斷在request範圍內是否存在personbean對象,如果存在,就輸出personbean的userName屬性值。和<logic:present>標籤相對的是<logic:notPresent>標籤,它表示只有當JavaBean在特定的範圍內不存在,才會執列標籤主體中的內容。
建立訊息資源檔
hello.jsp使用<bean:message>標籤來輸出常值內容。這些文本來自於Resource Bundle,每個Resource Bundle都對應一個或多個本地化的訊息資源檔,本例中的資源檔為application.properties,常式2-2是該訊息資源檔的內容。
常式 2-2 application.properties檔案#Application Resources for the "Hello" sample applicationhello.jsp.title=Hello - A first Struts programhello.jsp.page.heading=Hello World! A first Struts applicationhello.jsp.prompt.person=Please enter a UserName to say hello to :hello.jsp.page.hello=Hello#Validation and error messages for HelloForm.java and HelloAction.javahello.dont.talk.to.monster=We don't want to say hello to Monster!!!hello.no.username.error=Please enter a <i>UserName</i> to say hello to! |
以上檔案以"訊息key/訊息文本"的格式存放資料,檔案中"#"後面為注釋行。對於以下JSP代碼:
<bean:message key="hello.jsp.title"/>
<bean:message>標籤的key屬性為"hello.jsp.tilte",在Resource Bundle中與之匹配的內容為:hello.jsp.title=Hello - A first Struts program
因此,以上<bean:message>標籤將把"Hello - A first Struts program"輸出到網頁上。
建立ActionForm Bean
當使用者提交了HTML表單,Struts架構自動把表單資料群組裝到ActionForm Bean中。ActionForm Bean中的屬性和HTML表單中的欄位一一對應。ActionForm Bean還提供資料驗證方法,以及把屬性重新設定為預設值的方法。Struts架構中定義的ActionForm類是抽象的,必須在應用中建立它的子類,來存放具體的HTML表單資料。常式2-3為HelloForm.java的來源程式, 它用於處理hello.jsp中的表單資料。
常式2-3 HelloForm.javapackage hello;import javax.servlet.http.HttpServletRequest;import org.apache.struts.action.ActionMessage;import org.apache.struts.action.ActionErrors;import org.apache.struts.action.ActionForm;import org.apache.struts.action.ActionMapping;public final class HelloForm extends ActionForm { private String userName = null; public String getUserName() { return (this.userName); } public void setUserName(String userName) { this.userName = userName; } /** * Reset all properties to their default values. */ public void reset(ActionMapping mapping, HttpServletRequest request) { this.userName = null; } /** * Validate the properties posted in this request. If validation errors are * found, return an <code>ActionErrors</code> object containing the errors. * If no validation errors occur, return <code>null</code> or an empty * <code>ActionErrors</code> object. */ public ActionErrors validate(ActionMapping mapping, HttpServletRequest request) { ActionErrors errors = new ActionErrors(); if ((userName == null) || (userName.length() < 1)) errors.add("username", new ActionMessage("hello.no.username.error")); return errors; }} |
從以上代碼可以看出,ActionForm Bean實質上是一種JavaBean,不過它除了具有JavaBean的常規方法,還有兩個特殊方法:
·validate():用於表單驗證。
·reset():把屬性重新設定為預設值。