決定網頁上哪些元件要支援 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 為網頁開發者提供了一種簡單、熟悉而直觀的入門方式。在最簡單的案例中它就已足夠;同時它也支援許多能進一步微調行為的屬性,完整清單可查閱官方文件。
若你想對 Ajax 相關的任務進行更細緻的控制,可以使用 Dynamic Faces 提供的內建 JavaScript 庫。透過在既有元件標籤中適當地使用 DynaFaces.fireAjaxTransaction,你就能對「哪些元件以什麼方式被非同步更新」取得元件層級的掌控權。
例如,你希望網頁上某些元件對 onclick 這類事件回應,另一些元件則對別的事件回應;而且每個觸發 Ajax 請求的元件,都該引起元件樹的不同部分被更新。這就需要 fireAjaxTransaction。
使用步驟是:
onclick。DynaFaces.fireAjaxTransaction 函式呼叫。以下是一個 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>
當使用者在輸入框打字並按下按鈕,會發生三件事:
DynaFaces.fireAjaxTransaction 執行,Dynamic Faces 向伺服器發出 Ajax 請求。呼叫時的 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。
到目前為止,我們談的都是如何重新渲染既有的 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 負責補上現成的視覺元件——三層各司其職。