Wicket 是 Java Web 開發框架之一,採元件導向設計,並以純 HTML 模板搭配 Java 頁面類別的方式建立動態網頁。本文將說明如何透過 web.xml 設定 Wicket 應用程式,並涵蓋生命週期、自訂元件、驗證、Ajax、I18N 與單元測試。
Wicket 建構在 Servlet API 之上,但與傳統 MVC 框架不同,它讓開發者能從請求與回應物件的細節中抽離,專注於頁面與元件的行為設計。開發者通常會建立頁面,在頁面上放置元件,並定義每個元件如何回應使用者輸入。
在 Wicket 中建立動態頁面,通常需要兩個主要工件:HTML 模板與 Java 頁面類別。兩者的名稱通常相同,且必須位於相同位置,例如 HelloWorld.html 與 HelloWorld.java。
HTML 模板中可使用 wicket:id 標記動態元件:
<html>
<body>
<h1>
<span wicket:id="message">Hello World Using Wicket!</span>
</h1>
</body>
</html>Java 頁面類別則會加入對應的 Label 元件,其 ID 必須與模板中的 wicket:id 相符。
public class HelloWorld extends WebPage {
public HelloWorld() {
add(new Label("message", "Hello World using Wicket!!"));
}
}此外,還需要建立 Application 物件,作為應用程式載入時的起點。可透過覆寫 getHomePage() 指定首頁。
若要讓 Wicket 應用程式可被 Web 容器載入,需要在 web.xml 中定義 WicketServlet,並以參數形式傳入應用程式類別名稱。

<?xml version="1.0" encoding="UTF-8"?>
<web-app>
<display-name>Wicket Hello World Example</display-name>
<servlet>
<servlet-name>HelloWorldApplication</servlet-name>
<servlet-class>wicket.protocol.http.WicketServlet</servlet-class>
<init-param>
<param-name>applicationClassName</param-name>
<param-value>myPackage.HelloWorldApplication</param-value>
</init-param>
</servlet>
<servlet-mapping>
<servlet-name>HelloWorldApplication</servlet-name>
<url-pattern>/hello/*</url-pattern>
</servlet-mapping>
</web-app>部署後,可透過類似 https://localhost:8090/sample/hello/ 的網址存取應用程式。
Wicket 生命週期大致包含三個階段:應用程式載入、請求處理與呈現。
當容器載入 web.xml 中定義的 WicketServlet 後,Wicket 會建立 Application 類別的執行個體。applicationClassName 參數必須是繼承 WebApplication 的類別完整名稱。
應用程式類別載入後,若沒有既有工作階段,Wicket 會建立工作階段,並用它建立 RequestCycle 物件來處理請求。請求周期會依序進行請求解析、事件處理與回應產生。

請求周期處理器負責解析請求目標、處理事件、建立回應,以及在必要時產生例外回應。
頁面會透過與之相關的標記文件呈現自身。Wicket 會遍歷標記流,依 ID 找出對應元件,並呼叫元件的呈現方法。若元件不可見,則不會輸出內容。
Wicket 提供 Panel 等基底類別,方便開發可重複使用的自訂元件,例如頁首、頁尾與導覽列。

以下以 Footer 元件為例。它通常包含 HTML 模板與 Java 類別,並可加入年份等動態內容。

<wicket:panel>
<hr>
Copyright <span wicket:id="year">2008</span>. IBM Inc. All rights reserved.
</wicket:panel>對應的 Java 類別可繼承 Panel,並加入 Label 元件:
public final class Footer extends Panel {
public Footer(String id) {
super(id);
add(new Label("year", "" + new GregorianCalendar().get(GregorianCalendar.YEAR)));
}
}使用時,只需在頁面類別中將 Footer 加入,並在 HTML 模板中以對應的 wicket:id 呈現。
Wicket 支援客戶端與伺服器端表單驗證。內建驗證器包括 NumberValidator、StringValidator、PatternValidator、DateValidator 與 RequiredValidator 等。若內建驗證器無法滿足需求,也可以建立自訂驗證器。
伺服器端驗證時,Wicket 會遍歷表單中的元件,執行關聯驗證器。若驗證失敗,FeedbackPanel 元件可顯示收集到的錯誤訊息。
例如,可將文字欄位設為必填:
TextField firstNameComp = new TextField("firstName");
firstNameComp.setRequired(true);並將 FeedbackPanel 加入頁面與模板:
add(new FeedbackPanel("feedback"));<span wicket:id="feedback"></span>Wicket 可與 Ajax 結合,讓頁面只更新部分內容,而不必重新載入整個頁面。Wicket 會在伺服器端呈現元件,並將需要更新的內容送回瀏覽器。

以自動完成為例,當使用者輸入文字時,Wicket 可透過 Ajax 行為提供可能的選項。

此類行為通常會擴展 AutoCompleteBehaviour 或相關 Ajax 元件,並依輸入內容傳回候選清單。
Wicket 可透過特定地區設定屬性檔提供國際化支援。開發者可利用 StringResourceModel 類別,或在 HTML 模板中使用 wicket:message 標籤,讀取對應語系的消息。
<wicket:message key="first-name">First Name</wicket:message>Wicket 會依元件層次結構與應用程式名稱,依序搜尋資源檔,直到找到對應消息為止。

Wicket 提供容器外單元測試支援,讓開發者可在不啟動完整 Java EE 容器的情況下測試頁面。其 WicketTester 類別可模擬頁面呈現、元件存在、連結點擊與表單提交等行為。
例如,可測試頁面是否能正確呈現:
WicketTester tester = new WicketTester();
tester.startPage(MyPage.class);
tester.assertRenderedPage(MyPage.class);也可測試表單提交:
FormTester ft = tester.newFormTester("myForm");
ft.setValue("firstName", "Kumar");
ft.setValue("lastName", "Nadar");
ft.submit("Submit");
tester.assertRenderedPage(Welcome.class);Wicket 以元件與頁面為中心,讓 HTML 模板保持相對純淨,也方便設計人員與開發人員分工。透過 web.xml 設定、生命週期理解、自訂元件、驗證、Ajax、I18N 與單元測試,開發者可以建立結構清楚且易於維護的動態 Web 應用程式。