DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> JavaScript入門知識 >> AJAX入門 >> AJAX詳解
給 Java 開發者的 Ajax 入門:動手做一個 Google Web Toolkit 應用程式
編輯:AJAX詳解     

Google Web Toolkit(GWT)走的是一條與眾不同的路。它不像一般做法那樣把客戶端與伺服器端程式碼分成兩個各自獨立的程式碼庫,而是提供一套 Java API 讓你以元件化的方式建立 GUI,再把它編譯成能在瀏覽器執行的程式碼。整體開發體驗更接近用 Swing 或 SWT 寫桌面應用,而 HTTP 協定與 HTML DOM 模型則被盡量抽象掉了。

GWT 靠的是程式碼產生:編譯器把客戶端的 Java 程式碼轉成 JavaScript。它支援 java.lang 與 java.util 的子集,加上 GWT 自身的 API。編譯後的產物由 HTML、XML 與 JavaScript 片段組成,但這些片段高度交織、難以人工閱讀,最好把它當成一個黑盒子——Java 位元碼的 GWT 對等物。

本文將一步步做出一個簡單的 GWT 應用程式:從遠端 Web API 取得天氣報告並顯示在瀏覽器中。過程中會盡量觸及 GWT 的各項特性,也順帶指出可能遇到的問題。

從最簡單的開始

以下是用 GWT 能寫出的最短程式:

public class Simple implements EntryPoint {
    public void onModuleLoad() {
        final Button button = new Button("Say 'Hello'");
        button.addClickListener(new ClickListener() {
            public void onClick(Widget sender) {
                Window.alert("Hello World!");
            }
        });
        RootPanel.get().add(button);
    }
}

這段程式碼看起來就像 Swing、AWT 或 SWT 寫出來的 GUI 程式。它建立了一個按鈕,點下去會跳出「Hello World!」,並把按鈕掛到 RootPanel 上——那是包在 HTML 頁面 body 外的一層 GWT 包裝物件。GWT Shell 是隨 SDK 附贈的除錯宿主環境,內建一個簡化版瀏覽器,可以直接在裡面執行與觀察。

建立 Weather Reporter

接下來要做的應用程式,其 GUI 提供一個輸入郵遞區號的欄位,以及選擇攝氏或華氏的選項。使用者按下 Submit 後,程式會呼叫 Yahoo! 的免費天氣 API 取得 RSS 報告,從中取出 HTML 段落並顯示出來。

GWT 應用程式被打包成「模組」,必須符合特定結構:名為 module-name.gwt.xml 的設定檔定義入口點類別,並宣告是否繼承其他模組的資源。原始碼結構中,設定檔要放在與 client 套件及 public 目錄同一層;所有客戶端 Java 程式碼放在 client 套件,public 目錄則放圖片、CSS、HTML 等網頁資源,並必須包含一個帶有模組完整名稱 meta 標記的 HTML 檔,GWT 執行期函式庫靠它來初始化應用程式。

指定入口點類別後,GWT 的 applicationCreator 就能幫你把整個骨架生出來:

applicationCreator developerworks.gwt.weather.client.Weather

隨附的 Ant 建置檔中有幾個好用的 target,可以讓專案維持在這個結構上。

先排版面

Widget 幾乎是所有可呈現於 GWT UI 的類別之超類,而 Widget 總是被包在 Panel 裡——Panel 本身也是 Widget,所以能任意巢狀。不同 Panel 提供不同排版行為,角色近似 AWT/Swing 的 LayoutManager 或 XUL 的 Box。

所有 Widget 最終都要掛到頁面上。可以直接掛到 RootPanel,也可以用 RootPanel.get() 取得以 id 或 class 標記的 HTML 元素。本例使用兩個獨立的 DIV:input-container 放 UI 控件,output-container 放天氣報告。

public void onModuleLoad() {
    HorizontalPanel inputPanel = new HorizontalPanel();
    inputPanel.setVerticalAlignment(HasVerticalAlignment.ALIGN_MIDDLE);

    inputPanel.add(new Label("5-digit zipcode: "));

    TextBox txBox = new TextBox();
    txBox.setVisibleLength(20);
    inputPanel.add(txBox);

    // 攝氏/華氏的單選按鈕群組
    Panel radioPanel = new VerticalPanel();
    RadioButton ucRadio = new RadioButton("units", "Celsius");
    RadioButton ufRadio = new RadioButton("units", "Fahrenheit");
    ucRadio.setChecked(true);          // 預設攝氏
    radioPanel.add(ucRadio);
    radioPanel.add(ufRadio);
    inputPanel.add(radioPanel);

    Button btn = new Button("Submit");
    inputPanel.add(btn);
    inputPanel.setCellVerticalAlignment(btn, HasVerticalAlignment.ALIGN_BOTTOM);

    RootPanel.get("input-container").add(inputPanel);

    // 來自 Yahoo! 的 HTML 輸出會顯示在這裡
    HTML weatherHtml = new HTML();
    RootPanel.get("output-container").add(weatherHtml);
}

用 CSS 上妝

預設樣式實在不好看,所以要靠 CSS 救一下。GWT 可以用兩種方式套用樣式。

第一種:每個 Widget 預設都有一個形如 project-widget 的 CSS 類別名,例如 gwt-Button、gwt-RadioButton。Panel 通常被實作成好幾層巢狀表格,因此沒有預設類別名。這種「一類別一控件類型」的設計,讓全站風格一致變得非常容易;當然一般 CSS 選擇器規則也照樣適用,能依上下文對同一控件套不同樣式。

第二種:呼叫 Widget 的 setStyleName() 與 addStyleName(),暫時替換或追加類別名,取得更大彈性。

/* 輸入面板本身 */
.weather-input-panel {
    background-color: #AACCFF;
    border: 2px solid #3366CC;
    font-weight: bold;
}
/* 面板內所有元素的內距 */
.weather-input-panel * { padding: 3px; }
/* 覆寫按鈕預設樣式 */
.gwt-Button {
    background-color: #3366CC;
    color: white;
    font-weight: bold;
    border: 1px solid #AACCFF;
}
/* 滑鼠移入的效果 */
.gwt-Button:hover { background-color: #FF0084; }

加上客戶端行為

版面與樣式就緒後,接著實作行為。GWT 採用大家熟悉的 listener 模式:它為滑鼠、鍵盤、修改等事件提供了 Listener 介面,並附上幾個 adapter 與 helper 類別方便使用。

一般會用 Swing 開發者熟悉的內部類形式掛上 listener。特別的是,所有 GWT Listener 方法的第一個參數都是事件的發送者,也就是使用者剛互動的那個 Widget。這意味著同一個 Listener 實例可以掛在多個 Widget 上,再用 sender 參數判斷是哪一個觸發的。

// Submit 按鈕掛 click listener
Button btn = new Button("Submit", new ClickListener() {
    public void onClick(Widget sender) {
        validateAndSubmit();
    }
});

// 在 TextBox 中按 Enter 也送出,提升可用性
txBox.addKeyboardListener(new KeyboardListenerAdapter() {
    public void onKeyPress(Widget sender, char keyCode, int modifiers) {
        if ((keyCode == 13) && (modifiers == 0)) {
            validateAndSubmit();
        }
    }
});

驗證與送出的實作相當單純:

private void validateAndSubmit() {
    String zip = txBox.getText().trim();

    if (!zipValidator.isValid(zip)) {
        Window.alert("Zip-code must have 5 digits");
        return;
    }

    txBox.setEnabled(false);                  // 送出後鎖住輸入框
    boolean celsius = ucRadio.isChecked();
    fetchWeatherHtml(zip, celsius);
}

用 GWT Shell 除錯客戶端程式碼

這裡值得岔開提一下 GWT Shell:它內建 JVM 掛鉤,讓你能在 Java IDE 裡直接除錯客戶端程式碼。你可以與 Web UI 互動,逐步單步執行對應的 Java 程式——而那段 Java 最終會變成 JavaScript。這是極重要的能力,因為直接除錯編譯後的 JavaScript 幾乎是不可能的任務。

在 Eclipse 中只要設定一個透過 com.google.gwt.dev.GWTShell 啟動的除錯工作即可。

與伺服器端元件通訊

在一般 Ajax 開發中,你得直接從 JavaScript 呼叫伺服器資源,再接收 JSON 或 XML 格式的資料。GWT 把這一切藏在自己的遠端程序呼叫(RPC)機制背後。

用 GWT 的術語說,客戶端程式碼與執行在 Web 伺服器上的「服務」溝通。這套 RPC 機制的用法近似 Java RMI:你只需撰寫服務的伺服器端實作與兩個介面,程式碼產生與反射會負責處理客戶端 stub 與伺服器端 skeleton proxy。

GWT 可序列化型別速覽:

  • 基本型別(如 int)與其包裝類別(如 Integer)可序列化
  • String 與 Date 可序列化
  • 可序列化型別的陣列本身可序列化
  • 自訂類別若所有持久性成員皆可序列化,且實作了 GWT 的 IsSerializable 介面,即可序列化
  • Collection 類別可搭配 Javadoc 註解宣告其包含的可序列化型別

由於客戶端程式碼被限制在 GWT 實作的 Java 類別小子集上,這些可序列化型別的涵蓋範圍其實相當廣。

第一步是定義服務介面。它必須繼承 GWT 的 RemoteService,並宣告要開放給客戶端的服務方法簽章。因為 RPC 呼叫橫跨 JavaScript 與 Java,GWT 內建了物件序列化機制來協調跨語言的參數與回傳值。

public interface WeatherService extends RemoteService {
    /**
     * 回傳天氣的 HTML 描述
     * @param zip 郵遞區號
     * @param isCelsius true 為攝氏,false 為華氏
     */
    public String getWeatherHtml(String zip, boolean isCelsius) throws WeatherException;
}

public class YahooWeatherServiceImpl extends RemoteServiceServlet implements WeatherService {
    public String getWeatherHtml(String zip, boolean isCelsius) throws WeatherException {
        // 呼叫 Yahoo! 天氣 API,取出 RSS 中的 HTML 描述
        return null;
    }
}

伺服器端實作類別繼承 RemoteServiceServlet,它本身就是 HttpServlet 的具體實作,因此放進任何 servlet 容器都能運作。

這裡有個 GWT 特性值得注意:服務的遠端介面必須放在 client 套件中,因為它要被整合進 JavaScript 的產生流程。但伺服器端實作又引用了這個介面,於是伺服器與客戶端程式碼之間出現了一個 Java 編譯期相依項。我的解法是把遠端介面放在 client 底下的 common 子套件,建置時只納入 common 而不納入 client 其餘部分,確保只有需要轉成 JavaScript 的類別被打包。更理想的做法是把原始碼切成兩個目錄,分別放客戶端與伺服器端程式碼,共用類別則複製一份。

異步介面

接下來要脱離標準 RMI 的寫法了。因為來自 JavaScript 的 Ajax 呼叫是非同步的,所以必須額外定義一個異步介面給客戶端使用。GWT 靠的是「魔法般的命名巧合」:異步介面與遠端介面之間沒有編譯期的靜態關聯,純粹靠命名約定掛勾。

public interface WeatherServiceAsync {
    /**
     * 取得天氣 HTML,並交給回呼處理
     */
    public void getWeatherHtml(String zip, boolean isCelsius, AsyncCallback callback);
}

規則很簡單:介面取名為 MyServiceAsync,每個方法的簽章對應遠端介面的同名方法,刪掉回傳型別,最後多加一個型別為 AsyncCallback 的參數。異步介面必須與遠端介面放在同一套件。

AsyncCallback 有兩個方法:onSuccess() 與 onFailure()。呼叫成功時,服務的返回值會傳給 onSuccess();失敗時則呼叫 onFailure(),並傳入代表失敗原因的 Throwable。

從客戶端呼叫服務

有了這兩個介面,就能修改客戶端去呼叫服務了。第一步帶點公式化:透過 GWT.create(WeatherService.class) 取得 WeatherServiceAsync 實例,再把它轉型成 ServiceDefTarget,才能呼叫 setServiceEntryPoint() 指定遠端實作部署的 URL。

注意這裡的 URL 是編譯期硬編碼的。因為產物是部署到瀏覽器的 JavaScript,沒辦法在執行期從設定檔讀取這個值——這顯著降低了編譯後 GWT 應用程式的可攜性。

// 靜態設定 RPC 服務
private static WeatherServiceAsync ws =
    (WeatherServiceAsync) GWT.create(WeatherService.class);

static {
    ((ServiceDefTarget) ws).setServiceEntryPoint("ws");
}

/**
 * 非同步呼叫天氣服務並顯示結果
 */
private void fetchWeatherHtml(String zip, boolean isCelsius) {
    hideHtml();

    ws.getWeatherHtml(zip, isCelsius, new AsyncCallback() {
        public void onSuccess(Object result) {
            displayHtml((String) result);
        }

        public void onFailure(Throwable caught) {
            Window.alert("Error: " + caught.getMessage());
            txBox.setEnabled(true);
        }
    });
}

伺服器端驗證是必须的

用 GWT 把客戶端與伺服器端程式碼合併,藏著一個內在危險:因為全部都用 Java 撰寫,GWT 的抽象很容易讓人誤以為可以信任執行期的客戶端程式碼。這是錯的。跑在瀏覽器上的任何程式碼都可能被惡意使用者竄改或完全繞過。GWT 提供了高階的混淆,把風險降低了一些,但仍有破口:GWT 客戶端與其服務之間的 HTTP 流量。

用 Microsoft 的 Fiddler 攔下從客戶端發往 WeatherService 的請求後,你可以任意修改其中任何一段——例如把郵遞區號從「10001」改成「XXXXX」。如果伺服器端對它呼叫 Integer.parseInt(),就會丟出 NumberFormatException。在這個例子中頂多讓使用者看到錯誤訊息,但若換成訂單追蹤應用程式裡的客戶編號,同樣的手法就可能洩露出其他客戶的敏感財務資料;在資料庫查詢會使用到該值的地方,還有導致 SQL injection 的風險。

好消息是這個問題可以緩解:把客戶端用的 ZipCodeValidator 移進 client.common 套件,伺服器端就能重用同一份驗證邏輯。

public String getWeatherHtml(String zip, boolean isCelsius) throws WeatherException {
    if (!new ZipCodeValidator().isValid(zip)) {
        log.warn("Invalid zipcode: " + zip);
        throw new WeatherException("Zip-code must have 5 digits");
    }
    // ……後續邏輯
}

用 JSNI 呼叫原生 JavaScript

視覺效果庫在 Web 開發中越來越普遍。GWT 本身沒提供這類效果,但它的 JavaScript 原生介面(JSNI)正好補上這個缺口——它允許直接在 GWT 客戶端 Java 程式碼中寫 JavaScript 呼叫,於是可以借用 Scriptaculous 或 Yahoo! UI Library 的效果。

JSNI 巧妙地結合了 Java 的 native 關鍵字與嵌在特殊註解區塊中的 JavaScript。用範例最好懂:

/** 將 HTML 發佈到天氣顯示區 */
private void displayHtml(String html) {
    weatherHtml.setHTML(html);
    applyEffect(weatherHtml.getElement(), "Appear");
}

/**
 * 對指定元素套用 Scriptaculous 效果
 */
private native void applyEffect(Element element, String effectName) /*-{
    // 觸發同名的 Scriptaculous 效果
    $wnd.Effect[effectName](element);
}-*/;

對編譯器而言,它只看到 private native void applyEffect(Element element, String effectName);。GWT 會解析註解區塊,把內容逐字輸出成 JavaScript,並提供 $wnd 與 $doc 兩個變數分別代表 window 與 document 物件。範例中直接存取頂層的 Effect 物件,再用 JavaScript 的方括號存取語法呼叫呼叫方指定的函式。Element 是 GWT 提供的「魔法」型別,在 Java 與 JavaScript 兩邊都代表 Widget 底層的 HTML DOM 元素;String 則是能透過 JSNI 在兩側透明傳遞的少數型別之一。

接著要處理一件稍微複雜的事:效果播完後重新啟用輸入框。Scriptaculous 用非同步回呼把生命週期通知給 listener,所以必須透過回呼從 JavaScript 回到 GWT 的 Java 程式碼。由於 JavaScript 可用任意數量參數呼叫函式,沒有 Java 式的多載概念,JSNI 因此採用一套較繁瑣的語法來消除歧義:

[instance-expr.]@class-name::method-name(param-signature)(arguments)

instance-expr. 部分可省略,因為靜態方法呼叫不需要物件參考。實際寫法如下:

/**
 * 對元素套用 Scriptaculous 效果,效果結束後回呼 Java
 */
private native void applyEffect(Element element, String effectName) /*-{
    // 保留 this 的參照,供閉包內部使用
    var weather = this;

    $wnd.Effect[effectName](element, {
        afterFinish : function () {
            // 回呼 Weather 物件
            weather.@developerworks.gwt.weather.client.Weather::effectFinished()();
        }
    });
}-*/;

/** 效果結束時重新啟用輸入框 */
private void effectFinished() {
    this.txBox.setEnabled(true);
    this.txBox.setFocus(true);
}

這裡的關鍵是:區域變數 weather 保存了 this 的副本。依 JavaScript 的呼叫語意,afterFinish 函式中的 this 實際上是 Scriptaculous 的物件(因為是它呼叫這個函式的),所以必須在閉包之外先留一份參照。

順帶一提,把 Scriptaculous 整合進 GWT 更好的方式,是將這些效果包裝成自訂的 GWT Widget——Alexei Sokolov 的 GWT Component Library 就是這麼做的。

為什麼選 GWT?又為什麼不選?

GWT 應用程式顯然不太像傳統 Web 應用程式。它把瀏覽器當成輕量級 GUI 應用程式的執行期環境,因此用 GWT 開發更接近用 Morfik、OpenLaszlo 甚至 Flash,而不像一般 Web 開發。所以 GWT 最適合的是能作為單頁式 Rich Ajax GUI 存在的應用程式。

多數 Web 應用程式仍以「以頁面為中心」的模型最合適,而 Ajax 的價值在於讓你在需要的地方加入更豐富的互動。GWT 並不適合傳統的頁面導向應用:雖然可以把 GWT Widget 與普通 HTML 表單輸入並置,但 GWT Widget 的狀態與頁面其他部分是分離的。例如,沒有簡單的方法把 GWT Tree 中選取的值當成普通表單的一部分一起送出。

授權方面:GWT 的執行期函式庫採用 Apache License 2.0,可免費用於商業應用程式。但 GWT 工具鏈只以二進位形式提供且不允許修改,其中包含 Java-to-JavaScript 編譯器。這意味著產生的 JavaScript 若有任何錯誤,你都無從下手。特別值得一提的是 GWT 對使用者代理偵測的依賴:每有新瀏覽器問世,就得等工具鏈更新才能支援。

若要把 GWT 用在 J2EE 環境,整合難度並不高。GWT 服務應該被視為類似 Struts 中 Action 的東西——一個很薄的中間層,只負責代理對後端商業邏輯的呼叫。因為 GWT 服務就是 HTTP servlet,很容易放進 Struts 或 SpringMVC 的過濾器鏈中,例如掛在身份驗證過濾器之後。

GWT 有幾個相當顯眼的缺陷。首先是缺乏功能退化(graceful degradation)機制。現代 Web 開發的最佳实践是建立不依賴 JavaScript 也能運作的頁面,再用 JavaScript 逐步增強。在 GWT 中,若 JavaScript 不可用,你連 UI 都拿不到——對某些應用類型而言這完全不可接受。其次是國際化:因為客戶端 Java 類別在瀏覽器中執行,無法在執行期讀取資源達到本地化。目前得靠為每個地區建立客戶端類別的子類來繞過,工程師們正在開發更可行的方案。

關於程式碼產生這件事

GWT 架構中最具爭議的,就是在客戶端切換回 Java 語言。支持者認為用 Java 寫客戶端程式碼比寫 JavaScript 更好;反對者則不願為了 Java 那套繁重的開發流程,放棄 JavaScript 的靈活與表達力。

「用 Java 比較不容易出錯」這個論調其實相當靠不住。任何語言都能寫出糟糕的程式碼,市面上充滿 bug 的 Java 應用程式就是證明。離線語法檢查與編譯期型別驗證確實帶來一些好處,但 JavaScript 也有 Douglas Crockford 的 JSLint 可用。GWT 真正的優勢在單元測試——它能為客戶端程式碼提供 JUnit 整合,而這塊長期是 JavaScript 的弱項。

開發過程中我發現客戶端 Java 程式碼最實用的一點,是驗證類別能在客戶端與伺服器端兩層共用。跨 RPC 傳遞的任何類別都適用這招:只需寫一次,兩邊都能用,省下不少工時。

但抽象是有漏洞的。我在郵遞區號驗證器裡本想用正則表達式,結果 GWT 並未實作 String.match();即便實作了,GWT 對宿主環境底層正則機制的依賴,也讓同一段正則在客戶端與伺服器端可能出現語意差異。這是「不完美抽象」的典型例子。

GWT 另一個被看好的理由是它的 RPC 機制與 Java/JavaScript 之間的物件序列化,這確實省掉了大量樣板程式。但若你只想要這項能力、不想用 GWT 的其他部分,Direct Web Remoting(DWR)很值得考慮——它同樣在 Java 與 JavaScript 之間提供 RPC 與物件轉換。

對於 Ajax 開發中那些低層細節(跨瀏覽器不相容、DOM 事件模型、如何發出 Ajax 呼叫),GWT 抽象得相當好。但現代 JavaScript 工具庫(YUI、Dojo、MochiKit)都提供了同等級的抽象,而且不必求助於程式碼產生。更關鍵的是,這些工具庫都是開源的,你可以按需客製、遇 bug 自行修補——對黑盒子式的 GWT 而言這做不到。

結語

GWT 是一個功能完整的框架,提供了許多實用的能力,但它並非萬能,鎖定的只是 Web 應用程式市場中相對特定的一塊。希望這篇介紹能讓你對它的能力與限制有基本認識。GWT 未必能滿足每個人的需求,但無疑是一項重要的技術嘗試,在設計下一個 Ajax 應用程式時值得認真評估。它的廣度與深度遠超市面一般介紹所能涵蓋,建議再參考 Google 官方文件或參與 GWT 開發者論壇的討論。

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