✅ 想定読者

Struts2のUIタグにはある程度慣れてきた
JSPファイルに記述が散らかってきたので整理したい
再利用可能なUIパーツを部品化したい

✅ 本記事で学べること

項目	内容
TLDファイルの構造	タグライブラリ定義の基本
タグクラスの作成	`TagSupport` を継承したタグ実装
JSPでの使い方	`<%@ taglib ... %>` による呼び出し
実務活用	UI共通化・メッセージ表示・再利用部品の実装

🛠 Step 1：TLDファイルの作成

/WEB-INF/custom.tld に以下の内容で定義します。

<?xml version="1.0" encoding="UTF-8"?>
<taglib xmlns="http://java.sun.com/xml/ns/javaee"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
            http://java.sun.com/xml/ns/javaee/web-jsptaglibrary_2_1.xsd"
        version="2.1">
  <tlib-version>1.0</tlib-version>
  <short-name>custom</short-name>
  <uri>http://example.com/custom</uri>

  <tag>
    <name>messageBox</name>
    <tag-class>com.example.tags.MessageBoxTag</tag-class>
    <body-content>JSP</body-content>
    <attribute>
      <name>type</name>
      <required>false</required>
    </attribute>
    <attribute>
      <name>message</name>
      <required>true</required>
    </attribute>
  </tag>
</taglib>

🛠 Step 2：Javaのタグクラスを作成

package com.example.tags;

import javax.servlet.jsp.tagext.TagSupport;
import javax.servlet.jsp.JspWriter;

public class MessageBoxTag extends TagSupport {
    private String type;
    private String message;

    public void setType(String type) {
        this.type = type;
    }

    public void setMessage(String message) {
        this.message = message;
    }

    @Override
    public int doStartTag() {
        try {
            JspWriter out = pageContext.getOut();
            String cssClass = "info".equals(type) ? "box-info" : "box-default";
            out.write("<div class='" + cssClass + "'>" + message + "</div>");
        } catch (Exception e) {
            e.printStackTrace();
        }
        return SKIP_BODY;
    }
}

🛠 Step 3：JSPから呼び出す

<%@ taglib prefix="c" uri="http://example.com/custom" %>

<html>
  <body>
    <c:messageBox type="info" message="保存が完了しました。" />
  </body>
</html>

💡 実務での応用例

カスタムタグ名	用途例
`<c:messageBox>`	エラーメッセージや通知の共通化
`<c:formGroup>`	Bootstrap対応フォーム入力部品化
`<c:submitButton>`	アイコン付きボタンの共通利用

📝 補足：TagSupportを使う理由

JavaEEの TagSupport を使うことで、JSPレベルで再利用可能な部品をJavaで表現できます。
Spring Bootでは「Thymeleaf + フラグメント」などの手段が主流ですが、古典的なJSP構成のStruts2プロジェクトでは今も有効です。

🔖 次回予告

📗 Vol.8.11：タグの出力をスタイリッシュに！UI統一Tips
→ Struts2タグ（例：<s:form> や <s:fielderror>）の出力HTMLを読み解き、
BootstrapやCSSフレームワークと連携させる方法を紹介します！

🧭 Vol.8 応用編シリーズ（進捗一覧）

Vol	内容	公開状況
8.10	カスタムタグ入門	✅ 本記事
8.11	UI出力のカスタマイズ	🔜 執筆予定
8.12	共通レイアウト構成	🔜 執筆予定

🙏 最後に

Struts2でのUI開発を効率化するには、タグの理解と部品化が鍵になります。
本記事が皆さんの現場開発の一助になれば幸いです！

🌟 「いいね」や「ストック」で応援いただけると励みになります！

yaml
コピーする
編集する