[学习笔记]JSP自定义标签（1）

最新推荐文章于 2021-02-18 19:25:25 发布
最新推荐文章于 2021-02-18 19:25:25 发布
阅读量221 收藏
点赞数
分类专栏： JSP
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/u010388781/article/details/51167503
版权

一、引入标签


其实在JSP中我们已经使用过了几个标签，比如<jsp:forward>、<jsp:include>等；这些标签都是预先定义好的，如果我们需要自定义标签，就需要学习标签编程。

标签编程的优点就是灵活性+封装性。

灵活性体现在属性的赋值上，可以赋任意值。比如<jsp:forward page="A">   //A处可以赋任意的URL；

封装性体现在内部的行为的封装，因为标签是用一个类实现的，因此类的方法中能够包含任意复杂的动作。

因此标签是为了能够在JSP中使用尽可能少的Scriptlet；

比如：

[html]  view plain  copy
  1. <table>  
  2. <%  
  3.     for(int i=0;i<10;i++){  
  4. %>  
  5.     <tr>  
  6. <%  
  7.         for(int j=0;j<10;j++){  
  8. %>  
  9.         <td><%=i*j%></td>  
  10. <%  
  11.         }  
  12. %>  
  13.     </tr>  
  14. <%  
  15.     }  
  16. %>  
  17. </table>  

这个代码非常混乱，但是如果通过标签，从这段代码都封装在一个标签里，则代码就清晰了很多。


接下来是我通过标签封装后的JSP页面效果；

[html]  view plain  copy
  1. <%@ page contentType="text/html" pageEncoding="GBK"%>  
  2. <%@ taglib prefix="xiazdong" uri="xiazdong"%>  
  3. <html>  
  4.     <head>  
  5.         <title></title>  
  6.     </head>  
  7.     <body>  
  8.         <xiazdong:table row="5" col="3"/>  
  9.     </body>  
  10. </html>  

是不是大大缩短了呢??再来看看我在背后干了什么。。。。

TableTagSupport.java

[java]  view plain  copy
  1. package org.tagext;  
  2. import javax.servlet.jsp.tagext.*;  
  3. import javax.servlet.jsp.*;  
  4. public class TableTagSupport extends TagSupport{  
  5.     private String row;  
  6.     private String col;  
  7.     public String getRow(){  
  8.         return row;  
  9.     }  
  10.     public String getCol(){  
  11.         return col;  
  12.     }  
  13.     public void setRow(String row){  
  14.         this.row = row;  
  15.     }  
  16.     public void setCol(String col){  
  17.         this.col = col;  
  18.     }  
  19.     public int doStartTag()throws JspException{  
  20.         JspWriter out = super.pageContext.getOut();  
  21.         try{  
  22.             out.println("<table border=\"3\"> ");  
  23.             for(int i=0;i<Integer.parseInt(row);i++){  
  24.                 out.println("<tr>");  
  25.                 for(int j=0;j<Integer.parseInt(col);j++){  
  26.                     out.println("<td>"+i*j+"</td>");  
  27.                 }  
  28.                 out.println("</tr>");  
  29.             }  
  30.             out.println("</table>");  
  31.         }  
  32.         catch(Exception e){}  
  33.         return TagSupport.SKIP_BODY;  
  34.     }  
  35. }  

是不是很神奇。。。那接下来就看看实现的过程吧。

注意，在编写标签之前，必须把tomcat\lib中的jsp-api.jar文件配置在CLASSPATH中才可以；


二、基本标签编写


1、TagSupport类

如果要编写一个标签类，则必须继承javax.servlet.jsp.tagext.TagSupport；

TagSupport中提供了很多常用方法：

(1)    public int doStartTag()throws JspException;    //    标签开始时调用

能够返回SKIP_BODY(跳过标签体)、EVAL_BODY_INCLUDE(执行标签体)

(2)    public int doEndTag()throws JspException;    //     标签结束时调用

能够返回SKIP_PAGE(立刻停止执行)、EVAL_PAGE(JSP正常运行完毕)；

(3)    int SKIP_BODY;        // 跳过标签体

(4)    int EVAL_BODY_INCLUDE;    //执行标签体

(5)    int EVAL_BODY_AGAIN;    //  重复执行标签体，主要是因为集合迭代输出，只能在doAfterBody中使用；

(6)    public int doAfterBody()throws JspException;    //   执行完一次标签体后调用的函数；

能够返回SKIP_BODY(结束标签体)、EVAL_BODY_AGAIN(重复执行标签体)

(7)  JspWriter out = super.pageContext.getOut();//获取向网页输出的输出流;

举例讲述这些函数和常量代表什么意思：

[html]  view plain  copy
  1. <xiazdong:hello>                                <!--标签头 -->  
  2.         <h3><%="xiazdong"%></h3>            <!--    标签体-->  
  3. </xiazdong:hello>                                <!-- 标签尾-->  

执行流程如下：

(1)doStartTag();   <xiazdong:hello>时调用，如果是EVAL_BODY_INCLUDE,则继续；如果是SKIP_BODY,则执行(4)

(2)执行标签体；

(3)如果实现了doAfterBody，则执行；如果返回SKIP_BODY,则执行(4) ; 如果返回EVAL_BODY_AGAIN，则重复执行doAfterBody；

(4)doEndTag()：标签尾调用；


 2.制作无属性标签


为了清晰，我们以例子说明。

代码举例1：实现显示Hello world;


1.编写HelloTag.java


[java]  view plain  copy
  1. package org.tagext;  
  2. import javax.servlet.jsp.tagext.*;  
  3. import javax.servlet.jsp.*;  
  4.   
  5. public class HelloTag extends TagSupport{  
  6.     public int doStartTag()throws JspException{  
  7.         JspWriter out = super.pageContext.getOut();  
  8.         try{  
  9.             out.println("<h3>Hello world!!!</h3>");  
  10.         }  
  11.         catch(Exception e){}  
  12.         return TagSupport.SKIP_BODY;  
  13.     }  
  14. }  

注意点：

(1)javax.servlet.jsp.tagext.TagSupport,必须记住；

(2)JspWriter out = super.pageContext.getOut();

(3)public int doStartTag()throws JspException;必须记住；


2.编写xiazdong.tld 


tld文件是标签描述文件，是整个标签编程的核心，用来描述自定义的标签的名字、标签的实现类、是否有标签体、描述属性等；

一个tld文件其实类似于一个标签库，里面能够描述很多标签；每个标签都以

[html]  view plain  copy
  1. <tag>  
  2.     <name>hello</name>      <!--表示标签的名字 类似于<jsp:forward>中的forward-->  
  3.     <tag-class>org.tagext.HelloTag</tag-class>  <!--标签所在类 -->  
  4.     <body-content>empty</body-content>      <!--是否存在标签体-->  
  5. </tag>  

的形式描述；

*.tld文件的模版如下：（因为tld文件前面这些内容都不是很重要，因此可以直接复制黏贴）

[html]  view plain  copy
  1. <?xml version="1.0" encoding="UTF-8" ?>  
  2.   
  3. <taglib xmlns="http://java.sun.com/xml/ns/j2ee"  
  4.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
  5.     xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd"  
  6.     version="2.0">  
  7.     <tlib-version>1.0</tlib-version>  
  8.     //插入tag描述  
  9. </taglib>  


3.在web.xml中编写映射


编写映射的目的类似于给一个网页配置一个映射地址，为了方便访问；

比如本来需要访问/a/b/c/d/e/f/g/1.tld，这个路径非常麻烦，但是如果通过映射，我们可以只需要用"a"表示一长串的文件路径及名称；

[html]  view plain  copy
  1. <jsp-config>  
  2.     <taglib>  
  3.         <taglib-uri>xiazdong</taglib-uri>  
  4.         <taglib-location>/WEB-INF/classes/xiazdong.tld</taglib-location>  
  5.     </taglib>  
  6. </jsp-config>  


4.编写JSP页面并使用自定义的标签


<%@ taglib prefix=""   uri=""%>        prefix类似于<jsp:forward>中的jsp，uri中使用前面所说的映射；

[html]  view plain  copy
  1. <%@ page contentType="text/html" pageEncoding="GBK"%>  
  2. <%@ taglib prefix="xiazdong" uri="xiazdong"%>  
  3. <html>  
  4.     <head>  
  5.         <title></title>  
  6.     </head>  
  7.     <body>  
  8.         <h1><xiazdong:hello/></h1>  
  9.     </body>  
  10. </html>  


 3.制作有属性标签


其实制作有属性和制作无属性没有太大区别，


1.需要在原来的HelloTag.java 中加入属性.

如果做形如：<xiazdong:hello id="" format="" />的属性，则需要在HelloTag.java中添加两个属性，id属性和format属性；

形如：

[java]  view plain  copy
  1. class HelloTag extends TagSupport  
  2. {  
  3.     private String id;  
  4.     private String format;  
  5.     //setter和getter  
  6.     public int doStartTag()throws JspException{}  
  7. }  

在用户使用标签，并为id和format属性赋值时，会自动调用setter方法，将HelloTag类中的id和format赋值；


2.在tld文件中添加属性描述：


属性描述形如：

[java]  view plain  copy
  1. <body-content>empty</body-content>后面加上  
  2. <attribute>  
  3.     <name>name</name>       <!--属性姓名 -->  
  4.     <required>true</required>   <!--属性是否必要 -->  
  5.     <rtexprvalue>empty</rtexprvalue>    <!--是否支持表达式语言 -->  
  6. </attribute>  


代码实例：


HelloTag.java

[java]  view plain  copy
  1. package org.tagext;  
  2. import javax.servlet.jsp.tagext.*;  
  3. import javax.servlet.jsp.*;  
  4.   
  5. public class HelloTag extends TagSupport{  
  6.     private String name;  
  7.     private String age;  
  8.     public String getName(){  
  9.         return name;  
  10.     }  
  11.     public String getAge(){  
  12.         return age;  
  13.     }  
  14.     public void setName(String name){  
  15.         this.name = name;  
  16.     }  
  17.     public void setAge(String age){  
  18.         this.age = age;  
  19.     }  
  20.     public int doStartTag()throws JspException{  
  21.         JspWriter out = super.pageContext.getOut();  
  22.         try{  
  23.             out.println("<h3>姓名："+name+"</h3>");  
  24.             out.println("<h3>年龄："+age+"</h3>");  
  25.         }  
  26.         catch(Exception e){}  
  27.         return TagSupport.SKIP_BODY;  
  28.     }  
  29. }  


xiazdong.tld
需要加上attribute的描述：名字、是否必须、是否支持表达式语言
[java]  view plain  copy
  1. <?xml version="1.0" encoding="UTF-8" ?>  
  2.   
  3. <taglib xmlns="http://java.sun.com/xml/ns/j2ee"  
  4.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
  5.     xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd"  
  6.     version="2.0">  
  7.   <tlib-version>1.0</tlib-version>  
  8.   <short-name>x</short-name>  
  9.   <tag>  
  10.     <name>hello</name>  
  11.     <tag-class>org.tagext.HelloTag</tag-class>  
  12.     <body-content>empty</body-content>  
  13.     <attribute>  
  14.         <name>name</name>  
  15.         <required>true</required>  
  16.         <rtexprvalue>empty</rtexprvalue>  
  17.     </attribute>  
  18.     <attribute>  
  19.         <name>age</name>  
  20.         <required>true</required>  
  21.         <rtexprvalue>empty</rtexprvalue>  
  22.     </attribute>  
  23.   </tag>  
  24. </taglib>  

HelloTag.jsp
[html]  view plain  copy
  1. <%@ page contentType="text/html" pageEncoding="GBK"%>  
  2. <%@ taglib prefix="xiazdong" uri="xiazdong"%>  
  3. <html>  
  4.     <head>  
  5.         <title></title>  
  6.     </head>  
  7.     <body>  
  8.         <h1><xiazdong:hello name="xiazdong" age="20"/></h1>  
  9.     </body>  
  10. </html>  

三、IterationTag和Tag接口的区别


Tag接口只有一些最基本的标签编程方法，而IterationTag接口是用于迭代输出，比如EVAL_BODY_AGAIN等；
Dark_Tomcat
关注
  • 0
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
JSTL标签库-tomcat10-简化JSP中java代码
05-04
JSTL标签库-tomcat10-简化JSP中java代码
JSP自定义标签（1）
holoblog
11-17 104
一、引入标签 其实在JSP中我们已经使用过了几个标签，比如&lt;jsp:forward&gt;、&lt;jsp:include&gt;等；这些标签都是预先定义好的，如果我们需要自定义标签，就需要学习标签编程。 标签编程的优点就是灵活性+封装性。 灵活性体现在属性的赋值上，可以赋任意值。比如&lt;jsp:forward page="A"&gt; //A处可以赋任意的URL；...
自定义JSP标签示例
weixin_30402343的博客
01-26 52
我们以一个例子来讲解如何自定义JSP标签，假如我们需要在页面中输出当前的时间，按照最简单的JSP脚本，需要在JSP里面写很多Java代码，那么如何来使用自定义标签实现这个功能呢？ 首先，我们要先创建一个类，继承TagSupport类： 1 import java.io.IOException; 2 import java.text.SimpleDateFormat; 3 impo...
Jsp自定义标签之一搭建自己的自定义标签库
chuyue8203的博客
02-08 84
1、找一份tld模板，在%tomcat安装目录%\webapps\examples\WEB-INF\jsp2下 注：这里环境使用tomcat8 2、在web项目-->webapp-->WEB-INF目录下新建tld目录，将tld模板文件copy到该目录，并重命名为tag...
JSP深入学习
张议的博客
01-29 785
文章目录JSP简介JSP文件结构及主要标签JSP执行过程JSP语法概述脚本语法HTML注释和隐藏注释编译器指令声明表达式脚本段包含指令Page指令 Java Server Page(JSP) JSP简介 在传统的网页HTML文件（.htm，.html）中加入Java程序片段（Scriptlet）和JSP标签，就构成了JSP网页 Java程序片段可以操纵数据库、重新定向网页以及发送E-mail等，...
JSP自定义标签学习笔记
08-11
本人自行研究JSP自定义标签的学习笔记 目录如下： 目录 一、概述 1 1.1 使用简单标签机制 2 1.2 使用标签文件 3 二 、自定义标签简介 3 2.1 自定义标签概念 3 2.2 标签相关概念 3 2.3 如何创建自定义标签 3 三、自...
JSP学习笔记之基础语法
01-08
taglib指令：使用标签库定义新的自定义标签，在jsp页面中启动自定行为 page指令语法  <%@page 属性1=”属性值” 属性2=”属性值1,属性值2″ 属性n=”属性值n”%> jsp注释 在jsp页面的注释。 HTML的注释： &...
JSP网络编程学习笔记源代码 part2
02-08
第五篇为“标签语言和表达式语言”，主要讲述JSP的标签技术，JSP提供的标准标签库JSTL的用法及用户如何自定义自己的标签库；第六篇为“Web应用高级专题”，主要讲述Servlet过滤器、JSP异常处理、JSP日志、认证和安全...
自定义标签学习笔记
07-12
自定义标签学习笔记1
Jsp_Servlet学习课堂笔记
01-20
关于Jsp以及Servlet的学习笔记,包含有JavaBean 自定义标签库等等一系列重点的概念以及代码 绝对超值
jsp自定义标签Tag封装接口和实现方法
12-07
jsp自定义标签Tag封装接口和实现方法
JSP自定义标签(封装<select>标签)
11-26
JSP自定义标签,封装<select>标签,有两个属性,第一个属性是SQL select语句,只要语法准确,查询出来的数据就会自动加载到select标签,否则无法加载;第二个属性是标签的名称.绝对实用
简单JSP标签实现迭代
02-24
学习JSP标签的基础实例代码，包含了JSP标签技术需要的最基本的文件，便于理解JSP标签的底层实现。
自定义标签tld的使用
热门推荐
zsk
11-30 2万+
在JSP中使用标签是很平常的事情，在制作自定义标签时，通常都需要写tld文件来定义标签的各种属性，对应的java类，前缀等等。标签与tld文件紧紧相连，那么，到底应该怎么放置tld文件？在web.xml中怎么定义tld文件的位置？ 以下是具体的分析 Taglib的使用： 首先是在头部申明taglib, uri必须是web.xml定义的，或者是原始tld文件定义的。   然后便可以
JSP的三种数据封装（使用JavaBean）—— 标签、内省、BeanUtils工具类
cccrush的博客
12-04 2437
首先要知道什么是JavaBean：   JavaBean是一种遵循特点写法的Java类，通常遵循如下特点：         这个Java类必须要具有一个无参的构造方法         属性私有化         私有化的属性必须通过set、get的public方法暴露给其他程序，命名也要按照已有的规范 JavaBean在J2EE开发中，通常用于封装数据，对于遵循以上写法的JavaBea...
java jsp静态_java Web jsp页面的静态包含和动态包含
weixin_39574928的博客
02-18 165
现在有头 体 尾 三个jsp页面top.jsp我是top1111111111111页面body.jsp我是body页面footer.jsp我是footer页面静态包含main.jsp静态引入动态包含 main.jsp动态引入静态和动态包含的区别与联系注：下文将包含有其它文件的jsp文件称为主体文件，比如上文中的index.jsp文件。将被包含的文件称为包含文件，比如上文中的header.jsp文...
html 中的tr th td
thebesttome的专栏
10-18 4005
转帖地址：http://www.jzxue.com/wangyesheji/html/201104/26-7274.html 表格是html中经常使用到的，简单的使用可能很多人都没问题，但是更深入的了解的人恐怕不多，下面我们先来看一下如何使用。 是的上层标签 必须在一个里面
JSP基础和语法
代码啥东东
02-08 368
JSP(java server pages) 早期发展： 早期项目没有分层的概念，全部都是用jsp来完成，没有可维护性; 随着控制层从Model1体系中独立出来，jsp渐渐只作为视图组件，而现在很多新技术已经开始淘汰jsp; 概念： 服务端基于java语言的网页技术 语法特点： 把java程序以<%%>的形式，嵌入到html的页面中； JSP的执行特点 1.必须...
jsp代码
冷夜轩的博客
08-15 5064
jsp
jsp学习笔记（7）
最新发布
05-24
本篇笔记主要介绍JSP中的EL表达式和JSTL标签库。 一、EL表达式（Expression Language） EL表达式是JSP中一个非常重要的特性，它可以在JSP页面中方便地访问JavaBean中的属性和方法，同时还可以进行一些简单的运算...

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

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

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值