本文探讨了在 JSP Tag 文件中实现完全求值 Body 内容的方法，类似于 Java 类中 BodyTag 接口的 EVAL_BODY_INCLUDE 功能。由于 JSP Tag 文件本身的限制，直接支持完整的 JSP 代码（包括 Scriptlet 和表达式）是不可能的。本文将解释这一限制，并提供替代方案。
JSP Tag 文件提供了一种方便的方式来封装和重用 JSP 代码片段。然而，它们在处理 Body 内容时存在一些限制。一个常见的问题是如何让 Tag 文件支持其 Body 中包含完整的 JSP 代码，包括 Scriptlet (<% ... %>) 和表达式 (<%= ... %>)。
Tag 文件 Body 内容的限制
在 Tag 文件中，body-content 属性用于指定 Body 内容的类型。常用的值包括：
- empty: Tag 没有 Body 内容。
- scriptless: Tag 的 Body 内容可以包含 EL 表达式和 JSTL 标签，但不能包含 Scriptlet。
- tagdependent: Tag 的 Body 内容由 Tag 自身处理，JSP 引擎不会对其进行解释。
遗憾的是，没有一个 body-content 的值允许在 Tag 文件的 Body 中使用完整的 JSP 代码。尝试这样做会导致类似于 "Scripting elements are disallowed here" 的错误。
示例：无法在 Tag 文件中使用 Scriptlet
考虑以下 Tag 文件 dialog.tag：
<%@tag pageEncoding="UTF-8" body-content="scriptless" %>
<div class="dialog">
<jsp:doBody />
</div>以及使用它的 Tag 文件 use-dialog.tag：
<%@tag pageEncoding="UTF-8" %>
<%@attribute name="someAttribute" type="java.lang.String" required="false" %>
<%@taglib prefix="mytaglib" uri="/WEB-INF/tlds/mytaglib" %>
<mytaglib:dialog>
<%-- 使用变量 --%>
Hello <%= someAttribute %>
<%-- 使用其他标签 --%>
<mytaglib:some-other-tag someParameter="5" />
</mytaglib:dialog>这段代码会抛出异常，因为 dialog.tag 的 Body 中包含了 Scriptlet 表达式 (<%= someAttribute %>)。
使用 Java 类实现 BodyTag
解决这个限制的唯一方法是使用 Java 类来实现 BodyTag 接口。BodyTag 允许你完全控制 Body 内容的处理方式。
以下是一个 Dialog.java 的示例：
import javax.servlet.jsp.JspWriter;
import javax.servlet.jsp.PageContext;
import javax.servlet.jsp.tagext.BodyTag;
import javax.servlet.jsp.tagext.BodyContent;
import javax.servlet.jsp.tagext.Tag;
import javax.servlet.jsp.JspException;
import java.io.IOException;
public class Dialog implements BodyTag {
private PageContext pageContext;
private Tag parent;
private BodyContent bodyContent;
@Override
public void setPageContext(PageContext pageContext) {
this.pageContext = pageContext;
}
@Override
public void setParent(Tag parent) {
this.parent = parent;
}
@Override
public Tag getParent() {
return parent;
}
@Override
public void setBodyContent(BodyContent bodyContent) {
this.bodyContent = bodyContent;
}
@Override
public void doInitBody() throws JspException {
// 可选：在 Body 内容求值之前执行一些初始化操作
}
@Override
public int doStartTag() throws JspException {
try {
JspWriter out = pageContext.getOut();
out.print("<div class=\"dialog\">");
} catch (IOException e) {
throw new JspException(e);
}
return EVAL_BODY_BUFFERED; // EVAL_BODY_INCLUDE 已经过时，推荐使用 EVAL_BODY_BUFFERED
}
@Override
public int doEndTag() throws JspException {
try {
JspWriter out = pageContext.getOut();
if (bodyContent != null) {
out.print(bodyContent.getString()); // 输出 Body 内容
}
out.print("</div>");
} catch (IOException e) {
throw new JspException(e);
} finally {
if (bodyContent != null) {
try {
bodyContent.clear(); // 清理 BodyContent
} catch (IOException e) {
// ignore
}
}
}
return EVAL_PAGE; // 继续评估 JSP 页面
}
@Override
public void release() {
pageContext = null;
parent = null;
bodyContent = null;
}
}关键点:
- setPageContext(PageContext pageContext): 设置 PageContext 对象，允许访问 JSP 页面上下文。
- doStartTag(): 在 Tag 开始标签处执行，输出 <div class="dialog">。EVAL_BODY_BUFFERED 指示容器评估 Tag 的 Body 并将其存储在 BodyContent 对象中。
- doEndTag(): 在 Tag 结束标签处执行，输出 </div>。在此方法中，我们从 bodyContent 获取 Body 内容并将其输出。
- release(): 释放资源，这是一个好习惯。
使用 Java Tag
为了使用 Java Tag，需要在 TLD 文件中声明它。例如，如果你的 TLD 文件是 mytaglib.tld，你可以添加以下内容：
<tag>
<name>dialog</name>
<tag-class>com.example.Dialog</tag-class>
<body-content>JSP</body-content>
</tag>然后，你可以像这样在 JSP 页面中使用它：
<%@taglib prefix="mytaglib" uri="/WEB-INF/tlds/mytaglib.tld" %>
<mytaglib:dialog>
<%-- 使用变量 --%>
Hello <%= request.getParameter("name") %>
<%-- 使用其他标签 --%>
<mytaglib:some-other-tag someParameter="5" />
</mytaglib:dialog>总结
虽然 JSP Tag 文件提供了一种便捷的方式来创建可重用的组件，但它们在处理包含完整 JSP 代码的 Body 内容时存在限制。要实现完全求值的 Body 内容，你需要使用 Java 类来实现 BodyTag 接口。这种方法允许你完全控制 Body 内容的处理方式，并支持 Scriptlet 和表达式。这种方式虽然稍微复杂，但提供了更大的灵活性和控制力。
