※ 本章は「UI制御編（実務向け UI 出し分け・エラー表示制御・再利用設計）」シリーズとなります

Struts2での画面制御において、「誰に」「いつ」「何を」表示するかの出し分けは、実務では欠かせないUIパターンです。

本記事では、ログイン状態や権限、パラメータやActionの状態によって画面要素を出し分けるための代表的な手法を、OGNL式やStruts2タグを活用しながら紹介します。

🎯 1. はじめに：UI出し分けの必要性

多くの業務システムでは、以下のようなUI出し分けが必要になります：

Struts2では、OGNL式 + <s:if> / <s:else>タグ を組み合わせることで、これらのUI出し分けが柔軟に実現できます。

💡 2. ログイン状態・ユーザー情報による表示制御

セッション情報に格納されている user_id や user_role を使って、表示内容を切り替えるのが基本です。

<%-- 管理者のみ表示 --%>
<s:if test="#session.user_role == 'admin'">
  <s:submit value="削除する" />
</s:if>

#session.プロパティ名 の形式でアクセスできます。

URLパラメータやフォームパラメータで出し分けたいときは、#parameters を使います。

<%-- URLパラメータ「mode=edit」のときのみ表示 --%>
<s:if test="#parameters.mode[0] == 'edit'">
  <p>編集中の内容が表示されます。</p>
</s:if>

#parameters.パラメータ名[0] で、値を取得可能です。

Actionクラス内に「表示フラグ用のプロパティ」を定義して、JSP側で使う方法も実務で多用されます。

Actionクラス側：

private boolean showSubmitButton;

public boolean isShowSubmitButton() {
    return showSubmitButton;
}

JSP側：

<s:if test="showSubmitButton">
  <s:submit value="送信する" />
</s:if>

フラグの切り替えをAction側に寄せることで、JSP側のロジックを簡潔に保てます。

OGNLでは、複数の条件を組み合わせた評価式も使用可能です。

<s:if test="#session.user_role == 'admin' && editMode == true">
  <s:submit value="管理者編集モードで保存" />
</s:if>

条件が複雑になる場合は、見通しを重視して Action 側に切り出す のも良いアプローチです。

UI制御の条件が増えすぎた場合は、以下のようなリファクタリングがおすすめです：

Struts2では、OGNL式や <s:if> タグを活用することで、状態に応じた柔軟なUI出し分けが可能です。

実務でのUI制御は「表示対象」「表示条件」「表示タイミング」の3軸で設計することで、わかりやすく保守しやすいコードになります。

📘 次回は Vol.8.x の総まとめ or 実務での「共通処理部品化」事例を予定しています。