Wicket のアーキテクチャ

WebApplication (アプリケーションのルート)
│
├── HomePage (WebPage)
│   ├── Label [wicket:id="pageTitle"]
│   ├── HeaderPanel (Panel) [wicket:id="header"]
│   │   ├── Label [wicket:id="siteName"]
│   │   └── BookmarkablePageLink [wicket:id="homeLink"]
│   ├── Form [wicket:id="searchForm"]
│   │   ├── TextField [wicket:id="query"]
│   │   └── Button [wicket:id="submitBtn"]
│   ├── ListView [wicket:id="itemList"]
│   │   ├── ListItem[0]
│   │   │   ├── Label [wicket:id="itemName"]
│   │   │   └── Label [wicket:id="itemPrice"]
│   │   ├── ListItem[1]
│   │   │   ├── Label [wicket:id="itemName"]
│   │   │   └── Label [wicket:id="itemPrice"]
│   │   └── ...
│   └── FooterPanel (Panel) [wicket:id="footer"]
│       └── Label [wicket:id="copyright"]
│
├── UserPage (WebPage)
│   └── ...
│
└── AdminPage (WebPage)
    └── ...

src/main/java/
  └── com/example/app/
      ├── HomePage.java          ← Java クラス
      ├── UserProfilePage.java   ← Java クラス
      └── HeaderPanel.java       ← Java クラス

src/main/resources/          (または src/main/java/ に直接)
  └── com/example/app/
      ├── HomePage.html          ← 対応する HTML
      ├── UserProfilePage.html   ← 対応する HTML
      └── HeaderPanel.html       ← 対応する HTML

import org.apache.wicket.protocol.http.WebApplication;
import org.apache.wicket.markup.html.WebPage;
import org.apache.wicket.RuntimeConfigurationType;

public class WicketApplication extends WebApplication {

    /**
     * ホームページのクラスを返す（必須）。
     * ルートURL "/" にアクセスしたときにこのページが表示される。
     */
    @Override
    public Class<? extends WebPage> getHomePage() {
        return HomePage.class;
    }

    /**
     * アプリケーションの初期化処理。
     * サーバー起動時に一度だけ呼ばれる。
     */
    @Override
    public void init() {
        super.init();

        // URLマウント: /user/profile でアクセス可能にする
        mountPage("/user/profile", UserProfilePage.class);
        mountPage("/products/${productId}", ProductDetailPage.class);
        mountPage("/about", AboutPage.class);

        // 開発モード時のデバッグ設定
        if (getConfigurationType() == RuntimeConfigurationType.DEVELOPMENT) {
            getDebugSettings().setDevelopmentUtilitiesEnabled(true);
        }

        // マークアップ設定
        getMarkupSettings().setStripWicketTags(true);
        getMarkupSettings().setDefaultMarkupEncoding("UTF-8");

        // セキュリティ設定: CSP (Content Security Policy)
        getCspSettings().blocking().disabled();

        // ページストアの設定（後述）
        setPageManagerProvider(new DefaultPageManagerProvider(this) {
            @Override
            protected IPageStore newPersistentStore() {
                return new DiskPageStore(
                    getApplicationName(),
                    getStoreSettings().getFileStoreFolder(),
                    getStoreSettings().getMaxSizePerSession()
                );
            }
        });
    }
}

<filter>
    <filter-name>wicket</filter-name>
    <filter-class>org.apache.wicket.protocol.http.WicketFilter</filter-class>
    <init-param>
        <param-name>applicationClassName</param-name>
        <param-value>com.example.app.WicketApplication</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>wicket</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

Browser                 WicketFilter          RequestCycle           Page
  │                         │                      │                  │
  │── HTTP Request ────────▶│                      │                  │
  │                         │── create ───────────▶│                  │
  │                         │                      │── resolve ──────▶│
  │                         │                      │                  │
  │                         │                      │── processEvent ─▶│
  │                         │                      │   (onClick等)    │
  │                         │                      │                  │
  │                         │                      │── render ───────▶│
  │                         │                      │◀── HTML ─────────│
  │                         │                      │                  │
  │                         │                      │── serialize ────▶│
  │                         │                      │   (PageStore)    │
  │                         │◀─ response ──────────│                  │
  │◀── HTML Response ───────│                      │                  │

public class MyRequestCycleListener
        extends AbstractRequestCycleListener {

    @Override
    public void onBeginRequest(RequestCycle cycle) {
        // リクエスト開始時の処理（ログ記録など）
        long startTime = System.currentTimeMillis();
        cycle.setMetaData(START_TIME_KEY, startTime);
    }

    @Override
    public void onEndRequest(RequestCycle cycle) {
        // リクエスト終了時の処理（処理時間の計測など）
        Long startTime = cycle.getMetaData(START_TIME_KEY);
        if (startTime != null) {
            long duration = System.currentTimeMillis() - startTime;
            log.info("Request processed in {} ms", duration);
        }
    }

    @Override
    public IRequestHandler onException(
            RequestCycle cycle, Exception ex) {
        // 例外発生時のハンドリング
        log.error("Request failed", ex);
        return new RenderPageRequestHandler(
            new PageProvider(ErrorPage.class));
    }
}

操作の流れ:

1. ユーザーが HomePage にアクセス
   → PageStore に HomePage (version 0) が保存される
   → URL: /wicket/bookmarkable/com.example.HomePage

2. ユーザーがフォームを送信
   → PageStore に HomePage (version 1) が保存される
   → URL: /wicket/page?0-1.IFormSubmitListener-form

3. ユーザーがリンクをクリック
   → PageStore に HomePage (version 2) が保存される
   → URL: /wicket/page?0-2.ILinkListener-actionLink

4. ユーザーが「戻る」ボタンを押す
   → ブラウザが version 1 の URL をリクエスト
   → PageStore から version 1 が復元される
   → version 1 時点の正しい状態でページが表示される

@Override
public void init() {
    super.init();

    // ページストアのディスク保存先を設定
    getStoreSettings().setFileStoreFolder(
        new File("/var/wicket-pagestore")
    );

    // セッションあたりの最大サイズ (デフォルト: 10MB)
    getStoreSettings().setMaxSizePerSession(
        Bytes.megabytes(10)
    );
}

public class ShoppingCartPage extends WebPage {
    private List<Item> cartItems = new ArrayList<>();

    public ShoppingCartPage() {
        // カート内容の表示（ステートフル：cartItems が保持される）
        add(new ListView<Item>("items", cartItems) {
            @Override
            protected void populateItem(ListItem<Item> item) {
                item.add(new Label("name",
                    item.getModelObject().getName()));
                item.add(new Label("price",
                    item.getModelObject().getPrice()));

                // 削除リンク（コールバック → ステートフル）
                item.add(new Link<Void>("remove") {
                    @Override
                    public void onClick() {
                        cartItems.remove(item.getModelObject());
                    }
                });
            }
        });
    }
}

public class ProductListPage extends WebPage {

    public ProductListPage(PageParameters params) {
        // ステートレスにするには、すべてのコンポーネントを
        // ステートレスにする必要がある

        String category = params.get("category")
            .toString("all");

        // BookmarkablePageLink はステートレスなリンク
        add(new BookmarkablePageLink<Void>("homeLink",
            HomePage.class));

        // ステートレスフォーム
        StatelessForm<Void> form =
            new StatelessForm<Void>("searchForm") {
                @Override
                protected void onSubmit() {
                    // フォーム送信処理
                }
            };
        form.add(new TextField<String>("query",
            Model.of("")));
        add(form);

        // 外部リンクもステートレス
        add(new ExternalLink("wicketSite",
            "https://wicket.apache.org"));
    }

    /**
     * このページがステートレスであることを明示的に宣言。
     * すべてのコンポーネントがステートレスでないと
     * 実行時に警告が出る。
     */
    @Override
    protected void setStatelessHint(boolean isStateless) {
        super.setStatelessHint(true);
    }
}

// ステートレスリンク: 他のページへの遷移（URLがブックマーク可能）
// URL 例: /wicket/bookmarkable/com.example.ProductPage?id=42
PageParameters params = new PageParameters();
params.add("id", 42);
add(new BookmarkablePageLink<Void>("productLink",
    ProductPage.class, params));

// ステートフルリンク: コールバック（URLがセッション依存）
// URL 例: /wicket/page?3-1.ILinkListener-deleteLink
add(new Link<Void>("deleteLink") {
    @Override
    public void onClick() {
        // サーバーサイドのロジックを実行
        productService.delete(productId);
        setResponsePage(ProductListPage.class);
    }
});

// Wicket 9 以前 (Java EE / javax 名前空間)
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import javax.servlet.FilterConfig;

// Wicket 10 (Jakarta EE / jakarta 名前空間)
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import jakarta.servlet.FilterConfig;

<html xmlns:wicket="http://wicket.apache.org">
<head>
    <title>My Wicket Page</title>
</head>
<body>
    <!-- wicket:id 属性でコンポーネントを紐付け -->
    <h1 wicket:id="title">Page Title</h1>

    <!-- wicket:enclosure で条件付き表示 -->
    <wicket:enclosure child="errorMessage">
        <div class="error">
            <span wicket:id="errorMessage">Error</span>
        </div>
    </wicket:enclosure>

    <!-- wicket:container は出力されないコンテナ -->
    <wicket:container wicket:id="conditionalBlock">
        <p>This block is conditionally visible.</p>
    </wicket:container>

    <!-- wicket:message で国際化メッセージ -->
    <span wicket:id="greeting">
        <wicket:message key="greeting.text">
            Default greeting
        </wicket:message>
    </span>

    <!-- wicket:child / wicket:extend でテンプレート継承 -->
</body>
</html>