自定义（带属性）标签学习笔记

前言:

前面我学了核心的标签
但是如果我想要实现的内容核心标签 和jstl标签库不能解决怎么办？
有人说可以用jsp脚本，但是jsp主要是展示数据用的，不应该大量出现java代码才对。这个时候自定义标签就出现了。
（也有人说jsp耦合度太高了，这些姑且不考虑）
自定义标签目的：

替代jsp脚本，用于在jsp页面中执行java代码

步骤有四：

 编写标签处理器类，继承SimpleTagSupport类，覆盖doTag方法
 在WEB-INF目录下建立tld文件，在tld配置标签
 在jsp页面导入标签库，使用taglib指令
 在jsp页面中使用标签库中的标签

第一步：编写一个普通的java类，继承SimpleTagSupport类，叫标签处理器类

注意：SimpleTagSupport需要导包jsp-api.jar，这个可以在Tomcat的lib中找到

重点：自定义标签的内容要覆盖doTag方法

自定义标签的执行过程

问题： http://localhost:8080/day14/01.hellotag.jsp  如何访问到自定义标签？

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

            构造ShowIpTag对象，然后调用ShowIpTag里面的方法

自定义标签处理器类的生命周期

SimpleTag接口： 
                void    setJspContext(JspContext pc)  --设置pageContext对象，传入pageContext（一定调用）
                                                        通过getJspCotext()方法得到pageContext对象
                void    setParent(JspTag parent)  --设置父标签对象，传入父标签对象，如果没有父标签，则不                                                      调用此方法。通过getParent()方法得到父标签对象。
                void     setXXX(值)             --设置属性值。
                void    setJspBody(JspFragment jspBody) --设置标签体内容。标签体内容封装到JspFragment对象                                                 中，然后传入JspFragment对象。通过getJspBody()方法                                                        得到标签体内容。如果没有标签体内容，则不会调                                                      用此方法
                void    doTag()                     --执行标签时调用的方法。（一定调用）

我编写了两个：直接贴代码好了：
代码1实现了 像浏览器输出浏览器的IP地址：

package show;

import java.io.IOException;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.JspWriter;
import javax.servlet.jsp.PageContext;
import javax.servlet.jsp.tagext.SimpleTagSupport;

public class ShowIp extends SimpleTagSupport {
    @Override
    public void doTag() throws JspException, IOException {
        PageContext pageContext=(PageContext)this.getJspContext();
        HttpServletRequest httpServletRequest=(HttpServletRequest)pageContext.getRequest();
        String string=httpServletRequest.getRemoteHost();
        JspWriter jspWriter=pageContext.getOut();
        jspWriter.write(string);
    }
}

代码2：比较杂，主要有带属性的标签还有对标签内容进行操作：
1）控制标签体内容是否输出
2）控制标签余下内容是否输出
3）控制重复输出标签体内容
4）改变标签体内容
5）带属性的标签

public class other extends SimpleTagSupport {
    private Integer num;

    public void setNum(Integer num) {
        this.num = num;
    }

    @Override
    public void doTag() throws JspException, IOException {
        //输出属性
        System.out.println(num);
         /* 1）控制标签内容是否输出
             输出： 调用jspFrament.invoke();
             不输出： 不调用jspFrament.invoke();
             往浏览器输出内容，invoke为null就是默认往浏览器输出
             */
        this.getJspBody().invoke(null);

        JspFragment jspFragment= this.getJspBody();
        String context=jspFragment.toString();
        //控制重复输出标签体内容
        for(int i=0;i<2;i++) {
            jspFragment.invoke(null);
        }
        //改变标签体内容
        StringWriter stringWriter=new StringWriter();
        //标签内容存到临时StringWriter中
        jspFragment.invoke(stringWriter);
        String string=stringWriter.toString();
        string=string.toUpperCase();
        this.getJspContext().getOut().write(string);
        //控制标签余下内容是否输出
        //不输出： 抛出SkipPageException异常
        throw new SkipPageException();
    }
}

第二步：在web项目的WEB-INF目录下建立itcast.tld文件，这个tld叫标签库的声明文件。

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

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

  <description>自定义</description>
  <display-name>jjc</display-name>
  <tlib-version>1.1</tlib-version>
  <short-name>item</short-name>
  <uri>jiangjiacong</uri>

  <tag>
  <name>showIp</name>
  <tag-class>show.ShowIp</tag-class>
  <body-content>scriptless</body-content>
  </tag>

  <tag>
  <name>context</name>
  <tag-class>other.other</tag-class>
<!--   empt：表示没有标签体

JSP：表示标签体可以包含JSP代码

scriptless：表示标签体可以包含EL表达式和JSP动作元素，但不能包含JSP的脚本元素

tagdependent：表示标签体交由标签本身去解析处理。即在标签体中所写的任何代码都会原封不动地传给标签处理器 -->
  <body-content>scriptless</body-content>
   <!-- 属性声明 -->
    <attribute>
        <!-- 属性名称 -->
        <name>num</name>
        <!-- 是否必填 -->
        <required>true</required>
        <!-- 是否支持EL表达式 -->
        <rtexprvalue>true</rtexprvalue>
    </attribute>
  </tag>
</taglib>

注意：

<body-content>：是输出标签体内容格式

1. empt：表示没有标签体

2. JSP：表示标签体可以包含JSP代码

3. scriptless：表示标签体可以包含EL表达式和JSP动作元素，但不能包含JSP的脚本元素

4. tagdependent：表示标签体交由标签本身去解析处理。即在标签体中所写的任何代码都会原封不动地传给标签处理器

一般自定义标签都是scriptless

接下来 jsp页面要引用自定义标签：

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<%@taglib uri="jiangjiacong" prefix="item"%>
<!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>
<%Integer age=133;
pageContext.setAttribute("agevalue", age);
%>
<%-- <item:showIp>sdf</item:showIp> --%>
<item:context num="${agevalue}">${10>2 }<br/></item:context>

</body>
</html>

重点：

<%@taglib uri="jiangjiacong" prefix="item"%>