自定义标签库

一、简介

    1、自定义标签主要用于移出JSP页面中的Java代码。

    2、使用自定义标签移除JSP页面中的Java代码，只需要完成以下两个步骤：

• 编写一个实现Tag接口的Java类（标签处理器类）；
• 编写标签库描述符（tld）文件，在tld文件中对标签处理器类进行描述。

    3、Tag接口的执行流程：

       JSP引擎在遇到自定义标签时，首先创建标签处理器类的实例对象，然后按照JSP规范定义的通信规则一次调用他的方法。

• public  void  setPageContext（pageContext  pc），JSP引擎实例化标签处理器类后，将调用setPageContext()方法将JSP页面的pageContext对象传递给标签处理器类，传递给标签处理器以后可以通过pageContext对象与JSP页面进行通信。
• public  void  setParent（Tag  t），setPageContext执行完后，web容器接着调用setParent方法，将当前标签的父标签传递给当前标签处理器类，如果当前标签没有父标签，则传递给setParent方法的参数值为null。
• public  int  doStartTag（），调用setPageContext方法和setParent方法之后，web容器执行到自定义标签的开始标记时，就会调用标签处理器的doStartTag方法。
• public  int  doEndTag（），web容器执行完自定义标签的标签体后，就会接着去执行自定义标签的结束标记，此时web容器会调用标签处理器的doEndTag方法。
• public  void  release（），通常web容器执行完自定义标签后，标签处理器会驻留在内存中，为其他程序请求服务器，直至停止web应用时才会调用release方法。

                                                           

二、自定义标签的功能扩展

    1、开发人员在编写JSP页面时，经常还需要在页面中引入一些逻辑，例如：

• 控制JSP页面某一部分是否执行；
• 控制整个JSP页面是否执行；
• 控制JSP页面内容重复执行；
• 修改JSP页面内容输出；

     2、自定义标签除了可以移除JSP页面中的Java代码外，也可以实现以上四种功能。

     3、tld文件中的四种标签体类型：

         EMPTY     JSP     scriptless     tagdependent

三、简单标签

    1、SimpleTag方法介绍

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

• setJspContext方法：用于把JSP页面的pageContext对象传递给标签处理器对象；
• setParent和getParent方法：用于将父标签处理器对象传递给标签处理器类，以及获取当前标签的父标签处理器对象；
• setJspBody方法：用于把代表标签体的JspFragment对象传递给标签处理器对象；
• doTag方法：用于完成所有的标签逻辑，包括输出、迭代、修改标签体内容等。在doTag 方法中可以抛出javax.servlet.jsp.SkipPageException异常，用于通知web容器不再执行JSP页面中共位于结束标记后面的内容。等同于传统标签汇总doEndTag方法中TagSKIP_PAGE常量。

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

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

• web容器调用标签处理器对象的setJspContext方法，将代表JSP页面的pageContext对象传递给标签处理器对象；
• web容器调用标签处理器对象的setParent方法，将父标签对象传递给这个标签处理器对象。（注意：只有在标签存在父标签的情况下，web容器才会调用这个方法。）
• 如果调用标签时设置了属性，容器将调用每个属性对应的setter方法把属性值传递给标签处理器对象。如果标签的属性值是EL表达式或脚本表达式，则web容器首先计算表达式的值，然后把只传递给标签处理器对象；
• 如果简单标签有标签体，容器将调用setJspBody方法把代表标签体的JspFragment对象传递尽量。
  

        执行标签时：

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

    3、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对象的执行结果写入到那个输出流对象中，如果参数的值为null，则执行结果写入到JspContext.getOut方法返回的输出流对象中，简单地说是写给浏览器）

   4、invoke方法详解

      JspFragment.invoke方法是JspFragment最重要的方法，利用这个方法可以控制是否执行和输出标签体的内容，是否迭代执行标签体的内容，或对标签体的执行结果修改在后再输出。例如：

• 在标签处理器中，如果没用调用invoke方法，其结果相当于忽略标签体的内容；
• 在标签处理器中，重复调用invoke方法，则标签体内容会被重复执行；
• 若想在标签处理器中修改标签体内容，只需要在调用invoke方法时，制定一个可取出数据结果的输出流对象（例如StringWriter），让标签体的执行结果输出到该输出流对象中，然后从该输出流对象中取出数据进行修改后再输出到目标设备，即可达到修改标签体的目的。

四、开发带属性的标签

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

       要想让一个自定义标签具有属性，通常需要完成两个任务：

• 在标签处理器中，编写每个属性的setter方法；
• 在TLD文件中描述标签的属性。
  

      为自定义标签定义属性时，每个属性都必须按照JavaBean的属性命名方式，在标签处理器中定义属性名对应的setter方法，用来接收JSP页面调用自定义标签时传递进来的属性值。例如属性url，在标签处理器类中就要定义相应的setURL（String  url）方法。

      在标签处理器中定义相应的set方法后，JSP引擎在解析执行开始标签前，也就是调用doStartTag方法前，会调用set属性方法为标签设置属性。

                            

      使用标签控制页面逻辑案例：

• 开发防盗连标签
• 开发<c：if>标签
• 开发<c：if><c：else>标签
• 开发迭代表情
• 开发html转移标签
• 打包标签库

五、JSTL标签库

    1、<c：out>标签

              <c：out>标签用于输出一段文本内容到pageContext对象当前保存的out对象中。  

           

   2、<c：set>标签

             <c：set>标签用于把某一个对象存在指定的域对象中，或者设置web域中的java.util.Map类型的属性对象，或JavaBean类型的属性对象的属性。

            

   3、<c：remove>标签

               <c：remove>标签用于删除各种web域中的属性。

               语法格式：<c:remove var="varName"    [scope="{page|request|session|application}"] />
 

    4、<c：catch>标签

                <c：catch>标签用于捕获嵌套在标签体中内容抛出的异常。

                语法格式：<c:catch [var="varName"]>nested actions</c:catch>

                var属性用于标识<c:catch>标签捕获的异常对象，它将保存在page这个Web域中。

               

    5、<c:if>标签

               <c：if  test="">标签可以构造简单的"if-then"结构的条件表达式。

              

   6、<c:choose>标签

                <c:choose>标签用于多个条件的组合边界，它必须与<c:when>和<c:otherwise>标签一起使用，使用<c:choose>，<c:when>和<c:otherwise>三个标签，可以构造类似 “if-else if-else” 的复杂条件判断结构。

               

   7、<c:forEach>标签

                <c:forEach>标签用于对一个集合对象中的元素进行循环迭代操作，或者按指定的次数重复迭代执行标签体中的内容。

              

   8、<c:param>标签

                在JSP页面进行URL的相关操作时，经常要在URL地址后面附加一些参数。<c:param>标签可以嵌套在<c:import>、<c:url>或<c:redirect>标签内，为这些标签所使用的URL地址附加参数。
                 <c:param>标签在为一个URL地址附加参数时，将自动对参数值进行URL编码，例如，如果传递的参数值为“中国”，则将其转换为“%d6%d0%b9%fa”后再附加到URL地址后面，这也就是使用<c:param>标签的最大好处。

   9、<c:url>标签

               <c:url>标签用于在JSP页面中构造一个URL地址，其主要目的是实现URL重写。URL重写就是将会话标识号以参数形式附加在URL地址后面 

              

   10、<c:redirect>标签

                 <c:redirect>标签用于实现请求重定向