萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> JSP 程式設計

JSP 自定義標簽開發全攻略:從原理到實戰的完整指南

核心概念速覽

術語說明
標簽XML 元素,如 ``,名稱/屬性大小寫敏感
標簽庫功能相關標簽的集合,如 JSTL、自定義業務標簽庫
TLD 文件Tag Library Descriptor,XML 配置,定義標簽與處理類映射
標簽處理類實現標簽邏輯的 Java 類,繼承 `TagSupport` 或實現 `SimpleTag`

使用流程

  1. JSP 頁面引入:`<%@ taglib prefix="my" uri="/WEB-INF/mytags.tld" %>`
  2. 使用標簽:``
  3. 容器解析:prefix → uri → web.xml 映射 → TLD 文件 → 找到 `` → 實例化處理類 → 調用生命周期方法

開發步驟詳解

1. 編寫標簽處理類(繼承 TagSupport)

public class HelloTag extends TagSupport {
    private String name; // 屬性對應 setter
    public void setName(String name) { this.name = name; }

    @Override
    public int doStartTag() throws JspException {
        try {
            pageContext.getOut().print("Hello, " + name + "!");
        } catch (IOException e) {
            throw new JspException(e);
        }
        return SKIP_BODY; // 無標簽體
    }

    @Override
    public int doEndTag() throws JspException {
        return EVAL_PAGE; // 繼續執行頁面
    }
}

2. 編寫 TLD 文件 (/WEB-INF/mytags.tld)

<?xml version="1.0" encoding="UTF-8"?>
<taglib xmlns="https://java.sun.com/xml/ns/javaee" version="2.1">
  <tlib-version>1.0</tlib-version>
  <short-name>my</short-name>
  <uri>https://example.com/mytags</uri>

  <tag>
    <name>hello</name>
    <tag-class>com.example.tags.HelloTag</tag-class>
    <body-content>empty</body-content>
    <attribute>
      <name>name</name>
      <required>true</required>
      <rtexprvalue>true</rtexprvalue> 
    </attribute>
  </tag>
</taglib>

3. web.xml 映射(可選,Servlet 2.3+ 容器自動掃描 WEB-INF/*.tld)

<jsp-config>
  <taglib>
    <taglib-uri>https://example.com/mytags</taglib-uri>
    <taglib-location>/WEB-INF/mytags.tld</taglib-location>
  </taglib>
</jsp-config>

4. JSP 中使用

<%@ taglib prefix="my" uri="https://example.com/mytags" %>
<my:hello name="${user.name}"/>

TagSupport 關鍵機制

  • pageContext:容器在 `doStartTag` 前調用 `setPageContext` 注入,可訪問 request、session、application、out 等隱含對象。
  • parent:巢狀標簽時指向父標簽處理類,支持協作。
  • 返回值控制流程:
    • `doStartTag`:`SKIP_BODY`(跳過體) / `EVAL_BODY_INCLUDE`(執行體)
    • `doEndTag`:`SKIP_PAGE`(停止頁面) / `EVAL_PAGE`(繼續)

進階:SimpleTag (JSP 2.0+)

更簡潔,無 `doStartTag/doEndTag`,只需實現 `doTag()`,通過 `getJspBody().invoke(null)` 處理標簽體,適合現代開發。

最佳實踐

  1. 標簽庫 URI 使用唯一 URL 風格,避免衝突。
  2. 屬性支持運行時表達式 (`rtexprvalue=true`)。
  3. 複雜邏輯移至 Service 層,標簽只做展示組裝。
  4. 大量輸出時使用 `BodyContent` 緩衝,避免直接寫 `out` 導致順序錯亂。
  5. 優先考慮 JSTL、EL 表達式、標籤文件,減少 Java 代碼標簽開發。
copyright © 萬盛學電腦網 all rights reserved