第12章: ページ遷移

Wicket のページ遷移は、通常の Web フレームワークとは少し異なります。 ステートフルなページとブックマーク可能なページの概念を理解することが重要です。 この章では、ページ遷移の各種方法とURL マウントについて解説します。

ページ遷移の方法

setResponsePage

インスタンスを渡す方法（ステートフル）

ページのインスタンスを直接渡すと、そのインスタンスがレスポンスとして使われます。 コンストラクタでデータを渡したい場合に使います。

// Link の onClick 内で遷移
add(new Link<Void>("detailLink") {
    @Override
    public void onClick() {
        User user = getSelectedUser();
        setResponsePage(new UserDetailPage(user));
    }
});

// フォームの onSubmit 内で遷移
Form<Void> form = new Form<>("form") {
    @Override
    protected void onSubmit() {
        // 処理を実行してから遷移
        userService.save(user);
        setResponsePage(new UserListPage());
    }
};

クラスを渡す方法（ブックマーク可能）

ページクラスを渡すと、Wicket がそのクラスのデフォルトコンストラクタ（または PageParameters を受け取るコンストラクタ）を呼び出して新しいインスタンスを生成します。

// クラスだけを指定（デフォルトコンストラクタが呼ばれる）
setResponsePage(HomePage.class);

// パラメータ付きで遷移
PageParameters params = new PageParameters();
params.add("id", 42);
setResponsePage(UserDetailPage.class, params);

BookmarkablePageLink

BookmarkablePageLink は、ブックマーク可能な URL を生成するリンクコンポーネントです。 通常の <a href="..."> タグとして出力されます。

// 基本的な使い方
add(new BookmarkablePageLink<>("homeLink", HomePage.class));

// パラメータ付き
PageParameters params = new PageParameters();
params.add("id", userId);
add(new BookmarkablePageLink<>("userLink",
    UserDetailPage.class, params));

HTML:

<a wicket:id="homeLink">ホーム</a>
<a wicket:id="userLink">ユーザー詳細</a>

PageParameters

PageParameters は、URL パラメータをページに渡すためのクラスです。 ブックマーク可能なページでデータを受け渡す唯一の方法です。

パラメータの設定と取得

// パラメータの設定
PageParameters params = new PageParameters();
params.add("id", 42);
params.add("tab", "profile");
params.add("sort", "name");

// パラメータの取得（ページのコンストラクタで）
public UserDetailPage(PageParameters params) {
    Long id = params.get("id").toLong();
    String tab = params.get("tab").toString("info"); // デフォルト値付き
    String sort = params.get("sort").toOptionalString(); // null 可

    // パラメータが存在するかチェック
    if (params.get("id").isNull()) {
        throw new AbortWithHttpErrorCodeException(400);
    }
}

インデックスパラメータ

名前付きパラメータに加えて、インデックス（位置）ベースのパラメータも使えます。

// インデックスパラメータの設定
PageParameters params = new PageParameters();
params.set(0, "users");    // 1番目のパス要素
params.set(1, 42);          // 2番目のパス要素
// URL: /page/users/42

// インデックスパラメータの取得
String type = params.get(0).toString();
Long id = params.get(1).toLong();

マウント URL

デフォルトでは Wicket のブックマーク可能な URL は /wicket/bookmarkable/com.example.UserPage のような長い形式になります。mountPage() を使うと、 わかりやすい URL をページにマッピングできます。

// WicketApplication の init() で設定
@Override
public void init() {
    super.init();

    // 基本的なマウント
    mountPage("/users", UserListPage.class);
    mountPage("/about", AboutPage.class);

    // パラメータ付きマウント
    mountPage("/user/${id}", UserDetailPage.class);
    // URL: /user/42 → PageParameters で id=42 として取得

    // オプショナルパラメータ（#{} を使用）
    mountPage("/user/${id}/#{tab}", UserDetailPage.class);
    // URL: /user/42 も /user/42/profile も有効
}

マウントパターンの記法

リダイレクト

RestartResponseException

処理を即座に中断して別のページにリダイレクトしたい場合は RestartResponseException を使います。

// 認証チェック: 未ログインならログインページへリダイレクト
public SecurePage() {
    if (!isUserLoggedIn()) {
        throw new RestartResponseAtInterceptPageException(
            LoginPage.class);
    }
    // 通常の初期化処理...
}

// ログイン成功後、元のページに戻る
public void onLoginSuccess() {
    continueToOriginalDestination();
    // 元のページがない場合のフォールバック
    setResponsePage(HomePage.class);
}

ステートフル vs ステートレス

ページ遷移の方法によって、ページのステートフル/ステートレスが変わります。

エラーページ

Wicket では、エラーページもカスタマイズできます。

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

    // 404 Not Found ページ
    getApplicationSettings()
        .setPageExpiredErrorPage(PageExpiredPage.class);

    // 500 Internal Error ページ
    getApplicationSettings()
        .setInternalErrorPage(InternalErrorPage.class);

    // アクセス拒否ページ
    getApplicationSettings()
        .setAccessDeniedPage(AccessDeniedPage.class);
}

まとめ