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代码,但不会执行。

你可能感兴趣的:(jsp,标签,自定义标签)