繼承 BodyTagSupport(有主體內容)或 SimpleTagSupport(JSP 2.0+ 推薦)。
package com.example.tag;
import javax.servlet.jsp.*;
import javax.servlet.jsp.tagext.*;
import java.io.IOException;
public class MessageWriterTagHandler extends BodyTagSupport {
private String fontColor = "black"; // 預設黑色
public String getFontColor() { return fontColor; }
public void setFontColor(String fontColor) { this.fontColor = fontColor; }
@Override
public int doAfterBody() throws JspException {
BodyContent bodyContent = getBodyContent();
JspWriter out = bodyContent.getEnclosingWriter();
try {
String body = bodyContent.getString();
out.print("<font color=\"" + fontColor + "\">" + body + "</font>");
} catch (IOException e) {
throw new JspException(e);
}
return SKIP_BODY; // 主體已處理,不再重複評估
}
}
public class MessageWriterTag extends SimpleTagSupport {
private String fontColor = "black";
public void setFontColor(String fontColor) { this.fontColor = fontColor; }
@Override
public void doTag() throws JspException, IOException {
JspFragment body = getJspBody();
if (body != null) {
StringWriter sw = new StringWriter();
body.invoke(sw); // 將主體內容寫入 StringWriter
String content = sw.toString();
getJspContext().getOut().print("<font color=\"" + fontColor + "\">" + content + "</font>");
}
}
}
路徑:WEB-INF/tlds/mytags.tld
<?xml version="1.0" encoding="UTF-8"?>
<taglib xmlns="https://xmlns.jcp.org/xml/ns/javaee"
xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="https://xmlns.jcp.org/xml/ns/javaee web-jsptaglibrary_2_1.xsd"
version="2.1">
<tlib-version>1.0</tlib-version>
<short-name>my</short-name>
<uri>https://example.com/mytags</uri>
<tag>
<name>colored</name>
<tag-class>com.example.tag.MessageWriterTag</tag-class>
<body-content>scriptless</body-content>
<attribute>
<name>fontColor</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue> <!-- 支援 EL 運算式 -->
<type>java.lang.String</type>
</attribute>
</tag>
</taglib>
<%@ taglib prefix="my" uri="https://example.com/mytags" %>
<html><body>
<my:colored fontColor="red">這段文字會變紅色</my:colored>
<br>
<my:colored fontColor="${user.preferredColor}">支援 EL 運算式的顏色</my:colored>
</body></html>
| TLD 屬性 | 說明 |
|---|---|
required | true/false,是否必填 |
rtexprvalue | true/false,是否接受運行時運算式(EL、Scriptlet) |
type | 屬性 Java 型別,預設 String |
fragment | true 表示屬性為 JspFragment(片段屬性),配合 <jsp:attribute> 使用 |
empty:無主體 <my:tag/>scriptless:主體可含 EL、JSTL、標準動作,**不可含 Scriptlet** (JSP 2.0+ 推薦)tagdependentJSP:主體可含任意 JSP 代碼(舊版相容,不推薦)WEB-INF/classes/ 或打包 JAR 放入 WEB-INF/lib/。WEB-INF/tlds/ 或 JAR META-INF/。TagSupport.getParent() 取得父標籤實例,協作處理邏輯。.tag 檔案(JSP 語法寫標籤),無需 Java 類別,放入 WEB-INF/tags/ 即可自動部署。<function> 定義靜態方法供 EL 調用,比標籤更輕量。TagLibraryValidator 編譯期驗證標籤用法正確性。SimpleTagSupport,API 更簡潔、不易出錯。body-content 設為 scriptless,禁止 Scriptlet 進入標籤主體。c, fmt, fn, my, sec)。