（JavaEE-10）自定义标签库

最新推荐文章于 2020-03-27 20:57:40 发布

weixin_34203426

最新推荐文章于 2020-03-27 20:57:40 发布

阅读量126

点赞数

CC 4.0 BY-SA版权

文章标签： java python

原文链接：https://my.oschina.net/raining0822/blog/289976

本文详细介绍了如何开发和应用自定义标签库，包括标签处理器类、tld文件、执行流程、功能扩展、简单标签库开发及使用方法。通过案例展示了如何实现防盗链、条件判断、迭代和HTML转义等功能。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

2019独角兽企业重金招聘Python工程师标准>>>

#自定义标签库开发

###自定义标签简介

自定义标签主要用于移除Jsp页面中的java代码
使用自定义标签移除jsp页面中的java代码，只需要完成以下两个步骤
- 编写一个实现Tag接口的Java类(标签处理器类)
- 编写标签库描述符（tld）文件，在tld文件中把标签处理器类描述成一个标签
- demo：查看JSP中的API，使用标签获取客户机IP（3步：编写一个Java类，继承TagSupport，重写父类方法，实现业务代码；编写一个tld文件描述该Java类，借鉴Tomcat中的例子；在页面导入该标签库，一般的，标签前缀与tld文件名称一致）

###自定义标签的执行流程

JSP引擎将遇到自定义标签时，首先创建标签处理器类的实例对象，然后按照JSP规范定义的通信规则依次调用它的方法
1. public void setPageContext(PageContext pc)， JSP引擎实例化标签处理器后，将调用setPageContext方法将JSP页面的pageContext对象传递给标签处理器，标签处理器以后可以通过这个pageContext对象与JSP页面进行通信
2. public void setParent(Tag t)，setPageContext方法执行完后，WEB容器接着调用的setParent方法将当前标签的父标签传递给当前标签处理器，如果当前标签没有父标签，则传递给setParent方法的参数值为null
3. public int doStartTag()，调用了setPageContext方法和setParent方法之后，WEB容器执行到自定义标签的开始标记时，就会调用标签处理器的doStartTag方法
4. public int doEndTag()，WEB容器执行完自定义标签的标签体后，就会接着去执行自定义标签的结束标记，此时，WEB容器会去调用标签处理器的doEndTag方法
5. public void release()，通常WEB容器执行完自定义标签后，标签处理器会驻留在内存中，为其它请求服务器，直至停止web应用时，web容器才会调用release方法

###自定义标签功能扩展

开发人员在编写Jsp页面时，经常还需要在页面中引入一些逻辑，例如：
- 控制jsp页面某一部分内容是否执行
- 控制整个jsp页面是否执行
- 控制jsp页面内容重复执行
- 修改jsp页面内容输出
自定义标签除了可以移除jsp页面java代码外，它也可以实现以上功能
- Tag接口
- IterationTag接口
- BodyTag接口
- 注意各个接口中方法的执行时机
tld文件中的四种标签体类型
- EMPTY JSP scriptless（不能使用脚本元素，包括JSP脚本、JSP声明、JSP表达式） tagdepentend（标签体的内容是给标签用的，不做输出打印）

Tag体系图

###简单标签库开发

由于传统标签使用三个标签接口来完成不同的功能，显得过于繁琐，不利于标签技术的推广， SUN公司为降低标签技术的学习难度，在JSP 2.0中定义了一个更为简单、便于编写和调用的SimpleTag接口来实现标签的功能。实现SimpleTag接口的标签通常称为简单标签。简单标签共定义了5个方法：

setJspContext方法
- 用于把JSP页面的pageContext对象传递给标签处理器对象
setParent方法
- 用于把父标签处理器对象传递给当前标签处理器对象
getParent方法
- 用于获得当前标签的父标签处理器对象
setJspBody方法
- 用于把代表标签体的JspFragment对象传递给标签处理器对象
doTag方法
- 用于完成所有的标签逻辑，包括输出、迭代、修改标签体内容等。在doTag方法中可以抛出javax.servlet.jsp.SkipPageException异常，用于通知WEB容器不再执行JSP页面中位于结束标记后面的内容，这等效于在传统标签的doEndTag方法中返回Tag.SKIP_PAGE常量的情况

###SimpleTag接口方法的执行顺序

当web容器开始执行标签时，会调用如下方法完成标签的初始化：
- WEB容器调用标签处理器对象的setJspContext方法，将代表JSP页面的pageContext对象传递给标签处理器对象
- WEB容器调用标签处理器对象的setParent方法，将父标签处理器对象传递给这个标签处理器对象。注意，只有在标签存在父标签的情况下，WEB容器才会调用这个方法
- 如果调用标签时设置了属性，容器将调用每个属性对应的setter方法把属性值传递给标签处理器对象。如果标签的属性值是EL表达式或脚本表达式，则WEB容器首先计算表达式的值，然后把值传递给标签处理器对象
  - 如果简单标签有标签体，容器将调用setJspBody方法把代表标签体的JspFragment对象传递进来
执行标签时：
- 容器调用标签处理器的doTag()方法，开发人员在方法体内通过操作JspFragment对象，就可以实现是否执行、迭代、修改标签体的目的

###JspFragment类

javax.servlet.jsp.tagext.JspFragment类是在JSP2.0中定义的，它的实例对象代表JSP页面中的一段符合JSP语法规范的JSP片段，这段JSP片段中不能包含JSP脚本元素
WEB容器在处理简单标签的标签体时，会把标签体内容用一个JspFragment对象表示，并调用标签处理器对象的setJspBody方法把JspFragment对象传递给标签处理器对象。JspFragment类中只定义了两个方法，如下所示：
- getJspContext方法
  - 用于返回代表调用页面的JspContext对象
- public abstract void invoke(java.io.Writer out)
  - 用于执行JspFragment对象所代表的JSP代码片段
  - 参数out用于指定将JspFragment对象的执行结果写入到哪个输出流对象中，如果传递给参数out的值为null，则将执行结果写入到JspContext.getOut()方法返回的输出流对象中。(简而言之，可以理解为写给浏览器)

###invoke方法详解

JspFragment.invoke方法是JspFragment最重要的方法，利用这个方法可以控制是否执行和输出标签体的内容、是否迭代执行标签体的内容或对标签体的执行结果进行修改后再输出。例如：
- 在标签处理器中如果没有调用JspFragment.invoke方法，其结果就相当于忽略标签体内容
- 在标签处理器中重复调用JspFragment.invoke方法，则标签体内容将会被重复执行
- 若想在标签处理器中修改标签体内容，只需在调用invoke方法时指定一个可取出结果数据的输出流对象（例如StringWriter），让标签体的执行结果输出到该输出流对象中，然后从该输出流对象中取出数据进行修改后再输出到目标设备，即可达到修改标签体的目的

标记处理器对象不会被重用，传统标记处理器会驻留在内存中以供后续使用

###开发带属性的标签

自定义标签可以定义一个或多个属性，这样，在JSP页面中应用自定义标签时就可以设置这些属性的值，通过这些属性为标签处理器传递参数信息，从而提高标签的灵活性和复用性。

要想让一个自定义标签具有属性，通常需要完成两个任务
- 在标签处理器中编写每个属性对应的setter方法
- 在TLD文件中描术标签的属性
为自定义标签定义属性时，每个属性都必须按照JavaBean的属性命名方式，在标签处理器中定义属性名对应的setter方法，用来接收JSP页面调用自定义标签时传递进来的属性值。例如属性url，在标签处理器类中就要定义相应的setUrl(String url)方法
在标签处理器中定义相应的set方法后，JSP引擎在解析执行开始标签前，会调用set属性方法，为标签设置属性
属性值只支持8中数据类型，如果是别的类型，就需要直接使用别的类型来传递值（如：Date类型，那么在页面可以通过 new Date()来传值）

案例：

开发防盗链标签
开发<c:if>标签
开发<c:if><c:else>标签
开发迭代标签
开发html转义标签
demo地址
打包标签库，新建一个普通的Java工程，将需要打包的类直接拷贝过去；创建META-INF文件夹，将tld文件拷贝进去。然后“导出”选择“jar”，完成。
Jar包打成exe文件

转载于:https://my.oschina.net/raining0822/blog/289976