jsp自定义标签

 自定义JSP标签概述

•自定义JSP标签就是程序员定义的一种JSP标签，这种标签把那些信息显示逻辑封装在一个单独的Java类中，通过一个XML文件来描述它的使用。当页面中需要使用类似的显示逻辑时，就可以在页面中插入这个标签，从而完成相应的功能。

•使用自定义标签，可以分离程序逻辑和表示逻辑，将Java代码从HTML中剥离，便于美工维护页面；自定义标签也提供了可重用的功能组件，能够提高工程的开发效率。

自定义JSP标签的执行过程

•当一个含有自定义标签的JSP页面被JSP引擎(Web容器)转译成Servlet时，JSP引擎遇到自定义的标签，会把这个自定义标签转化成对一个称为“标签处理类”的调用。之后，当这个JSP页面被执行时，JSP引擎就会调用这个“标签处理类”对象，并执行其内部定义的相应操作方法，从而完成相应的功能。

自定义JSP标签的开发流程

•使用Java处理类来开发自定义JSP标签时，主要分为下几个步骤。

–创建标签的处理类(TagHandle Class)。这个类用来定义标签的行为，并在JSP引擎遇到自定义标签时调用执行。

–创建标签库描述文件(TagLibrary Descriptor File)。

–在web.xml文件中声明TLD的位置。在JSP1.2以上规范中此步骤是可选的。

–在JSP文件中用taglib指令引入标签库，然后使用标签库描述文件中指定的标签名来使用它。

标签库描述符

•标签库描述符文件是一个以“.tld”结尾的标准XML文档，用来记录一个标签库内拥有哪些标签、每个标签包含哪些属性。

•以下是一个JSP 2.0规范的标签库描述文件的内容：

•<taglib>元素是标签库描述符的根元素，它包含12个子元素，详细介绍如下。

–(1)<description>：标签库的一个文本描述。

–(2)<tlib-version>：指定标签库的版本。

–(3)<short-name>：为标签定义简短的名字，在taglib指令中可作为首选的前缀名使用。

–(4)<uri>：定义一个URI，用于唯一地标识此标签库。

–(5)<tag>：用于指定自定义标签的相关信息。

–(6)<display-name>：为标签库指定一个简短的别名。

–(7)<small-icon>：为标签库指定大小为16×16的小图标(gif或jpeg格式)，该图标可在图形界面工具中显示。

–(8)<large-icon>：为标签库指定大小为32×32的大图标(gif或jpeg格式)，该图标可在图形界面工具中显示。

–(9)<validator>：为标签库提供一个验证器。

–(10)<listener>：为标签库提供一个监听器。

–(11)<tag-file>：用于描述标签文件。

(12)<function>：用于指定在表达式语言中使用的函数

用TagSupport类开发自定义标签

•示例：将集合对象中的所有元素遍历并显示出来

•如果不使用自定义标签的话，就需要在页面中通过嵌入一段代码片段(<%... %>)，在代码片段中用迭代器Iterator或for循环来完成显示。

•现在我们用自定义标签来完成这个功能。自定义标签：

–<q:loop items='<%= pageContext.getAttribute("coll")%>'var="str">

–<%= pageContext.getAttribute("str")%><br/>

–</q:loop>

•功能：把pageContext中存放的名为“coll”的集合取出并进行遍历。

用BodyTagSupport类开发自定义标签

•BodyTagSupport类中增加了两个方法：

–setBodyContent(BodyContent bc)：容器在执行这个标签处理类的实例时，将调用该方法，把标签主体返回的内容缓存在BodyContent类的实例中。BodyContent除了从父类JspWriter继承提供用于向响应体中写入文本的方法，还提供了用于获取它缓冲的标签体内容。

–doInitBody()：计算标签主体之前调用该方法进行初始化共，可以向bodyContent对象中写入初始内容，这些内容会放置在标签主体内容之前。

•BodyContent类专门用于缓存标签主体返回的内容，包括静态文本以及由嵌套标签或脚本元素所创建的动态内容。 

SimpleTagSupport类的生命周期

•SimpleTagSupport的生命周期各个阶段的具体执行过程：

–当JSP容器遇到自定义标签时，JSP容器会调用标签处理类的默认构造方法建立一个标签处理类实例。

–实例创建后，JSP容器会调用 setJspContext()方法，并以一个JspContext实例的形式提供上下文信息。如果是一个嵌套的标签，还将调用setParent()方法。

–然后，容器会调用该标签中所定义的每个属性的set方法。

–由容器调用setJspBody()方法，将该标签的主体设置为JspFragment实例。如果标签主体是空的，则将null值传递到setJspBody()。

–接下来，由容器调用doTag()方法。标签要实现的所有逻辑、循环、主体赋值等都在该方法中发生。

–在doTag()方法返回后，标签处理类中所有的变量都是同步的。

•示例：用SimpleTagSupport类开发自定义标签，实现一个能把标签主体内容转成大写并按指定次数循环显示的自定义标签。该标签的用法：
<q:mySimpleTag counts="3">${str}<br/></q:mySimpleTag