DIV CSS 佈局教程網

DynamicFaces 入門:為 JavaServer Faces 加上 Ajax 能力
編輯:AJAX基礎知識     

一、用 ajaxZone 標籤更新局部頁面

決定網頁上哪些元件要支援 Ajax,有一種方式是用 Dynamic Faces 提供的 ajaxZone 自訂標籤把它們包起來。這樣做,就是告訴 Dynamic Faces:只非同步更新由 ajaxZone 標籤所界定的那部分元件樹。

舉例來說,假設有一個帶著一連串按鈕的網頁,客戶在網上選購汽車時,可以用這些按鈕選擇標準或豪華配裝。當客戶點擊某個按鈕,其他一些元件的值會跟著改變,而不必重新載入整個網頁;當客戶變更某個元件的值,汽車價格也會更新,同樣不觸發整頁刷新。

下圖是 carstore 應用中網頁的畫面:


圖 1 選擇汽車配裝

畫面被劃分為兩個區域。點擊區域 2 中的按鈕時,該區域內元件的選取值會改變;而變更區域 2 中的元件時,區域 1 的 Your Price 輸出元件隨之更新。

要實現這樣的效果,把所有元件包進 ajaxZone 即可:

<jsfExt:ajaxZone id="zone1">
  <h:panelGrid columns="2">
    <h:outputText styleClass="subtitle" value="#{bundle.basePriceLabel}"/>
    <h:outputText binding="#{carstore.currentModel.components.basePrice}"/>
    <h:outputText styleClass="subtitle" value="#{bundle.yourPriceLabel}"/>
    <h:outputText value="#{carstore.currentModel.currentPrice}"/>
  </h:panelGrid>
</jsfExt:ajaxZone>

<jsfExt:ajaxZone id="zone2"
    action="#{carstore.currentModel.updatePricing}">
  <h:commandButton id="Standard" value="#{bundle.Standard}"
    styleClass="#{carstore.customizers.Standard.buttonStyle}"
    actionListener="#{carstore.choosePackage}"/>
  <h:commandButton id="Deluxe" value="#{bundle.Deluxe}"
    styleClass="#{carstore.customizers.Deluxe.buttonStyle}"
    actionListener="#{carstore.choosePackage}"/>
  <h:outputText value="#{bundle.Engine}" styleClass="optionLabel"/>
  <h:selectOneMenu styleClass="optionValue"
    binding="#{carstore.currentModel.components.engine}"/>
  <h:outputText value="#{bundle.Speakers}" styleClass="optionLabel"/>
  <h:selectOneRadio styleClass="optionValue"
    binding="#{carstore.currentModel.components.speaker}"/>
</jsfExt:ajaxZone>

zone 1 只有輸出元件,因此不會產生任何 Ajax 請求;zone 2 則含輸入與輸出元件。當使用者點擊兩個按鈕之一,或在下拉選單、單選列表中挑選選項時,zone 2 的元件會啟動一次 Ajax 請求,觸發 #{carstore.currentModel.updatePricing} 所定義的操作。

使用區域時有個重要特性:每次 Ajax 事務會使得網頁上所有區域都被更新。於是在這個例子中,使用者只要變更 zone 2 的任何輸入元件,zone 1 的汽車價格就會自動更新。

值得强调的是:實現這個範例不需要撰寫一行 JavaScript,也不需要任何自訂元件。它用的全是我們熟悉而樸素的 JavaServer Faces 元件,但它們已經具備了 Ajax 能力。

ajaxZone 為網頁開發者提供了一種簡單、熟悉而直觀的入門方式。在最簡單的案例中它就已足夠;同時它也支援許多能進一步微調行為的屬性,完整清單可查閱官方文件。

二、用 fireAjaxTransaction 做細粒度控制

若你想對 Ajax 相關的任務進行更細緻的控制,可以使用 Dynamic Faces 提供的內建 JavaScript 庫。透過在既有元件標籤中適當地使用 DynaFaces.fireAjaxTransaction,你就能對「哪些元件以什麼方式被非同步更新」取得元件層級的掌控權。

例如,你希望網頁上某些元件對 onclick 這類事件回應,另一些元件則對別的事件回應;而且每個觸發 Ajax 請求的元件,都該引起元件樹的不同部分被更新。這就需要 fireAjaxTransaction。

使用步驟是:

  1. 在元件標籤中加上一個 JavaScript 事件屬性,例如 onclick。
  2. 把該屬性的值設為 DynaFaces.fireAjaxTransaction 函式呼叫。
  3. 傳入一組參數,說明這次要執行哪些元件、又要重新渲染哪些元件。

以下是一個 Hello World 範例的片段,使用者輸入名字、按下按鈕,應用程式便以一句含名字的問候回應:

...
<f:view>
...
<h:form id="form" prependId="false">
...
  <h:graphicImage value="wave.med.gif"/>
  <p>
  Hello, my name is Duke. What is your name?
  <p>
  <h:inputText id="input" value="#{testBean.name}"/>
  <h:commandButton id="button"
    actionListener="#{testBean.changeText}"
    onclick="DynaFaces.fireAjaxTransaction(this,
      {execute: 'input', 'button',
       render: 'input', 'text'}); return false;"
    value="click"/>
  <p>
  <h:outputText id="text" value="#{testBean.text}"/>
</h:form>
...
</f:view>

當使用者在輸入框打字並按下按鈕,會發生三件事:

  1. DynaFaces.fireAjaxTransaction 執行,Dynamic Faces 向伺服器發出 Ajax 請求。
  2. 伺服器回傳一份由 Dynamic Faces JavaScript 庫處理的專用 XML 回應。
  3. 對應的庫函式以新值更新 HTML DOM 樹。

呼叫時的 this 指的是代表觸發事件的按鈕標籤,其餘參數則是選項:

onclick="DynaFaces.fireAjaxTransaction(this,
  {execute: 'input', 'button',
   render: 'input', 'text'}); return false;"

execute 與 render 的意義

這兩個選項對應到 JavaServer Faces 生命週期的兩個部分。execute 是 postback 期間執行的那一段,包含資料轉換、驗證與更新模型物件的階段;render 則負責依請求顯示網頁。


圖 2 execute 與 render 如何切分 JSF 生命週期

在範例中,execute 選項列出了必須走完 execute 階段的元件 id:

execute: 'input', 'button'

承接使用者名稱的 input 元件必須執行,因為它的值要存進模型物件;button 也必須執行,因為 Invoke Application 階段屬於 execute 區段的一部分。

而 render 選項則指定作為這次 Ajax 請求結果、需要重新顯示的元件:

render: 'input', 'text'

於是按下按鈕後,代表 input 的輸入框與代表 text 的輸出文字會被重新渲染:輸入框被重繪(清除按下按鈕前使用者輸入的值),輸出文字則顯示按下按鈕前填入的內容。網頁上其他元件完全不必重新渲染。

除了這兩個,還有其他選項可以進一步微調 Dynamic Faces 的行為。要記住的重點是:fireAjaxTransaction 讓你能精確決定網頁中哪些元件該受益於 Ajax——事實上,它讓任何元件都能支援 Ajax,而你不必寫任何 JavaScript。

三、Dynamic Faces 與 jMaki 聯手

到目前為止,我們談的都是如何重新渲染既有的 JSF 元件。但如果想加入那些在 JSF 應用中常見、本身已支援 Ajax 的 widget 呢?

答案是 Project jMaki:把喜歡的 widget 封裝成 JSF 元件。如此一來,你既享有 JSF 元件模型的種種好處,又能保有使用該 widget 的彈性;而且不必為既有元件撰寫 Ajax 用的 JavaScript,也不必為 widget 撰寫 JSF 元件所需的 Java 平台程式碼。

對網頁開發者而言,使用方式極為簡單——把對應的 jMaki 標籤拖進網頁即可。而對 widget 開發者,則需對 jMaki widget 的元件檔做一些小修改,讓它能善用 JSF 的元件狀態管理系統,並正確轉換 Dynamic Faces 所需的標頭。

Dynamic Faces 團隊已完成三個 widget 的轉換:script.aculo.us in-place editor、Dojo fisheye、Dojo inline-editor。除了轉換 fisheye,團隊也修改了 jMaki API,讓 widget 能觸發 JSF 的值變更事件:

<a:ajax name="dojo.fisheye"
  value="#{fishEyeBean.selectedIndex}"
  valueChangeListener="#{fishEyeBean.valueChanged}"
  args="{items:[
    {iconSrc:'images/150x126_jalopy.jpg', caption:'Jalopy',  index:0},
    {iconSrc:'images/150x126_luxury.jpg', caption:'Luxury',  index:1},
    {iconSrc:'images/150x126_roadster.jpg',caption:'Roadster',index:2},
    {iconSrc:'images/150x126_suv.jpg',    caption:'SUV',     index:3}
  ]}"
/>

兩個團隊正積極確保所有 jMaki widget 都能支援 Dynamic Faces。

從網頁開發者的角度看

我們把 jMaki 的 script.aculo.us in-place editor 放進一個 JSF 資料表元件中,讓使用者可以直接編輯表格裡某個儲存格的值。首先在 JSP 中宣告需要的標籤庫:

<%@taglib prefix="f"      uri="https://java.sun.com/jsf/core"%>
<%@taglib prefix="h"      uri="https://java.sun.com/jsf/html"%>
<%@taglib prefix="jsfExt" uri="https://java.sun.com/jsf/extensions/dynafaces"%>
<%@taglib prefix="a"      uri="https://java.sun.com/jmaki-jsf" %>

接著加上 <jsfExt:scripts /> 標籤,它會輸出 Dynamic Faces 所需的 <script> 元素:

<f:view>
<html>
<head>
  <title>Table with jMaki</title>
  <jsfExt:scripts />
</head>
<body>

最後,透過一個指定 jMaki in-place editor 的 ajax 標籤,把 widget 放進表格的 Customer Name 欄:

<h:form>
  <h:dataTable rows="10"
    binding="#{ResultSetBean.data}"
    value="#{ResultSetBean.list}"
    var="customer">
    <h:column>
      <f:facet name="header">
        <h:outputText value="Account Id"/>
      </f:facet>
      <h:outputText id="accountId" value="#{customer.accountId}"/>
    </h:column>

    <h:column>
      <f:facet name="header">
        <h:outputText value="Customer Name"/>
      </f:facet>
      <a:ajax name="scriptaculous.inplace"
        value="#{customer.name}"/>
    </h:column>
  </h:dataTable>
</h:form>
</body>
</html>
</f:view>

初始畫面如下:


圖 3 使用者修改儲存格之前

當使用者點擊 Customer Name 欄中某個儲存格的連結:


圖 4 點擊 Customer Name 欄的連結之後

此時,客戶姓名元素被換成一個輸入元件、一個 OK 按鈕與一個 Cancel 連結,讓使用者得以編輯現值。若按下 Cancel,該儲存格會還原為原值;若輸入新值並按 OK,新值會以 Ajax 送到伺服器、更新模型,然後該儲存格被重新渲染。


圖 5 提交新值後,網頁顯示更新後的內容

結論

Project Dynamic Faces 提供了一條靈活而有效的方式,為既有 JSF 應用加上 Ajax 能力,且無須放棄 JSF 元件模型的任何優勢。在內建 JavaScript 庫、Ajax 實作與元件互動模式的幫助下,Ajax 化的門檻被壓得很低;而搭配 jMaki widget,還能進一步提升介面的表現力與彈性。

對仍在使用 JSF 1.x 年代的團隊而言,這套組合的意義在於:你不必在「沿用既有元件模型」與「導入 Ajax 體驗」之間二選一。ajaxZone 負責快速起步,fireAjaxTransaction 負責精細控制,jMaki 負責補上現成的視覺元件——三層各司其職。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved