這是第一個 DWR 範例,目標很小也很好懂:在輸入框打字,按下送出,回覆區就顯示「Hello, 你的輸入」。整個過程不換頁、不重載。
點擊「發送」按鈕觸發 onclick,呼叫 update():
function update() {
var name = dwr.util.getValue("demoName");
Demo.sayHello(name, loadinfo);
}
dwr.util.getValue() 是 DWR 提供的工具函式,用來取得任何元素的內容——這裡是一個輸入框,但實際上 div、select 也都能用。取到值之後,把它和一個回呼函式一起交給 Demo.sayHello()。
關鍵在於 DWR 走的是異步模式:等待 HTTP 回應的期間不會凍住瀏覽器畫面,所以我們必須先把「回來之後要做什麼」一起送過去。這也是為什麼 loadinfo 這個函式名稱會當成參數傳入——呼叫的當下它必須已經存在。
DWR 會去呼叫 Java 端的 Demo.sayHello():
public String sayHello(String name) {
return "Hello, " + name;
}
方法回傳後,DWR 自動呼叫 loadinfo() 並把結果交給它:
function loadinfo(data) {
dwr.util.setValue("demoReply", data);
}
dwr.util.setValue() 同樣很實用:它會依你給的元素 id,判斷該用哪種 HTML 標籤來呈現第二個參數的內容,省掉一堆手動操作 DOM 的麻煩。
如果回傳的內容不長,把兩個函式合併成一個匿名回呼更乾脆:
function update() {
var name = dwr.util.getValue("demoName");
Demo.sayHello(name, function (data) {
dwr.util.setValue("demoReply", data);
});
}
這種寫法在處理十行以內的短字串時特別俐落,範例中後續也都會採用這個形式。