logic:equalタグ

Struts 1のJSPで、指定した値が基準値と等しい場合だけ本文を表示するLogic Taglibの条件分岐タグ。

作成日: 2026-07-21 / 更新日: 2026-07-28

キーワード: logic:equal / Struts Logic Taglib / JSP / 条件分岐 / name / property / value / scope / JSTL

概要

<logic:equal> は、指定した値と基準値が等しい場合だけ、タグで囲んだ部分を処理する条件分岐タグです。

JSPそのものの標準タグではなく、Struts 1のLogic Taglibに含まれます。Struts 1とJSPを使った既存のJava業務システムで見かけることがあります。

最初に、JSPでLogic Taglibを利用できるようにします。

<%@ taglib uri="http://struts.apache.org/tags-logic" prefix="logic" %>

たとえば、userForm の status が ACTIVE の場合だけメッセージを表示するなら、次のように書きます。

<logic:equal name="userForm" property="status" value="ACTIVE">
  <p>利用中のユーザーです。</p>
</logic:equal>

この例では、次の値を比較しています。

概念的には、次の条件に近い処理です。

"ACTIVE".equals(userForm.getStatus())

ただし、実際の値の取得や比較時の型変換はStrutsのタグ実装が行います。

属性	役割
`name`	ページ、リクエスト、セッション、アプリケーションのいずれかから取得するBean名
`property`	Beanの中で比較するプロパティ名
`value`	比較対象となる基準値
`scope`	Beanを探すスコープ。省略時は各スコープから順に検索される
`parameter`	リクエストパラメータの値を比較するときに指定する
`header`	HTTPヘッダーの値を比較するときに指定する
`cookie`	Cookieの値を比較するときに指定する

通常のStruts画面では、name、property、valueの組み合わせを読む機会が多くなります。

同じ名前の属性が複数のスコープに存在する可能性がある場合は、scopeを明示します。

<logic:equal
  name="userForm"
  property="status"
  value="ACTIVE"
  scope="request">
  <p>利用中のユーザーです。</p>
</logic:equal>

scopeには、page、request、session、applicationを指定できます。

<logic:equal parameter="mode" value="edit">
  <p>編集モードです。</p>
</logic:equal>

URLが ?mode=edit のようになっている場合に、タグ内が処理されます。

ただし、リクエストパラメータを使って重要な業務判断や権限制御を行うべきではありません。画面表示の切り替えと、サーバー側で保証すべき処理は分けて考えます。

値が等しくない場合だけ処理したいときは、<logic:notEqual>を使います。

<logic:notEqual name="userForm" property="status" value="ACTIVE">
  <p>現在は利用できません。</p>
</logic:notEqual>

新しいJSPコードでは、Struts 1固有のタグよりもJSTLとELを使った次の書き方のほうが意図を読み取りやすい場合があります。

<c:if test="${userForm.status eq 'ACTIVE'}">
  <p>利用中のユーザーです。</p>
</c:if>

ただし、既存システムではプロジェクト内の記述方法を揃える必要があります。単独で置き換えるのではなく、利用しているStrutsやJSPのバージョン、タグライブラリ、テスト範囲を確認します。

<logic:equal>を見つけたら、次の順番で確認します。

JSPの条件分岐が増えると、画面の表示条件を追いにくくなります。複雑な判断はActionやサービス層で行い、JSPには表示に必要な結果を渡すほうが、責務を分けやすくなります。