第十一戒: モデルの真理 〜 IModel こそ Wicket の魂なり

モデル（IModel）は Wicket の心臓部です。 コンポーネントとデータを結びつける抽象層であり、 Wicket のコンポーネントが動的なデータを表示・編集するための仕組みです。 モデルを正しく理解することが、Wicket を使いこなす鍵です。

モデルとは

IModel<T> は、コンポーネントが表示するデータを取得・設定するためのインターフェースです。 コンポーネントは直接データを保持するのではなく、モデルを介してデータにアクセスします。

public interface IModel<T> extends IDetachable {
    T getObject();             // データを取得
    void setObject(T object);  // データを設定
    void detach();             // リクエスト終了時にリソースを解放
}

なぜモデルが必要なのか

モデルを使わず直接値を渡すこともできますが、以下の問題があります：

// 悪い例: 値が固定されてしまう
add(new Label("name", user.getName()));
// user.setName("新しい名前") しても Label は更新されない！

// 良い例: モデルを使うと常に最新値が表示される
add(new Label("name", new PropertyModel<>(user, "name")));
// user.setName("新しい名前") すると Label の表示も変わる

モデルの利点：

• 動的データ: 描画のたびに最新のデータを取得できる
• 双方向バインディング: フォームでの値の読み書きが自動的に行われる
• 遅延読み込み: データが必要になるまでDBアクセスを遅延できる
• メモリ効率: detach() でリクエスト間のメモリ使用量を削減できる

Model.of() - 静的モデル

Model.of() は、固定値を保持するシンプルなモデルを作成します。 値が変更されない場合や、初期値として使う場合に適しています。

// 文字列の静的モデル
IModel<String> nameModel = Model.of("田中太郎");
add(new Label("name", nameModel));

// フォームの入力値を保持するモデル
IModel<String> inputModel = Model.of("");
form.add(new TextField<>("input", inputModel));
// フォーム送信後: inputModel.getObject() で入力値を取得

// 数値の静的モデル
IModel<Integer> countModel = Model.of(0);
add(new Label("count", countModel));

ラムダ式でのモデル（読み取り専用）

IModel は関数型インターフェースなので、ラムダ式で読み取り専用モデルを作成できます。

// ラムダ式による読み取り専用モデル
add(new Label("currentTime",
    () -> LocalDateTime.now().toString()));

// 別のモデルの値を変換
add(new Label("nameUpper",
    () -> user.getName().toUpperCase()));

PropertyModel

PropertyModel は、オブジェクトのプロパティ（getter/setter）にアクセスするモデルです。 プロパティ名を文字列で指定します。

User user = new User("田中太郎", "[email protected]");

// user.getName() / user.setName() にアクセス
add(new Label("name", new PropertyModel<>(user, "name")));

// user.getEmail() / user.setEmail() にアクセス
add(new TextField<>("email", new PropertyModel<>(user, "email")));

// ネストしたプロパティにもアクセス可能（ドット表記）
add(new Label("city", new PropertyModel<>(user, "address.city")));
// → user.getAddress().getCity() を呼び出す

CompoundPropertyModel

CompoundPropertyModel は、コンポーネントの wicket:id を そのままプロパティ名として使うモデルです。 フォームの各フィールドに個別にモデルを設定する手間を省けます。

public class UserEditPage extends WebPage {
    public UserEditPage() {
        User user = new User();

        Form<User> form = new Form<>("form",
            new CompoundPropertyModel<>(user));
        add(form);

        // wicket:id がそのままプロパティ名として使われる
        form.add(new TextField<>("name"));       // → user.getName()
        form.add(new TextField<>("email"));      // → user.getEmail()
        form.add(new TextField<>("age"));        // → user.getAge()
        form.add(new TextArea<>("bio"));         // → user.getBio()
    }
}

CompoundPropertyModel を使わない場合、各フィールドに個別にモデルを設定する必要があります：

// CompoundPropertyModel を使わない場合（冗長）
form.add(new TextField<>("name", new PropertyModel<>(user, "name")));
form.add(new TextField<>("email", new PropertyModel<>(user, "email")));
form.add(new TextField<>("age", new PropertyModel<>(user, "age")));
form.add(new TextArea<>("bio", new PropertyModel<>(user, "bio")));

LambdaModel

LambdaModel は、getter と setter をラムダ式で指定する型安全なモデルです。 PropertyModel の文字列ベースのプロパティ指定を避けられます。

// 読み書き両方のモデル
IModel<String> nameModel = LambdaModel.of(
    user::getName,      // getter
    user::setName       // setter
);
form.add(new TextField<>("name", nameModel));

// 読み取り専用モデル
IModel<String> displayModel = LambdaModel.of(user::getFullName);
add(new Label("fullName", displayModel));

PropertyModel との比較：

LoadableDetachableModel

LoadableDetachableModel（LDM）は、データの遅延読み込みとメモリ効率の最適化を行うモデルです。 DB からのデータ取得に最適です。

LDM の動作：

1. 最初に getObject() が呼ばれた時に load() を実行してデータを取得
2. 同一リクエスト内では load() の結果をキャッシュして再利用
3. リクエスト終了時に detach() でキャッシュをクリア（メモリ解放）
4. 次のリクエストで再び load() を実行して最新データを取得

// DB からユーザーリストを取得する LDM
IModel<List<User>> usersModel =
    new LoadableDetachableModel<>() {
        @Override
        protected List<User> load() {
            // リクエストごとに1回だけ実行される
            return userRepository.findAll();
        }
    };

add(new ListView<>("users", usersModel) {
    @Override
    protected void populateItem(ListItem<User> item) {
        item.add(new Label("name", item.getModelObject().getName()));
    }
});

IDベースの LDM

エンティティの ID だけをセッションに保存し、必要な時に DB から再取得するパターンです。 セッションのメモリ使用量を最小限に抑えられます。

public class UserModel extends LoadableDetachableModel<User> {
    private final Long userId;

    public UserModel(Long userId) {
        this.userId = userId;
    }

    @Override
    protected User load() {
        // ID からエンティティを再取得
        return userRepository.findById(userId);
    }
}

// 使い方
add(new Label("userName",
    new PropertyModel<>(new UserModel(userId), "name")));

リスト用モデル

// リストのモデル
IModel<List<String>> listModel = Model.ofList(
    Arrays.asList("りんご", "みかん", "ぶどう"));

// Set のモデル
IModel<Set<String>> setModel = Model.ofSet(
    new HashSet<>(Arrays.asList("A", "B", "C")));

// Map のモデル
IModel<Map<String, Integer>> mapModel = Model.ofMap(
    new HashMap<>());

モデルの連鎖（Model Chaining）

モデルを連鎖させて、値の変換やフィルタリングを行うことができます。 IModel.map() メソッドを使います。

IModel<User> userModel = Model.of(user);

// ユーザー名を大文字に変換するモデル
IModel<String> upperNameModel = userModel
    .map(User::getName)
    .map(String::toUpperCase);

add(new Label("name", upperNameModel));

// 条件付きの表示テキスト
IModel<String> statusModel = userModel
    .map(u -> u.isActive() ? "有効" : "無効");
add(new Label("status", statusModel));

モデルの使い分け