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