簡(jiǎn)單介紹JSF應(yīng)用
JavaServer Pages(JSF) 在 Java 的 WEB 編程中已經(jīng)被認(rèn)為是下一個(gè)重大的事件。通過(guò) JSF ,你可以在網(wǎng)頁(yè)上使用 WEB 組件,來(lái)捕獲用戶行為產(chǎn)生的事件。不遠(yuǎn)的將來(lái),Java 工具將支持這個(gè)技術(shù),開(kāi)發(fā) WEB 應(yīng)用程序?qū)⑴c我們現(xiàn)在開(kāi)發(fā) SWING 程序類似:拖放控件、寫事件偵聽(tīng)器。本文是一個(gè) JSF 的簡(jiǎn)要介紹,并且提供一個(gè) JSF 的例子,用來(lái)展示 JSF 的事件驅(qū)動(dòng)特性。要理解本文,您需要對(duì) servlets, JSP, JavaBeans, 與標(biāo)簽庫(kù)有一定的理解。
首先,一個(gè) JSF應(yīng)用就是一個(gè) servlet/JSP 應(yīng)用。它有一個(gè)配置描述符,有 JSP 頁(yè)面、客戶定制標(biāo)簽、靜態(tài)資源等等。不同的是,JSF應(yīng)用是事件驅(qū)動(dòng)的。你通過(guò)寫一個(gè)事件偵聽(tīng)類來(lái)決定應(yīng)用程序的行為。以下建立一個(gè) JSF應(yīng)用所需要的幾個(gè)步驟:
1、建立 JSP 頁(yè)面,用 JSF 組件包裝 HTML 元素。
2、寫一個(gè) JavaBean 用來(lái)保持用戶輸入與組件數(shù)據(jù)的狀態(tài)。
3、寫一個(gè)事件偵聽(tīng)器來(lái)決定當(dāng)某事件發(fā)生時(shí)應(yīng)該有什么反映,比如用戶點(diǎn)擊了一個(gè)按鈕或者提交了表單。JSF 支持兩個(gè)事件:ActionEvent 與 valueChangeEvent 。ActionEvent 是針對(duì)用戶提交表單與點(diǎn)擊按鈕的,而 valueChangeEvent 是當(dāng)一個(gè) JSF 組件改變了時(shí)觸發(fā)。
現(xiàn)在,讓我們來(lái)看一下 JSF 動(dòng)作的細(xì)節(jié)。
JSF 怎樣工作
JSP 頁(yè)面是 JSF 應(yīng)用的用戶接口。每個(gè)頁(yè)面包括一些 JSF 組件用來(lái)描述 WEB 控件,如表單、輸入框、按鈕等等。組件可以嵌入另一個(gè)組件中,正如輸入框可以在表單中。每個(gè) JSP 頁(yè)面就這樣表示為組件樹(shù)。JaveBeans 從用戶的請(qǐng)求中獲取數(shù)據(jù)并存儲(chǔ)。
這是有意思的部分:每當(dāng)用戶做任何事情,如點(diǎn)擊按鈕或者提交表單,都有事件產(chǎn)生。然后事件消息通過(guò) HTTP 傳到服務(wù)器。在服務(wù)器端,是一個(gè)配置了叫做 Faces servlet 的特殊 servlet 的 WEB 容器。Faces servlet(javax.faces.webapp.FacesServlet)是所有 JSF應(yīng)用的引擎。每個(gè) JSF應(yīng)用在 WEB 容器中都有獨(dú)立的 Faces servlet 。另一個(gè)重要的對(duì)象是 javax.faces.context.FacesContext , 它包括了所有關(guān)于當(dāng)前用戶請(qǐng)求的必要信息。
Faces servlet 的后臺(tái)處理是相當(dāng)復(fù)雜的。然而你沒(méi)有必要了解這些細(xì)節(jié),只需要記住:Faces servlet 為 JSP 頁(yè)面創(chuàng)建了組件樹(shù),對(duì)組件樹(shù)的控制又對(duì)應(yīng)著事件。Faces servlet 知道怎么去創(chuàng)建組件樹(shù),因?yàn)樗呀?jīng)訪問(wèn)了當(dāng)前應(yīng)用中所有的 JSP 頁(yè)面。Faces servlet 還會(huì)創(chuàng)建一個(gè) Event 對(duì)象,并把它傳遞給所有注冊(cè)過(guò)的偵聽(tīng)器。你可以通過(guò)與當(dāng)前請(qǐng)求相對(duì)應(yīng)的 FacesContext 得到這個(gè)頁(yè)面的組件樹(shù)。
客戶端瀏覽器上 WEB 控件產(chǎn)生的事件,被包含在一個(gè) HTTP 請(qǐng)求中,放在一起還有如瀏覽器類型、請(qǐng)求地址等其它信息。因此,所有需要 Faces servlet 處理的請(qǐng)求必須指向這個(gè) servlet 。那你怎樣通過(guò)調(diào)用 Faces servelt 來(lái)處理每個(gè) HTTP 請(qǐng)求呢?很容易,只需要在配置描述符里用一個(gè) servlet-mapping 元素把一個(gè)特殊的 URL 式樣映射到 Faces servlet。通常,你會(huì)用到 /faces/* 樣式,如下所示:
- <!-- Faces Servlet -->
- <servlet>
- <servlet-name>Faces Servlet</servlet-name>
- <servlet-class>javax.faces.webapp.FacesServlet</servlet-class>
- <load-on-startup>1</load-on-startup>
- </servlet>
- <!-- Faces Servlet Mapping -->
- <servlet-mapping>
- <servlet-name>Faces Servlet</servlet-name>
- <url-pattern>/faces/*</url-pattern>
- </servlet-mapping>
請(qǐng)求地址必須包含有在 <url-pattern> 元素中描述的樣式。這個(gè)要求不容易達(dá)到。另外也需要注意的是 <servlet> 元素,它包含 Faces servlet ,有一個(gè) <load-on-startup> 元素,用來(lái)確是否應(yīng)用程序***次啟動(dòng)時(shí) servlet 是否加載。
為了捕獲組件產(chǎn)生的事件,你需要為這個(gè)組件寫一個(gè)偵聽(tīng)器,并把它注冊(cè)給這個(gè)組件。通過(guò)在表示組件的客戶端標(biāo)簽中嵌入 <action_listener> 元素能做到這一點(diǎn)。例如,為了讓一個(gè)名叫 jsfApp.MyActionListener 的事件偵聽(tīng)器,來(lái)捕獲一個(gè)名叫 submitButton 的命令按鈕產(chǎn)生的事件,在你的 JSP 頁(yè)面中寫如下的代碼即可:
- <h:command_button id="submitButton" label="Add" commandName="submit" >
- <f:action_listener type="jsfApp.MyActionListener" />
- </h:command_button>
一個(gè) action listener 必須實(shí)現(xiàn) javax.faces.event.ActionListener 接口,而一個(gè) value-changed listener 必須實(shí)現(xiàn) java.faces.event.valueChangedLister 接口。下面讓我們來(lái)創(chuàng)建一個(gè)簡(jiǎn)單的 JSF應(yīng)用,以展現(xiàn) JSF 是怎么樣事件驅(qū)動(dòng)的。
一個(gè)簡(jiǎn)單的JSF應(yīng)用
我們將創(chuàng)建一個(gè)簡(jiǎn)單的應(yīng)用,它可以實(shí)現(xiàn)對(duì)二個(gè)數(shù)字相加。為了運(yùn)行這個(gè)應(yīng)用,你需要準(zhǔn)備 TOMCAT5 與 JSF v1.0 EA4(包含在 Java Web Services Developer Pack (JWSDP) 1.2中)。這個(gè)應(yīng)用程序包括:
◆adder.jsp JSP 頁(yè)面。
◆NumberBean 存放用戶數(shù)據(jù)的 JavaBean
◆MyActionListener 事件偵聽(tīng)器
◆web.xml 配置描述文件
為了使這個(gè)應(yīng)用能正常工作,還需要幾個(gè) jar 文件,包括 JSF 標(biāo)準(zhǔn)實(shí)現(xiàn)與其它類庫(kù)。如果你安裝了 JWSDP 1.2,你就可以在 jsflib 目錄下找到所需要的這些文件。把這些 .jar 文件拷貝到 WEB-INF/lib 目錄下。下面是整個(gè)的 .jar 與 .tld 文件列表:
◆jsf-api.jar 包含有 Faces servlet 與其它相關(guān) javax.faces 包下面的類
◆jfs-ri.jar 是 JSF 的參考實(shí)現(xiàn)
◆jstl_el.jar
◆standard.jar
此外,一個(gè) JSF應(yīng)用還需要如下的類庫(kù),它們是 Apache Jakarta 項(xiàng)目的一部分:
◆commons-beanutils.jar
◆commons-digester.jar
◆commons-logging.jar is
以下的幾小段討論這個(gè) JSF 示例的每個(gè)部分。***的一小段,“編譯與運(yùn)行”,解釋 JSF應(yīng)用怎么樣運(yùn)行。
創(chuàng)建目錄結(jié)構(gòu)
首先為你的 JSF應(yīng)用創(chuàng)建一個(gè)目錄結(jié)構(gòu)。在 TOMCAT 中,它在 webapps 目錄下。“圖1”描述了叫做 myJSFApp 的應(yīng)用程序的目錄結(jié)構(gòu)。
寫配置描述符
與其它的 servlet/JSP 應(yīng)用一樣,這個(gè)應(yīng)用程序也需要一個(gè)配置描述文件。
- <?xml version="1.0"?>
- <!DOCTYPE web-app PUBLIC
- "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
- "http://java.sun.com/dtd/web-app_2_3.dtd";;>
- <web-app>
- <!-- Faces Servlet -->
- <servlet>
- <servlet-name>Faces Servlet</servlet-name>
- <servlet-class>javax.faces.webapp.FacesServlet</servlet-class>
- <load-on-startup> 1 </load-on-startup>
- </servlet>
- <!-- Faces Servlet Mapping -->
- <servlet-mapping>
- <servlet-name>Faces Servlet</servlet-name>
- <url-pattern>/faces/*</url-pattern>
- </servlet-mapping>
- </web-app>
在這個(gè)配置描述文件中有二個(gè)部分。 <servlet> 元素注冊(cè) Faces servlet , <servlet-mapping> 元素聲明任何包含有 /faces/ 式樣的請(qǐng)求地址,必須傳遞給 Faces servlet 。
創(chuàng)建 JSP 頁(yè)面一個(gè)叫做 adder.jsp 的 JSP 頁(yè)面提供用戶接口
- <%@ taglib uri="http://java.sun.com/jsf/html";; prefix="h" %>
- <%@ taglib uri="http://java.sun.com/jsf/core";; prefix="f" %>
- <html>
- <head>
- <title>Add 2 numbers</title>
- </head>
- <body>
- <jsp:useBean id="NumberBean" class="jsfApp.NumberBean" scope="session" />
- <f:use_faces><br />
- <h:form id="addForm" formName="addForm" ><br />
- First Number:<br />
- <h:input_number id="firstNumber" valueRef="NumberBean.firstNumber" /><br />
- Second Number:
- <h:input_number id="secondNumber" valueRef="NumberBean.secondNumber" /><br />
- Result:
- <h:output_number id="output" valueRef="NumberBean.result"/><br>
- <h:command_button id="submitButton" label="Add" commandName="submit" >
- <f:action_listener type="jsfApp.MyActionListener" />
- </h:command_button>
- </h:form>
- </f:use_faces>
- </body>
- </html>
我們首先定義了倆個(gè)標(biāo)簽,它用到 JSF 的兩個(gè)標(biāo)簽庫(kù):html 與 core 。這倆個(gè)標(biāo)簽庫(kù)的定義可以在 jsf-ri.jar 文件中找到,所以你不用為它擔(dān)心。它們的前綴分別是 h / f 。
- <%@ taglib uri="http://java.sun.com/jsf/html";; prefix="h" %>
- <%@ taglib uri="http://java.sun.com/jsf/core";; prefix="f" %>
- <jsp:useBean> 這個(gè)動(dòng)作元素定義 NumberBean JavaBean 為 session scope 。
- <jsp:useBean id="NumberBean" class="jsfApp
【編輯推薦】