自定义标签简介

 

自定义标签简介

一、自定义标签主要用于移除Jsp页面中的java代码

移除jsp页面中的java代码，只需要完成两个步骤：

       编写一个实现Tag接口的Java类，并覆盖doStartTag方法，把jsp中的java代码定到doStartTag方法中。

       编写标签库描述符（tld）文件，在tld文件中对自定义标签进行描述。

       完成以上操作，即可在JSP页面中导入和使用自定义标签。

 

<%   %>

<dhw:viewIP/>

自定义标签的创建步骤：

（1）标签处理器——java类，实现Tag接口

（2）创建一个.tld文件

JSP页面中作用自定义标签

       <hbsi:viewIP>

              ..................

       </hbsi:viewIP>

 

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

<!--

 Licensed to the Apache Software Foundation (ASF) under one or more

  contributor license agreements.  See the NOTICE file distributed with

  this work for additional information regarding copyright ownership.

  The ASF licenses this file to You under the Apache License, Version 2.0

  (the "License"); you may not use this file except in compliance with

  the License.  You may obtain a copy of the License at

 

      http://www.apache.org/licenses/LICENSE-2.0

 

  Unless required by applicable law or agreed to in writing, software

  distributed under the License is distributed on an "AS IS" BASIS,

  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

  See the License for the specific language governing permissions and

  limitations under the License.

-->

 

<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>A tag library exercising SimpleTag handlers.</description>

    <tlib-version>1.0</tlib-version>

    <short-name>hbsi</short-name>

    <uri>http://www.hbsi.edu.cn</uri>

    <tag>

   

        <name>viewIP</name>

    <tag-class>com.hbsi.web.tag.CusTagDemo1</tag-class>

    <body-content>empty</body-content>

    </tag> 

</taglib>

 

this.pageContext.getOut()  getSession()  getRequest()

<%@page

<%@include

%@taglib uri=”http://www.hbsi.edu.cn” prefix=”hbsi”%

二、Tag接口的执行流程

(1)通过doStartTag()的返回值决定是否处理标签体内容

返回值两个：Tag.EVAL_BODY_INCLUDE   Tag.SKIP_BODY

（2）通过doEndTag()的返回值决定是否继续处理jsp页面中该自定义标签

返回值两个：Tag.EVAL_PAGE    Tag.SKIP_PAGE

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方法。

三、自定义标签功能扩展

1、自定义标签除了可以移除Jsp页面中的java代码外，它还可以用于完成一些页面逻辑例如：

通过自定义标签可以控制jsp页面某一部分内容是否执行。          例如：<c:if>标签

通过自定义标签可以控制标签后的jsp页面是否执行。

通过自定义标签可以控制jsp页面某一部分内容重复执行。          例如：<c:foreach>标签

通过自定义标签可以修改jsp页面内容输出。

   2、tld文件中的四种标签体类型   EMPTY  JSP  scriptless  tagdepentend

初始化工作：

1)      将标签处理器实例化成对象

2)      调用标签处理器对象的setPageContext()将jsp页面的pageContext对象

3)      调用标签处理器对象setParent()将父标签对象做参数传递给标签处理器对象

4）调用doStartTag()，返回值决定是否要执行标签体

5）标签体的处理

6）调用doAfterBody()-----返回值可以决定是否要重复执行标签体的内容

7）调用doEndTag()

 

 

<hbsi:demo5>   ---doStartTag()方法返回值   EVAL_BODY_BUFFERED

       This is my example    封装在BodyContent对象  setBodyContent()

</hbsi:demo5>  ---doEndTag()  访问BodyContext对象

四、简单标签

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

setJspContext   setParent和getParent方法   setJspBody方法   doTag方法

1、SimpleTag方法介绍

setJspContext方法——用于把JSP页面的pageContext对象传递给标签处理器对象

setParent方法——用于把父标签处理器对象传递给当前标签处理器对象

getParent方法——用于获得当前标签的父标签处理器对象

setJspBody方法——用于把代表标签体的JspFragment对象传递给标签处理器对象

doTag方法——用于完成所有的标签逻辑，包括输出、迭代、修改标签体内容等。在doTag方法中可以抛出javax.servlet.jsp.SkipPageException异常，用于通知WEB容器不再执行JSP页面中位于结束标记后面的内容，这等效于在传统标签的doEndTag方法中返回Tag.SKIP_PAGE常量的情况。

2、SimpleTag接口方法的执行顺序

（1）当web容器开始执行标签时，会调用如下方法完成标签的初始化

WEB容器调用标签处理器对象的setJspContext方法，将代表JSP页面的pageContext对象传递给标签处理器对象。

WEB容器调用标签处理器对象的setParent方法，将父标签处理器对象传递给这个标签处理器对象。注意，只有在标签存在父标签的情况下，WEB容器才会调用这个方法。

如果调用标签时设置了属性，容器将调用每个属性对应的setter方法把属性值传递给标签处理器对象。如果标签的属性值是EL表达式或脚本表达式，则WEB容器首先计算表达式的值，然后把值传递给标签处理器对象。

如果简单标签有标签体，容器将调用setJspBody方法把代表标签体的JspFragment对象传递进来。

（2）执行标签时：容器调用标签处理器的doTag()方法，开发人员在方法体内通过操作JspFragment对象，就可以实现是否执行、迭代、修改标签体的目的。