java培训日志☆定制标签库

定制标签库

 

    一、自定义标签库的一般方法

 

1、html与jsp开发分离技术

 

在传统的JSP程序中，我们将HTML代码与Java代码混合在一起编写，这样虽然方便，但同时也导致页面难以维护，HTML开发人员和JSP开发人员负担加重。

怎样才能做到将HTML开发和JSP开发分离呢？其一是采用JavaBean组件编程技术，另一种形式则是使用标签（Tag）技术。

 

l         在JSP中使用JavaBeans来完成业务功能比直接在JSP页面中插入原始的Java程序要好得多，但是对页面的设计者来说要求熟悉Java程序编程（在JSP页面中对JavaBean中的各个属性和方法进行调用）。

l         通过使用标签技术，我们就可以在页面程序中不出现Java程序代码，并且可以对JavaBean中的各个功能进行标签化，然后页面的设计者通过使用标签来实现对 JavaBean中的后台处理程序进行调用。

 

这样，我们可以让HTML开发人员专注于页面的外观，而Java程序员则不用理会页面显示，专注于后台程序，大大提高了程序的可维护性和方便性。便于各程序员之间的协作开发。也即JSP程序员可以建立定制的标签和后端代码模块，而Web设计人员则可以使用定制标签并且全力关注于Web设计本身。

 

2、什么是标签库？ 

 

JSP标签库（也被称作定制标签）是一种通过JavaBean生成基于XML的脚本的方法。从概念上讲，标签就是很简单而且可重用的代码结构。

定制标签使得JSP项目中很容易创建重用的开放源代码模块。而你的全部需要不过就是标签库及其文档。

通过标记库可以定义出现在JSP页面中的作为类XML元素的自定义标签，可以把特定的Java代码与每个标记都关联起来。 例如，假定你可以访问一个天气情况数据库，而且你需要输出现在的天气状况。 那么，你可以在JSP中插入JDBC程序代码直接查询数据库（虽然这并不是一个好的选择），把这些代码封装到一个JavaBean内，或者把它包装成一个标记库。

 

使用标记库时的JSP页面内的程序代码看上去就像：

      

       ＜%@taglib uri="the TLD file" prefix="foo" %＞

       Current weather is ＜foo:Weather/＞

 

注意在上述程序代码中看不到任何Java代码的踪迹。 作为一个页面设计人员，你使用一种熟悉的语法就像＜foo:weather/＞，这些与其它的任何标记看起来非常相似。 在页面中包含现在的天气状况的HTML字符串的地方插入它。

 

3、标签库的重要特性

 

l         易于安装在多个项目上

标签很容易从一个JSP项目迁移到其他项目。一旦建立了一个标签库，你只需要把这个标签库包装成一个JAR文件就可以在其他JSP项目中重新使用了。不能重用的是你作为程序员在建立标签时所加进标签的内容。因为标签可以重新使用，所以标签库可以轻松地用于你自己的项目。目前，最好的标签资源可以在JSPTags.com这个站点找到。.

l         扩展JSP

标签库可以具备JSP规范(JSP 1.2)中的任何特性和功能。这也意味着你拥有了无限的能力可以扩展和增加JSP的强大功能却无需等待新版本JSP的发布。所以说，你完全可以取消页面上的JSP include调用了——只需用include标签建立自己的规范就可以了。

l         易于维护

标签库使得JSP Web应用程序变得很容易维护

。

例如：你可能有如下的一个标签，它让你的文本都显示蓝色：

My Text

但是随着项目的进行，你又想让蓝色变暗。于是你保留自己的标签但是为其增加了一个新的属性：shade

My Text

    所有的老标签继续显示蓝色，但现在你可以使用同一标签来产生变暗的蓝色文本了。

 

4、使用标签库taglib技术简化程序设计

 

、等均为HTML中的标签，而是一个标签库中的某个标签，其中Jsp为该标签库的库名，forward为标签名称。

在JSP中，一个标签看起来很象一个标准的HTML标签。但是，它的逻辑不在客户端被执行，而是由服务器端的Servlet来转换。每个标签被封装到一个独立的类，它的名字和参数属性被一个特殊的.tld扩展名的部署描叙文件中来指出。

通过使用标签库技术也能使网页设计师不用编程JSP的Java代码就操作复杂的数据库和事务等。特别适用于需要重复使用某一段程序的地方。

 

5、定制标签的编程实现步骤：

 

l         JavaBean：为了充分利用Java的面向对象特性，重用代码应当放置在独立的代码容器内。这些JavaBean可不是标签库的一部分。它们是标签库用来执行所分配任务的基础代码模块（可以将这些*.class文件发布为JAR文件）。

l         标签库描述符（TLD文件）：这是一种很简单的XML文件，TLD文件描述和说明了属性、信息和标签处理器文件位置等信息。JSP 容器使用这一文件来映射被调用标签库的位置和用法。

l         Web站点的web.xml文件：其实这就是你的Web站点上的初始化文件。在这个文件内你可以定义Web应用程序中使用的定制标签，还可以定义用来描述每个定制标签的TLD文件。

l         JSP页面上的标签库声明：仅需使用标签库标示符即可方便地声明页面上存在的标签。标签库在页面上声明之后，你就可以随意使用它们了。

 

6、不带属性和标签体的简单标签的开发例

 

JSP标签的开发需要编写两种独立的文件。一种是定义标签功能的java类文件，一种是将xml元素名称（标签）映射到标签实现的标签库描述符文件。

 

（1）编写标签处理程序的JAVA类文件( TAG处理器)

 

当一个JSP引擎遇到一个定制的标签时，它首先检查是否能够确定这个标签类的物理位置。如果能够确定，就会执行标签类中对应的代码。

该标签类的Java文件执行由标签所标示的具体工作，并应该被放置在WEB-INF下的classes目录或者其下的某一子目录（取决于是否有包的定义）下。标签类通常页可以被制作成一个JAR文件，放置在WEB-INF目录下的lib目录中。

需要在tld标签库描述文件里的每个TAG标签中指明是应用哪一个类文件来对这个TAG进行处理。

 

/*

在JCreator中编译该程序时要注意:由于在JDK.14中

并没有包含javax.servlet.jsp.*、javax.servlet.jsp.tagext.*等包，

应该在JCreator中引入这些包，这些包可以从

Tomcat\common\lib\jsp-api.jar和servlet-api.jar文件

*/

package jspTagLib;

import javax.servlet.jsp.*;

import javax.servlet.jsp.tagext.*;

import java.io.*;  

 

public class JSPTagTest extends TagSupport

{

    public int doStartTag()     //程序的执行起始点

    {

        try

        {

/*

    out是一个JspWriter类型的隐含对象，

用于向jsp网页输出内容。输出的目标由pageContext.getout提供 ,

其中pageContext是TagSupport类中的一个PageContext类的对象

*/         

            JspWriter out=pageContext.getOut();

            //向jsp网页上下文输出

            out.println("这是定制JSP标签所输出的文字");            }

        catch(Exception e)

        {

                System.out.println("tag err!");

        }

     //由于没有标签体,因此返回SKIP_BODY，表示标签功能已执行完成

    return(this.SKIP_BODY);

    }      

}

编程要点：

 

（1）需要继承javax.servlet.jsp.tagext.TagSupport类并重写doStartTag方法。JSP服务器引擎当它第一次遇到这个标记的时候，引擎就会调用doStartTag ()方法。

l         可以使这个方法为空或者当需要的时候才执行应用程序逻辑。

l         当该方法返回SKIP_BODY时，那么引擎跳过这个标记体。

l         当它返回EVAL_BODY_INCLUDE时，引擎将会处理这个标记以及它的子标记。

 

（2）在JCreator中编译该程序时要注意:由于在JDK.14中并没有包含javax.servlet.jsp.*、javax.servlet.jsp.tagext.*等包，应该在JCreator中引入这些包，这些包可以从Tomcat\common\lib\jsp-api.jar和servlet-api.jar文件获得

 

（3）将编译好的class文件放于服务器的WEB-INF下的classes目录下（由于该Java程序有包的定义，因此应该将它的*.class文件放在WEB-INF\classes\jspTagLib目录下，其中jspTagLib为包名）。

注意：

l         只需要将该JSPTagTest.java文件放在WEB-INF\classes目录下，然后对它进行编译将自动会形成上述目录位置。

l         也可以将标签类的文件制作成一个JAR文件，放置在WEB-INF目录下的lib目录中。

 

（4）编写标签库描述符TLD文件（Tag Library Descriptor，文件扩展名为*.tld）

 

通过该文件实现将标签名和其代表的功能实现联系在一起，它规定了标签和Java程序类的映射关系，由容器解释；它是标准的XML格式的标记定义文件，可以定义标签和它的各种属性（包括它的名称，版本和其它的任选信息）和处理文件等等；

文件名：目录WEB-INF/taglib

JSPTageTest.tld

 

    "">

标签库的版本

   

      1.0

这个标签库要求的JSP版本

      1.1                     

 

自定义标签前缀名

      userTag                       

          

标签描述符文件的uri，可以是空

     

 

      标签库的使用描述信息                        

标签库的使用描述信息

自定义的标签

 

                                      

 

处理这个标签的java类的名字可以（包含有包的名称），不同的标签可能对应不同的java类来处理

自定义的标签名

        JSPTagTest                     

 

         jspTagLib.JSPTagTest   

 

        标签的描述信息                

标签的描述信息

     

   

 

注意：只有黑体的两句最重要，其他就照抄；该文件需要放置在WEB-INF目录或其子目录下。

对WebLogic也是一样的要求

相对于/WEB-INF目录

 

（5）修改WEB-INF目录下的web.xml文件以定位标签的*.tld文件

 

在web-app之间添加如下的项目：

 

    /taglib/JSPTagTest.tld       

   

        /WEB-INF/taglib/JSPTagTest.tld       

自定义的标签库名的前缀，请不要用jsp, jspx, java, javax, servlet, sun, 和sunw做为你的前缀

进行标记使用声明，声明此JSP文件使用了自定义的标签，同时引用标签库，也指定了他们的标签的前缀。

   

 

 

（6）在JSP页面中使用以上自定义的标记

<%@ taglib uri="/taglib/JSPTagTest.tld" prefix="userTag" %>

应该与前面*.tld文件中的name声明的标签名保持相同