在Java标签处理器中使用JSP/Tag文件实现可复用表格的疑问

一、Tag File 完全支持接收列表属性，你之前的认知有误 #

Tag File是JSP自定义标签的简化实现，完全可以传递列表、自定义对象这类复杂属性，只需要在tag文件中通过<%@ attribute %>声明属性类型即可，这是最适合你场景的方案，无需编写Java类就能实现视图复用：

1. 创建table.tag文件（放置在WEB-INF/tags目录下）：

<%@ tag language="java" pageEncoding="UTF-8" %>
<%-- 声明接收的属性，指定类型和必填性 --%>
<%@ attribute name="dataList" required="true" type="java.util.List" %>
<%@ attribute name="columnTitles" required="true" type="java.util.List" %>
<%@ attribute name="actionLinks" required="false" type="java.util.List" %>

<table border="1" cellpadding="4" cellspacing="0">
    <thead>
        <tr>
            <%-- 渲染表头 --%>
            <% for (String title : columnTitles) { %>
                <th><%= title %></th>
            <% } %>
            <%-- 可选操作列 --%>
            <% if (actionLinks != null && !actionLinks.isEmpty()) { %>
                <th>操作</th>
            <% } %>
        </tr>
    </thead>
    <tbody>
        <%-- 渲染表格数据行 --%>
        <% for (Object item : dataList) { %>
            <tr>
                <%-- 这里根据你的对象实际属性调整，示例假设对象是User类，有getName、getAge、getId方法 --%>
                <td><%= ((com.yourpackage.User)item).getName() %></td>
                <td><%= ((com.yourpackage.User)item).getAge() %></td>
                <%-- 渲染操作链接 --%>
                <% if (actionLinks != null && !actionLinks.isEmpty()) { %>
                    <td>
                        <% for (String link : actionLinks) { %>
                            <a href="<%= link %>?id=<%= ((com.yourpackage.User)item).getId() %>" style="margin:0 4px;">操作</a>
                        <% } %>
                    </td>
                <% } %>
            </tr>
        <% } %>
    </tbody>
</table>

2. 在业务JSP中引用该Tag：

<%@ taglib prefix="custom" tagdir="/WEB-INF/tags" %>

<%-- 渲染第一个表格 --%>
<custom:table dataList="${userList1}" columnTitles="${titles1}" actionLinks="${operationLinks1}" />

<%-- 渲染第二个表格 --%>
<custom:table dataList="${userList2}" columnTitles="${titles2}" />

二、若坚持使用Java Tag，可通过模板文件避免StringBuilder拼HTML #

Java Tag并非不能结合模板，你可以通过PageContext将数据存入域中，再引入JSP模板文件负责HTML渲染，实现逻辑与视图分离：

1. 编写Java Tag类：

package com.yourpackage;

import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.SimpleTagSupport;
import java.util.List;

public class TableTag extends SimpleTagSupport {
    private List<?> dataList;
    private List<String> columnTitles;
    private List<String> actionLinks;

    @Override
    public void doTag() throws JspException {
        // 将数据存入JSP上下文，供模板调用
        getJspContext().setAttribute("dataList", dataList);
        getJspContext().setAttribute("columnTitles", columnTitles);
        getJspContext().setAttribute("actionLinks", actionLinks);
        
        try {
            // 引入模板文件渲染HTML
            getJspContext().include("/WEB-INF/templates/table-template.jsp");
        } catch (Exception e) {
            throw new JspException("Failed to load table template", e);
        }
    }

    // 生成属性的getter/setter方法
    public void setDataList(List<?> dataList) {
        this.dataList = dataList;
    }

    public void setColumnTitles(List<String> columnTitles) {
        this.columnTitles = columnTitles;
    }

    public void setActionLinks(List<String> actionLinks) {
        this.actionLinks = actionLinks;
    }
}

2. 编写模板文件table-template.jsp（放置在WEB-INF/templates目录下）：

<table border="1" cellpadding="4" cellspacing="0">
    <thead>
        <tr>
            <% for (String title : (List<String>)request.getAttribute("columnTitles")) { %>
                <th><%= title %></th>
            <% } %>
            <% List<String> links = (List<String>)request.getAttribute("actionLinks"); %>
            <% if (links != null && !links.isEmpty()) { %>
                <th>操作</th>
            <% } %>
        </tr>
    </thead>
    <tbody>
        <% for (Object item : (List<?>)request.getAttribute("dataList")) { %>
            <tr>
                <td><%= ((com.yourpackage.User)item).getName() %></td>
                <td><%= ((com.yourpackage.User)item).getAge() %></td>
                <% if (links != null && !links.isEmpty()) { %>
                    <td>
                        <% for (String link : links) { %>
                            <a href="<%= link %>?id=<%= ((com.yourpackage.User)item).getId() %>" style="margin:0 4px;">操作</a>
                        <% } %>
                    </td>
                <% } %>
            </tr>
        <% } %>
    </tbody>
</table>

3. 在TLD文件中声明该Tag：

<tag>
    <name>table</name>
    <tag-class>com.yourpackage.TableTag</tag-class>
    <body-content>empty</body-content>
    <info>Render table from data list</info>
    <attribute>
        <name>dataList</name>
        <required>true</required>
        <description>Data list to render</description>
        <rtexprvalue>true</rtexprvalue>
    </attribute>
    <attribute>
        <name>columnTitles</name>
        <required>true</required>
        <description>Table column titles</description>
        <rtexprvalue>true</rtexprvalue>
    </attribute>
    <attribute>
        <name>actionLinks</name>
        <required>false</required>
        <description>Operation links for each row</description>
        <rtexprvalue>true</rtexprvalue>
    </attribute>            
</tag>

4. 在业务JSP中使用：

<%@ taglib prefix="custom" uri="/WEB-INF/custom.tld" %>

<custom:table dataList="${userList1}" columnTitles="${titles1}" actionLinks="${operationLinks1}" />
<custom:table dataList="${userList2}" columnTitles="${titles2}" />

你之前遗漏的核心要点 #

1. Tag File支持复杂属性：无需编写Java类，仅通过<%@ attribute %>即可声明接收列表、自定义对象等类型的属性，是JSP视图复用的轻量方案。
2. Java Tag可结合模板渲染：不需要用StringBuilder拼接HTML，而是通过上下文传递数据，引入JSP模板负责视图渲染，实现逻辑与视图分离。

内容的提问来源于stack exchange，提问作者Nathan S