萬盛學電腦網

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

JSP 自定義標籤實作完整流程:從 Hello World 到標籤庫優勢

背景演進

早期 JSP 混雜 Java 程式碼、JavaScript、HTML,維護困難。JSTL(JSP Standard Tag Library)與自定義標籤技術應運而生,將邏輯封裝於標籤處理類,JSP 頁面僅保留標籤調用,實現「邏輯與視圖分離」。

建立最簡單自定義標籤:輸出 Hello World

步驟 1:編寫標籤處理類

package com.example.tag;

import javax.servlet.jsp.tagext.*;
import javax.servlet.jsp.*;
import java.io.IOException;

public class HelloTag extends TagSupport {
  @Override
  public int doStartTag() throws JspException {
    try {
      pageContext.getOut().print("Hello World!");
    } catch (IOException e) {
      throw new JspException(e);
    }
    return SKIP_BODY; // 無標籤主體內容
  }
}

關鍵常數:

  • EVAL_BODY_INCLUDE:處理標籤主體內容。
  • SKIP_BODY:略過主體(無主體標籤)。
  • EVAL_PAGE / SKIP_PAGE:控制頁面後續執行流程。

步驟 2:編寫 TLD 標籤描述檔

路徑:WEB-INF/tlds/hello.tld

<?xml version="1.0" encoding="UTF-8"?>
<taglib xmlns="https://java.sun.com/xml/ns/javaee"
        xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="https://java.sun.com/xml/ns/javaee web-jsptaglibrary_2_1.xsd"
        version="2.1">
  <tlib-version>1.0</tlib-version>
  <short-name>hello</short-name>
  <uri>https://example.com/hello</uri>
  <tag>
    <name>hello</name>
    <tag-class>com.example.tag.HelloTag</tag-class>
    <body-content>empty</body-content>
  </tag>
</taglib>

步驟 3:JSP 頁面引入並使用

<%@ taglib prefix="my" uri="https://example.com/hello" %>
<html>
<body>
  <my:hello /><br/>
  <my:hello />
</body>
</html>

輸出結果: 兩行 Hello World!

標籤庫三大優勢

  1. 消除 JSP 嵌入 Java 程式碼:頁面乾淨,前端人員可專注 HTML/CSS。
  2. 增強擴展性、可讀性、重用性:標籤可跨專案重用,參數化配置行為。
  3. 簡化 JSP 編寫工作量:複雜邏輯封裝為簡單標籤,如 <my:pager total="${total}" pageSize="10" />。

進階標籤類型

類型繼承類別適用場景關鍵方法
簡單標籤TagSupport無主體、無屬性doStartTag / doEndTag
帶屬性標籤TagSupport需動態參數setter/getter + doStartTag
帶主體標籤BodyTagSupport需處理主體內容(迴圈、條件、轉換)doAfterBody, doInitBody
SimpleTag (JSP 2.0+)SimpleTagSupport更簡潔 API,取代 BodyTagSupportdoTag(), getJspBody().invoke()

SimpleTag 範例:帶屬性與主體處理

public class RepeatTag extends SimpleTagSupport {
  private int count;
  public void setCount(int count) { this.count = count; }

  @Override
  public void doTag() throws JspException, IOException {
    JspFragment body = getJspBody();
    for (int i = 0; i < count; i++) {
      body.invoke(getJspContext().getOut()); // 輸出主體內容
    }
  }
}

TLD 定義 <attribute><name>count</name><required>true</required><rtexprvalue>true</rtexprvalue></attribute>。
JSP 使用:<my:repeat count="3"><li>項目</li></my:repeat>

部署與最佳實踐

  • TLD 檔放置於 WEB-INF/tlds/ 或 JAR 的 META-INF/,容器自動掃描。
  • web.xml 可選配置 <jsp-config><taglib> 映射 URI。
  • 命名規範:前綴簡短有意義(如 c、fmt、fn、my)。
  • 大型專案建議將標籤類別打包成獨立 JAR,供多專案共用。
copyright © 萬盛學電腦網 all rights reserved