自定义标签

简介: 自定义标签

一. 什么是自定义标签

一般我们说自定义标签是指JSP自定义标签。自定义标签在功能上逻辑上与javaBean 类似,都封装Java 代码。自定义标签是可重用的组件代码,并且允许开发人员为复杂的操作提供逻辑名称。

JSP开发人员使用标签库创建标签.标签库是按照功能或实现进行分组的自定义标签的集合。

网络上常见的CMS内容管理系统都是采用模板的形式来实现,基本上所有的CMS系统都有一套自己的模板标签书写方法,简称自定义标签。

基本概念

1.1 标签(Tag):

标签是一种XML元素,通过标签可以使JSP网页变得简洁并且易于维护,还可以方便地实现同一个JSP文件支持多种语言版本。由于标签是XML元素,所以它的名称和属性都是大小写敏感的。

1.2 标签库(Tag library):

由一系列功能相似、逻辑上互相联系的标签构成的集合称为标签库。

1.3 标签库描述文件(Tag Library Descriptor):

标签库描述文件是一个XML文件,这个文件提供了标签库中类和JSP中对标签引用的映射关系。它是一个配置文件,和web.xml是类似的。

二. 自定义标签的语言特点

标准标签:

<开始标签 属性=“属性值”>标签体</结束标签>

空标签:

<开始标签/>

三. 自定义标签的开发及使用步骤

1. 创建一个标签助手类(继承BodyTagSupport)

package com.xissl.tag;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.JspWriter;
import javax.servlet.jsp.tagext.BodyTagSupport;
public class OutTag extends BodyTagSupport{
  private String val;
  private String defaultVal;
  public String getVal() {
    return val;
  }
  public void setVal(String val) {
    this.val = val;
  }
  public String getDefaultVal() {
    return defaultVal;
  }
  public void setDefaultVal(String defaultVal) {
    this.defaultVal = defaultVal;
  }
  @Override
  public int doStartTag() throws JspException {
    //pageContext为页面上下文对象,用于和jsp共享数据
    JspWriter out = pageContext.getOut();
    try {
      if(val==null || "".equals(val)) {
        out.print(defaultVal);
      }
      else {
        out.print(val);
      }
    } catch (Exception e) {
    }
    return SKIP_BODY;
  }
}

2. 编写标签库描述文件(tld),在tld中对标签进行描述

<!DOCTYPE taglib
  PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN"
   "http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd">
<!-- 标签库描述符 -->
<taglib xmlns="http://java.sun.com/JSP/TagLibraryDescriptor">
  <tlib-version>1.0</tlib-version>
  <jsp-version>1.2</jsp-version>
  <short-name>Simple Tags</short-name>
  <uri>/xissl</uri>
  <tag>
    <!-- 标签名 -->
    <name>out</name>
    <!-- 标签助手类 -->
    <tag-class>com.xissl.tag.OutTag</tag-class>
    <!-- 标签的内容类型,empty表示为空标签,jsp表示为任意 -->
    <body-content>empty</body-content>
    <attribute>
      <!-- 属性名 -->
      <name>val</name>
      <!-- 表示该属性为必要的属性 -->
      <required>true</required>
      <!-- 表示该属性可以接受EL表达式 -->
      <rtexprvalue>true</rtexprvalue>
      <!-- 标签描述:用于说明标签的作用 -->
      <description>out标签val属性,用于输出val的值</description>
    </attribute>
    <attribute>
      <name>defaultVal</name>
      <required>false</required>
      <rtexprvalue>false</rtexprvalue>
    </attribute>
  </tag>
</taglib>

3. JSP通过taglib指令导入标签库

<%@ taglib prefix="l" uri="/xissl" %>

4. 在页面中使用自定义标签

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
    <%@ taglib prefix="l" uri="/xissl" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
</head>
<body>
<l:out val="我要输出的内容是yhsb"/>
</body>
</html>

运行结果如下:

四. 自定义标签生命周期

理解:

当我们实例化标签助手类后就可以开始通过doStartTag方法来处理JSP标签,在我们发送响应时,在doStartTag内部会开始判断是否有标签体。如果有标签体就会进入到doAFterBody方法中,在doAFterBody方法里会继续判断里面是否有方法体,如果里面还有方法体未执行完会继续执行doAFterBody方法。当doAFterBody方法里面的标签体处理完了就会执行doEndTag,这样一个JSP生命周期就结束了

返回值:

SKIP_BODY:跳过主体

EVAL_BODY_INCLUDE:计算标签主体内容并输出

EVAL_BODY_AGAIN:再计算主体一次

EVAL_PAGE:计算页面的后续部分

SKIP_PAGE:跳过页面的后续部分

相关文章
|
jenkins 持续交付
解决Sonarqube quality gate获取不到Sonarqube正确扫描结果的问题
在Jenkins pipeline中,一般都会用到Sonar-scanner来扫描代码,扫描完之后,把结果上传到SonarQube中,SonarQube把结果与质量阀进行对比,然后通过Sonarqube quality gate来判断这次扫描结果是成功还是失败。 不少同学都遇到过Sonarqube quality gate 获得的最后结果不正确,明明SonarQube中的结果是success,而Sonarqube quality gate判断的结果是pending。 这是怎么一回事呢?
3530 0
解决Sonarqube quality gate获取不到Sonarqube正确扫描结果的问题
|
4月前
|
安全 API 文件存储
OpenClaw阿里云/本地零门槛+HTTPS部署手册:NAS专属方案+免费模型配置实战指南
2026年,OpenClaw(Clawdbot)在NAS用户群体中的普及度持续提升,但原生部署面临两大核心痛点:Web UI访问限制(默认仅支持localhost访问)与公网暴露安全风险。OpenClaw In Docker开源项目的出现,完美解决了这一问题——通过类虚拟机级别的容器封装,集成用户登录认证、HTTPS强制访问等安全特性,让NAS及各类设备能安全、便捷地部署OpenClaw,同时支持公网反向代理访问,兼顾实用性与安全性。
1709 7
|
5月前
|
人工智能 安全 网络安全
喂饭级教程:OpenClaw阿里云及Windows本地一键部署:+多Agent/多网关配置,一人群控全域 AI 指南
2026年,AI代理工具的使用场景已从单一设备延伸至多端协同——家里的Mac Mini跑着Claude Max处理日常对话,公司服务器搭载Gemini专注代码开发,阿里云主机负责长时自动化任务,而开发者需要在主力机上快速切换,无需反复修改配置。OpenClaw的群控模式完美解决这一痛点,通过多Agent分工、多Gateway+Profile隔离、环境变量临时切换三大方案,实现“一条命令操控多台AI”的高效体验。
3892 4
|
9月前
|
机器学习/深度学习 人工智能 PyTorch
PyTorch深度学习 ? 带你从入门到精通!!!
🌟 蒋星熠Jaxonic,深度学习探索者。三年深耕PyTorch,从基础到部署,分享模型构建、GPU加速、TorchScript优化及PyTorch 2.0新特性,助力AI开发者高效进阶。
PyTorch深度学习 ? 带你从入门到精通!!!
|
4月前
|
Java 编译器 C++
#Java 逃逸分析与栈上分配:JIT 编译的极致性能优化底层
逃逸分析是JVM核心优化技术,JDK 1.6起默认启用。它通过分析对象动态作用域,对无逃逸对象实施栈上分配、标量替换和同步消除,显著降低GC压力、提升执行效率,是高性能Java开发的必备底层知识。(239字)
348 3
|
7月前
|
XML 缓存 测试技术
Gemini 3 提示词工程:通用最佳实践
本文分享Gemini 3 Pro的高效使用原则与结构化提示词实践,涵盖核心指令、推理规划、多模态处理及领域专用模板,助你提升模型交互效率与输出质量。
1036 1
|
11月前
|
机器学习/深度学习 自动驾驶 算法
道路表面缺陷数据集(裂缝/井盖/坑洼)(6000张图片已划分、已标注)|适用于YOLO系列深度学习分类检测任务【数据集分享】
随着城市化与交通运输业的快速发展,道路基础设施的健康状况直接关系到出行安全与城市运行效率。长期高强度的使用、气候变化以及施工质量差异,都会导致道路表面出现裂缝、坑洼、井盖下沉及修补不良等缺陷。这些问题不仅影响驾驶舒适度,还可能引发交通事故,增加道路养护成本。
道路表面缺陷数据集(裂缝/井盖/坑洼)(6000张图片已划分、已标注)|适用于YOLO系列深度学习分类检测任务【数据集分享】
|
缓存 JSON 前端开发
第07课:Spring Boot集成Thymeleaf模板引擎
第07课:Spring Boot集成Thymeleaf模板引擎
1006 0
第07课:Spring Boot集成Thymeleaf模板引擎
|
机器学习/深度学习 存储 自然语言处理
《Peephole LSTM:窥视孔连接如何开启性能提升之门》
Peephole LSTM是LSTM的一种变体,通过引入窥视孔连接,使各个门(输入门、遗忘门和输出门)能够直接访问细胞状态,从而在门控决策中提供更多的上下文信息。这使得模型能更精准地保留和利用序列中的关键长期依赖关系,避免信息丢失,提升对复杂序列数据的处理能力,在语音识别、自然语言处理等领域表现出色。
629 15
|
域名解析 负载均衡 网络协议
DNS 的应用场景|学习笔记
快速学习DNS 的应用场景
DNS 的应用场景|学习笔记