自定义标签

简介: 自定义标签

一. 什么是自定义标签

一般我们说自定义标签是指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:跳过页面的后续部分

相关文章
|
7月前
|
Kubernetes Perl 容器
k8s标签
k8s标签
|
4月前
|
索引
for标签
【8月更文挑战第6天】for标签。
37 4
|
5月前
|
Kubernetes 算法 调度
k8s 标签-2
k8s 标签-2
35 2
自定义标签(下)
自定义标签(下)
|
XML 前端开发 JavaScript
自定义标签
自定义标签
76 0
|
Java 程序员 开发者
自定义标签-下
自定义标签-下
57 0
自定义标签的详细使用讲解【上】(二)
自定义标签的详细使用讲解【上】(二)
48 0
|
Java 数据库
自定义标签的详细使用讲解【下】
自定义标签的详细使用讲解【下】
40 0
|
XML 设计模式 Java
自定义标签的详细使用讲解【上】(一)
自定义标签的详细使用讲解【上】
175 0
自定义标签属性
自定义标签属性
72 0