JavaWeb_简单标签(自定义标签)HelloWorld

传统标签和简单标签

• 可发自定义标签，其核心就是编写处理器类，一个标签对应一个标签处理器类，而一个标签库则是很多标签处理器的集合。所有标签处理器类都要实现JspTag接口，该接口没有定义任何方法，主要作为Tag和SimpleTag接口的父接口。
• 在JSP2.0以前，所有标签处理器类都必须实现Tag接口，这样的标签称为传统标签。
• JSP2.0规范又定义了一种新的类型的标签，称为简单标签，其对应的处理器类要实现SimpleTag接口

 

自定义标签的开发与应用步骤

• 编写完成标签功能的Java类(标签处理器)
• 编写标签库描述(tld)文件，在tld文件中对自定义中进行描述
• 在JSP页面中导入和使用自定义标签

 

自定义标签

（1）创建一个标签处理器类：实现SimpleTag接口

（2）在WEB-INF文件夹下新建一个.tld(标签库描述文件)为扩展名的xml文件。

 

（3）在tld文件中描述自定义的标签：

<?xml version="1.0" encoding="ISO-8859-1"?>

<taglib xmlns="http://java.sun.com/xml/ns/javaee"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-jsptaglibrary_2_1.xsd"
        version="2.1">

    <tlib-version>1.0</tlib-version>

    <!--建议在JSP页面上使用的标签前缀-->
    <short-name>myshortname</short-name>
    <!--作为tld文件的id，用来唯一标识当前的TLD文件，多个tld文件的URI不能重复。
    通过JSP页面的taglib标签的uri属性来引用-->
    <uri>http://mycompany.com</uri>

    <!-- Invoke 'Generate' action to add tags or functions -->

    <!--描述自定义的HelloSimpleTag标签-->
    <tag>
        <!--标签名：在JSP页面上使用标签时的名字-->
        <name>hello</name>
        <!--标签所在的全类名-->
        <tag-class>com.demo.tag.HelloSimpleTag</tag-class>
        <!--标签体的类型-->
        <body-content>empty</body-content>
    </tag>
</taglib>

（4）在JSP页面上使用自定义标签　

　　　　》使用taglib指令导入标签库描述文件

<%@taglib prefix="yhs" uri="http://mycompany.com" %>
　　　》使用自定义的标签：

<yhs:hello/>

需要导入两个包：

  <dependency>
      <groupId>javax.servlet.jsp.jstl</groupId>
      <artifactId>javax.servlet.jsp.jstl-api</artifactId>
      <version>1.2.2</version>
    </dependency>
    <!-- https://mvnrepository.com/artifact/taglibs/standard -->
    <dependency>
      <groupId>taglibs</groupId>
      <artifactId>standard</artifactId>
      <version>1.1.2</version>
    </dependency>

　　

创建一个类实现SimpleTag接口

package com.demo.tag;

import javax.servlet.jsp.JspContext;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.JspFragment;
import javax.servlet.jsp.tagext.JspTag;
import javax.servlet.jsp.tagext.SimpleTag;
import java.io.IOException;

public class HelloSimpleTag implements SimpleTag {
    @Override
    public void doTag() throws JspException, IOException {
        System.out.println("doTag");
    }

    @Override
    public void setParent(JspTag jspTag) {
        System.out.println("setParent");
    }

    @Override
    public JspTag getParent() {
        System.out.println("getParent");
        return null;
    }

    @Override
    public void setJspContext(JspContext jspContext) {
        System.out.println("setJspContext");
    }

    @Override
    public void setJspBody(JspFragment jspFragment) {
        System.out.println("setJspBody");
    }
}