09.JSP自定义标签01

为什么要自定义开发标签?
相信很多人很好奇为啥有现成的标签库,还要去自定义开发标签,举个例子:我们在jsp使用修改时,传值给界面单选按钮是否选中,是这样的:

        <c:if test="${ name=='男' }">
        <input type="radio" checked="checked" value="男">
        </c:if>


那如果是爱好类型的复选框呢?爱好有几百种,打个比方,那页面上就全是标签代码了,所以,了解掌握自定义标签开发出适合自己项目的标签,可以减少多余的代码,页面更加直观简洁

标签的语言特点
我们比较常用的标签就是jstl标准标签库---->c标签,我们自定义jsp标签是在此基础上,开发出符合自己的标签使用,它有哪些语言特点,下面带大家看看:

        <开始标签 属性="属性值">标签体</结束标签>
        空标签 : <br/><hr/> <开始标签></结束标签> <开始标签/>


标签的类型大概有三种:

1.ui标签,例如:<c:out value=""></c:out>
2.控制标签,例如:<c:if test="">标签体</c:if>
3.数据标签,例如自定义的数据显示标签:<x:select/>,c标签的<c:set var="" value=""></c:set>


开发和使用步骤

2. 自定义标签的开发及使用步骤
  2.1 创建一个标签助手类(继承BodyTagSupport)
      标签属性必须与助手类的属性对应、且要提供对应get/set方法
      rtexprvalue

1.例如自定义一个<x:if test=" ">标签体</c:if>标签:
 

package com.zking.tag;

import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.BodyTagSupport;

public class IfTag extends BodyTagSupport{
    
    private boolean test;//属性
    
    public boolean isTest() {
        return test;
    }

    public void setTest(boolean test) {
        this.test = test;
    }

@Override
    public int doStartTag() throws JspException {
        //如果为真则计算主体输出,否则跳过主体
        return test ? EVAL_BODY_INCLUDE:SKIP_BODY;
    }
}

2.

  2.2 创建标签库描述文件(tld),添加自定义标签的配置
      注:tld文件必须保存到WEB-INF目录或其子目录
      jstl标签库

 <tag>
        <!-- 标签名 -->
        <name>if</name>
        <!-- 标签工具类 -->
        <tag-class>com.zking.tag.IfTag</tag-class>
        <!-- 标签的内容类型:empty表示空标签,jsp表示可以为任何合法的JSP元素 -->
        <body-content>jsp</body-content>
        <!-- 自定义标签的属性定义,请注意一定要在标签类中提供对应的get/set方法 -->
        <attribute>
            <!-- 自定义标签的属性名称 -->
            <name>test</name>
            <!-- true表示必填 -->
            <required>true</required>
            <!-- true支持动态值,可以向值里面填jsp表达式、EL表达式,false则不支持 -->
            <rtexprvalue>true</rtexprvalue>
        </attribute> 
    </tag>

类放导包:

 

 

 2.3 在JSP通过taglib指令导入标签库,并通过指定后缀访问自定义标签

从我们常用的·jstl核心标签库开始入手:

<%@taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>

如上,我们在使用c标签库时,不仅要导入jar包,还要在页面引入一行代码。接下来点击uri地址,我们可以看到:

<taglib xmlns="http://java.sun.com/JSP/TagLibraryDescriptor">
    <!-- 代表标签库的版本号 -->
    <tlib-version>1.0</tlib-version>
    <!-- 代表jsp的版本 -->
    <jsp-version>1.2</jsp-version>
    <!-- 你的标签库的简称 -->
    <short-name>z</short-name>
    <!-- 你标签库的引用uri -->
    <uri>/zking</uri>

在页面引入:

<%@ taglib uri="/zking" prefix="z" %>

3. 标签生命周期
  
  流程A:
                                      SKIP_BODY
  3.1  实例化标签助手类->doStartTag()------------->doEndTag()
       //主要用开发简单标签

  流程B:
                                      EVAL_BODY_INCLUDE         SKIP_BODY
  3.2  实例化标签助手类->doStartTag()------------->doAfterBody---------------->doEndTag()...
                                                              EVAL_BODY_AGAIN
  3.3  
  jrebal 热加载

  SKIP_BODY:跳过主体
  EVAL_BODY_INCLUDE:计算标签主体内容并[输出]
  EVAL_PAGE:计算页面的后续部分
  SKIP_PAGE:跳过页面的后续部分
  EVAL_BODY_AGAIN:再计算主体一次

 <%
        String[] students = {"彭玉","唐尼","黄蓉"};
        
        request.setAttribute("students",students);
                
    %>
    
    <c:forEach items="${students}" var="s" varStatus="vs">
        <z:out value="${s}">
        ${s},${vs.count}
        
        </z:out>
    </c:forEach>

 

package com.zking.tag;

import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.BodyTagSupport;

public class TestTag extends BodyTagSupport{

    private String name;
    
    
    
    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    /**
     * 在结束 标签时执行的动作
     * 返回值有两种结果
     * 1.计算页面的后续部分(默认): EVAL_PAGE
     * 2.SKIP_PAGE:跳过页面的后续部分
     */
    @Override
    public int doEndTag() throws JspException {
        System.out.println(" doEndTag().......");
        return EVAL_PAGE;
    }

    /**
     * 在开始 标签时执行的动作
     * 返回值有两种
     * 1.跳过标签体内容 SKIP_BODY
     * 2.计算标签体 并输出内容
     */
    @Override
    public int doStartTag() throws JspException {
        System.out.println("doStartTag");
        System.out.println("我的名字叫"+this.name);
        return EVAL_BODY_INCLUDE;
    }

}

 

如图:

 首先看x:if:
在开发时,首先仿照c:if分析:

x:If助手类:

<tag>
        <!-- 标签名 -->
        <name>if</name>
        <!-- 标签工具类 -->
        <tag-class>com.zking.tag.IfTag</tag-class>
        <!-- 标签的内容类型:empty表示空标签,jsp表示可以为任何合法的JSP元素 -->
        <body-content>jsp</body-content>
        <!-- 自定义标签的属性定义,请注意一定要在标签类中提供对应的get/set方法 -->
        <attribute>
            <!-- 自定义标签的属性名称 -->
            <name>test</name>
            <!-- true表示必填 -->
            <required>true</required>
            <!-- true支持动态值,可以向值里面填jsp表达式、EL表达式,false则不支持 -->
            <rtexprvalue>true</rtexprvalue>
        </attribute> 
    </tag>

 iftld配置

package com.zking.tag;

import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.BodyTagSupport;

public class IfTag extends BodyTagSupport{
    
    private boolean test;//属性
    
    public boolean isTest() {
        return test;
    }

    public void setTest(boolean test) {
        this.test = test;
    }
    
    @Override
    public int doStartTag() throws JspException {
        //如果为真则计算主体输出,否则跳过主体
        return test ? EVAL_BODY_INCLUDE:SKIP_BODY;
    }
}
 

<x:if test="true">男</x:if>
<x:if test="false">女</x:if>

x:out助手类:

    <tag>
        <!-- 标签名 -->
        <name>out</name>
        <!-- 标签工具类 -->
        <tag-class>com.zking.tag.OutTag</tag-class>
        <!-- 标签的内容类型:empty表示空标签,jsp表示可以为任何合法的JSP元素 -->
        <body-content>jsp</body-content>
        <!-- 自定义标签的属性定义,请注意一定要在标签类中提供对应的get/set方法 -->
        <attribute>
            <!-- 自定义标签的属性名称 -->
            <name>value</name>
            <!-- true表示必填 -->
            <required>true</required>
            <!-- true支持动态值,可以向值里面填jsp表达式、EL表达式,false则不支持 -->
            <rtexprvalue>true</rtexprvalue>
        </attribute> 
    </tag>
    

tld配置

package com.zking.tag;

import java.io.IOException;

import javax.servlet.jsp.JspException;
import javax.servlet.jsp.JspWriter;
import javax.servlet.jsp.tagext.BodyTagSupport;

public class OutTag extends BodyTagSupport{
    
    private Object value;//内容
    

    public Object getValue() {
        return value;
    }

    public void setValue(Object value) {
        this.value = value;
    }

    @Override
    public int doAfterBody() throws JspException {
        //out标签直接输出value内容
        JspWriter out = pageContext.getOut();
        try {
            out.print(value);
        } catch (IOException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        }            
        return SKIP_BODY;
    }
        
    @Override
    public int doEndTag() throws JspException {        
        return super.doEndTag();
    }

    /**
     * 默认为跳过标签体
     */
    @Override
    public int doStartTag() throws JspException {
        return EVAL_BODY_INCLUDE;
    }
}

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值