JSP自定义标签(jsp1.2)

原文出自:http://www.blogjava.net/liuwentao253/archive/2006/11/17/81694.html

作者:刘文涛

一、概述

       JSP中有一块重要的技术:自定义标签(Custom Tag)  。

1.优点:

取代了JSP中的Java程序,并且可以重复使用,方便不熟悉Java编程的网页设计人员。

2.开发流程:

(1) 编写JSP,在JSP中使用自定义标签。

(2) 在web.xml中指定JSP中使用的标签的.tld(标签库描述文件)文件的位置。也可不在web.xml中指定.tld文件

         位置,而在jsp页面中指定。

(3).tld文件中指定标签使用的类。

3. 自定义标签的分类:

(1)简单标签:如< mytag:helloworld/>

(2)带属性标签:如<imytag:checkinput dbname = “<myBean.getDBName()>”/>

(3)带标签体的标签:

在自定义标签的起始和结束标签之间的部分为标签体(Body)。Body的内容可以是JSP中的标准标签,也可以是HTML、脚本语言或其他的自定义标签。

< mytag:checkinput dbname  =  “ < myBean.getDBName() > >
      
< mytag:log message = ”Table Name” >
< mytag:checkinput  />

(4) 可以被Script使用的标签:

定义了id和type属性的标签可以被标签后面的Scriptlet使用。

< mytag:connection  id  =  “oraDB” type  =  “DataSource” name  =  “Oracle” >
<% oraDB.getConnection();  %>

4.接口及其他

实际上,自定义标签的处理类实现了Tag Handler对象。

JSP技术在javax.servlet.jsp.tagext中提供了多个Tag Handler接口,

JSP1.2中定义了Tag、BodyTag、IterationTag接口,
在JSP2.0中新增了SimpleTag接口。

JSP 还提供了上述接口的实现类TagSupport、BodyTagSupport和SimpleTagSupport(SimpleTagSupport只 在JSP2.0中才有)。BodyTagSupport实现了BodyTag、Tag和IterationTag接口。


SimpleTag 这个类在servlet.jar下面是没有的,可以在D:\Tomcat5\common\lib\jsp-api.jar下找到。




接口及其方法

Tag接口 代码 : 

 

 package   javax.servlet.jsp.tagext;

public   interface  Tag  {

     // 表示不用处理标签体,直接调用doEndTag()方法。
     int  SKIP_BODY  =   0 ;
     // 忽略标签后面的JSP内容。
     int  SKIP_PAGE  =   5 ;
     //  表示需要处理标签体。
     int  EVAL_BODY_INCLUDE  =   1 ;
     //  处理标签后,继续处理JSP后面的内容。
     int  EVAL_PAGE  =   6 ;

     void  setPageContext(javax.servlet.jsp.PageContext pageContext);

     void  setParent(javax.servlet.jsp.tagext.Tag tag);

    javax.servlet.jsp.tagext.Tag getParent();

     int  doStartTag()  throws  javax.servlet.jsp.JspException;

     int  doEndTag()  throws  javax.servlet.jsp.JspException;

     void  release();
} 
 


二、实验

1.试验介绍

下面的实验就是基于上述开发流程开发的。

(1)在JSP中指定taglib的uri:<%@ taglib uri="/helloworld" prefix="mytag" %>。

(2)在web.xml中配置tag-location:

 <taglib>
             <taglib-uri>/helloworld</taglib-uri>
             <taglib-location>/WEB-INF/helloworld.tld</taglib-location>
</taglib> 

 注:也可不在web.xml中配置,在JSP中指定taglib的uri:<%@ taglib uri="WEB-INF/helloword.tld " prefix="mytag" %>。

(3)在helloworld.tld 文件中定义实现标签的处理类:

<short-name>mytag</short-name>
    <tag>
       <name>helloworld</name>
       <tag-class>mytag.HelloWorldTag</tag-class>
       <body-content>empty</body-content>
   </tag>
 

( 4 ) 执行处理类mytag.HelloWorldTag的doStartTag和doEndTag方法,然后将结果输入到JSP中,和JSP中的内容一起输出。
实际上自定义标签和JSP中的其他的内容被WebServer一起编译成servlet。


2 .开始实验

2.1.编写JSP

<%@ page contentType="text/html; charset=GBK" %>
<%@ taglib uri="/helloworld"  prefix="mytag" %>

<html><head><title>jsp1</title></head>

<body bgcolor="#ffffc0">
<h1>下面显示的是自定义标签中的内容</h1>

<p></p>
<mytag:helloworld></mytag:helloworld>
</body>
</html> 
 

2.2.编写web.xml

<?xml version="1.0" encoding="UTF-8" ?>
<!--  edited with XMLSPY v5 rel.  4  U (http: // www.xmlspy.com) by Williams (501) -->
<! DOCTYPE web - app PUBLIC  " -//Sun Microsystems, Inc.//DTD Web Application 2.3//EN "  
 " http://java.sun.com/dtd/web-app_2_3.dtd " >

<web-app>
     <taglib>
         <taglib-uri>/ helloworld</taglib-uri>
         <taglib-location>/WEB-INF/helloworld.tld</taglib-location>
     </taglib>
</web-app>
 

2.3  编写tld文件

<? xml version="1.0"   encoding="ISO-8859-1" ?>
<! DOCTYPE taglib PUBLIC  " -//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN "    
" http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd " >

<taglib>
        <tlib-version>1.0</tlib-version>
        <jsp-version>1.2</jsp-version>
        <short-name>mytag</short-name>

        <tag>
                <name>helloworld</name>
                <tag-class>mytag.HelloWorldTag</tag-class>
                <body-content>empty</body-content>
        </tag>
</taglib>
 

 

2.4  编写标签实现类

package mytag;   

import java.io.IOException;
import javax.servlet.jsp.*;
import javax.servlet.jsp.tagext.*;

public class HelloWorldTag extends TagSupport{    
       public HelloWorldTag(){
      }

       public int doStartTag() throws JspTagException{
             return EVAL_BODY_INCLUDE;
      }

       public int doEndTag() throws JspTagException{
             try{
                  pageContext.getOut().write("Hello World");
            }catch(IOException ex){
                   throw new JspTagException("错误");
            }

             return EVAL_PAGE;
      }
} 
 

2.5  执行效果

部署到Tomcat的WebApps目录下,启动Tomcat,输入:http://localhost:8080/myjsp/hello.jsp

“Hello World”就是我们定义的标签部分的处理类输出的结果。

2.6  注意:

这个试验我做了2天,总是报错,弄得很是灰心,开始时以为tld文件或web.xml文件配置不正确,但怎么也找不到原因。

今晚我终于找到原因了,是因为.class文件一定要放在classes文件夹中,我放到了lib中。

.jar或servlet文件要放在lib目录中,而.class要放在classes目录中,如果要放到lib目录中,必须把mytag中的文件打包成.jar文件,然后把mytag.jar放到lib目录中。

JSP1.2的自定义标签,在JSP2.0中xml文件的格式变了。

 

 

======================以下是自己补充的=======================================

 

JSP2.0的标签有更简单的定义

博客JSP简单标签

写道
在Jsp2.0中定义SimpleTag 接口用于替换传统的标签开发的接口,它只有一个方法doTag() 用于取代传统的doStartTag()、doEndTag()、doAfterBody() 等方法。
1、 JSP引擎调用标签处理器对象的setJspContext(),将JSP页面的pageContext()对象传递给标签处理器对象。
2、 JSP引擎调用setParent(),将父标签处理器对象传递给标签处理器对象。
3、 如果调用标签设置属性,容器将每个属性对应的setter()方法把属性值传递给标签处理器对象。
4、 如果有标签体,容器将标签体封装为JspFragment对象,然后调用setJspBody()将JspFragment对象传递给标签处理器对象。
5、 调用doTag()方法执行标签逻辑。
  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值