JSP自定义标签

自定义标签
1 引入
需求： 向浏览器输出当前客户的IP地址 （只能使用jsp标签）
2 第一个自定义标签开发步骤
1）编写一个普通的java类，继承SimpleTagSupport类，叫标签处理器类

/**
 * 标签处理器类
 * @author APPle
 * 1）继承SimpleTagSupport
 *
 */
public class ShowIpTag extends SimpleTagSupport{
    private JspContext context;

    /**
     * 传入pageContext
     */
    @Override
    public void setJspContext(JspContext pc) {
        this.context = pc;
    }

    /**
     * 2）覆盖doTag方法
     */
    @Override
    public void doTag() throws JspException, IOException {
        //向浏览器输出客户的ip地址
        PageContext pageContext = (PageContext)context;

        HttpServletRequest request = (HttpServletRequest)pageContext.getRequest();

        String ip = request.getRemoteHost();

        JspWriter out = pageContext.getOut();

        out.write("使用自定义标签输出客户的IP地址："+ip);

    }
}

2）在web项目的WEB-INF目录下建立mytag.tld文件，这个tld叫标签库的声明文件。（参考核心标签库的tld文件）

<?xml version="1.0" encoding="UTF-8" ?>

<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.1</tlib-version>
  <!-- 标签库前缀 -->
  <short-name>itcast</short-name>
  <!-- tld文件的唯一标记 -->
  <uri>http://gz.mytag.cn</uri>

  <!-- 一个标签的声明 -->
  <tag>
    <!-- 标签名称 -->
    <name>showIp</name>
    <!-- 标签处理器类的全名 -->
    <tag-class>gz.mytag.a_tag.ShowIpTag</tag-class>
    <!-- 输出标签体内容格式 -->
    <body-content>scriptless</body-content>
  </tag>

</taglib>

3） 在jsp页面的头部导入自定义标签库

    <%@taglib uri="http://gz.mytag.cn" prefix="mytag"%>

4） 在jsp中使用自定义标签

    <itcast:showIp></itcast:showIp>

3 自定义标签的执行过程
问题： http://localhost:8080/day14/01.hellotag.jsp 如何访问到自定义前提： tomcat服务器启动时，加载到每个web应用，加载每个web应用的WEB-IN目录下的所有文件
1）访问01.hellotag.jsp资源
2）tomcat服务器把jsp文件翻译成java源文件->编译class->构造类对象->调用_jspService（）方法
3）检查jsp文件的taglib指令，是否存在一个名为http://gz.mytag.cn的tld文件。如果没有，则报错
4）上一步已经读到mytag.tld文件
5）读到<itcast:showIp> 到mytag.tld文件中查询是否存在<name>为showIp的<tag>标签
6）找到对应的<tag>标签，则读到<tag-class>内容
7）得到 gz.mytag.a_tag.ShowIpTag
构造ShowIpTag对象，然后调用ShowIpTag里面的方法

4、自定义标签处理器类的生命周期
SimpleTag接口：
void tJspContext(JspContext pc)
–设置pageContext对象，传入pageContext（一定调用）通过getJspCotext()方法得到pageContext对象

void setParent(JspTag parent)
–设置父标签对象，传入父标签对象，如果没有父标签，则不调用此方法。通过getParent()方法得到父标签对象。

void setXXX(值)
–设置属性值。

void setJspBody(JspFragment jspBody)
–设置标签体内容。标签体内容封装到JspFragment对象中，然后传入JspFragment对象。通过getJspBody()方法得到标签体内容。如果没有标签体内容，则不会调用此方法

void doTag()
–执行标签时调用的方法。（一定调用）

5 自定义标签的作用
1）控制标签体内容是否输出
2）控制标签余下内容是否输出
3）控制重复输出标签体内容
4）改变标签体内容
5）带属性的标签
步骤：
5.1 在标签处理器中添加一个成员变量和setter方法

    //1.声明属性的成员变量
    private Integer num;

    //2.关键点： 必须提供公开的setter方法，用于给属性赋值
    public void setNum(Integer num) {
        this.num = num;
    }

6 输出标签体内容格式

JSP： 在传统标签中使用的。可以写和执行jsp的java代码。
scriptless: 标签体不可以写jsp的java代码
empty: 必须是空标签。
tagdependent : 标签体内容可以写jsp的java代码，但不会执行。