Chinaunix首页 | 论坛 | 博客

喜欢编程的鱼

首页　| 　博文目录　| 　关于我

oop_ming

  • 博客访问： 1967063
  • 博文数量： 606
  • 博客积分： 9991
  • 博客等级： 中将
  • 技术积分： 5725
  • 用 户 组： 普通用户
  • 注册时间： 2008-07-17 19:07
文章分类

全部博文（606）

文章存档

2011年（10）

2010年（67）

2009年（155）

2008年（386）

我的朋友
最近访客
推荐博文
JSP自定义标签学习

分类：

2008-08-13 21:53:58

自定义标签的最大的特点:

利用 自定义标签，软件开发人员和页面设计人员可以独立地自由工作.页面设计人员可以把精力集中在使用标签(HTML,XML或者JSP)创建网站上,而软件开发人员则可以将精力集中在实现底层功能上面,若国际化等等,这样,页面设计人员可以使用自定义标签的形式来实现具体的功能.

下面我们来指定一个简单的标签，步骤如下
  1. 扩张TagSupport
  2. 写自定义Tag的tld文件
  3. web.xml中指定你的tld文件
  4. 在JSP页面使用自定义标签

  • 扩张TagSupport
        说明:
                一般不会去实现Tag接口，而是通过TagSupport类是实现了Tag的接口继承过来的字段，这些字段用做public int               doStartTag()，public int doEndTag()返回值
                Tag.EVAL_BODY_INCLUDE 包含主体内容
                Tag.SKIP_BODY     不包含主体内容
                Tag.EVAL_PAGE      包含后面的页面内容
                Tag.SKIP_PAGE     不包含主体的内容    
实现一个简单实现代码：
java 代码
 
  1. package com.mercyblitz;  
  2. import java.io.IOException;  
  3. import javax.servlet.jsp.JspException;  
  4. import javax.servlet.jsp.JspWriter;  
  5. import javax.servlet.jsp.tagext.TagSupport;  
  6.   
  7. public class MyTags extends TagSupport {  
  8.     public int doStartTag()throws JspException  
  9.     {  
  10.         JspWriter out=pageContext.getOut();  
  11.         try  
  12.         {  
  13.             out.println("Hello,World"); //页面中显示的内容  
  14.         }catch(IOException e)  
  15.         {  
  16.             throw new JspException(e);  
  17.         }  
  18.         return SKIP_BODY; //不包含主体内容  
  19.     }  
  20. }  

  • 写自定义Tag的tld文件
xml 代码
 
  1. xml version="1.0" encoding="UTF-8"?>  
  2. >  
  3. <taglib>  
  4.   <tlibversion>tlibversiontlibversion>    
  5.   <jsp-version>1.2jsp-version>    
  6.   <tag>  
  7.     <name>tagsname>    
  8.     <tagclass>com.mercyblitz.mytagstagclass>    
  9.   tag>  
  10. taglib>  
         标签库元素属性:表格如下
        
属性表格
属性 描述
tlib-version 本标签库实现版本
jsp-version 标签库依赖的JSP版本
short-name 被JSP创作工具使用的一个短的默认名词
uri 指定这个标签库的uri信息
display-name 被工具使用的显示用的名字
small-icon 被工具使用的小图标
large-icon 被工具使用的大图标
description 本标签的描述
validator TLD验证信息
listener 实践监听器规范
        tag标签相关属性：
tag标签相关属性表
属性 描述
name tag标签唯一的名称
tag-class tag标签的处理类
tei-class tag标签的TagExtraInfo类
body-content 标签主体的内容
display-name 显示的名称
small-icon 被工具使用的小图标
large-icon 被工具使用的大图标
description 本标签的描述
variable 脚本变量的信息
attribute 标签属性的信息
            这些呢，是为以后高级内容说要提到的！
  • web.xml中指定你的tld文件
    xml 代码
     
    1. xml version="1.0" encoding="UTF-8"?>  
    2. <web-app version="2.4"   
    3.     xmlns=""   
    4.     xmlns:xsi=""   
    5.     xsi:schemaLocation="   
    6.     /web-app_2_4.xsd">  
    7.     <welcome-file-list>  
    8.        <welcome-file>/WEB-INF/mytag.jspwelcome-file>   
    9.     welcome-file-list>  
    10.     <jsp-config>  
    11.           <taglib>  
    12.         <taglib-uri>http://mercyblitz.blog.ccidnet.com/taglibs.tldtaglib-uri>   
    13.       taglib>  
    14.     jsp-config>  
    15. web-app> 
  • 页面部署：mytag.jsp
    html 代码
     
    1. <%@ page language="java" import="java.util.*" pageEncoding="GBK"%>  
    2. <%@ taglib uri="http://mercyblitz.blog.ccidnet.com/taglibs.tld" prefix="out" %>  
    3. <html>  
    4.   <head>  
    5.     <title>mytag.jsptitle>  
    6.   head>    
    7.   <body>  
    8.     <out:tags/> 
    9.   body>  
    10. html>  
 
 
BodyTag接口
    接口BodyTag的实现类,它是负责操作主体内容(bodyContent).
定义方法:public void doInitBody();
    public int doAtferBody();
提示,那些在doStartTag()方法之后被调用的方法依赖于doStartTag()方法返回值并且看在JSP页面上是否自定义Action元素,而不是怎样在TLD文件中去申明
    在TLD文件中, 若empty的话,doStartTag()方法只能返回SKIP_BODY
    body-content有三个可选值：empty , JSP , tagdependent
    若没有设置的话,那么doStartTag()可以返回SKIP_BODY, EVAL_BODY_INCLUDE, or EVAL_BODY_BUFFERED.
返回值的说明:

    若SKIP_BODY返回的情况下,body不会被evaluated并且doEndTag()被调用;

    若EVAL_BODY_INCLUDE 返回,并且自定义action元素不为空的时候,那么doInitBody(),setBodyContent()不会被调用,而body evaluated并且"通过"当前的out对象,还有当action元素为空的时候,只有doStartTag(),doEndTag();
   
    当EVAL_BODY_BUFFERED 返回,并且自定义的action元素不为空的时候,setBodyContent(),doInitBody()被调用,body被evaluated,doAfterBody()被调用,直到大于0次迭代后,doEndTag()才被调用,还有当action元素为空的时候,只有doStartTag(),doEndTag();
主题内容
   1.自定义标记通常需要操控自己的主体内容,例如数据库查询需要将其主题内容解释为SQL
       
    2.工作方法
    servlet容器包含BodyContent对象栈,servlet容器在doStartTag()方法之后调用PageContext.pushBody(),就是说把当前的主体内容推入栈中,其中out变量重定向到当前的主体内容实例主题内容,保留一个到JspWriter对象的引用,即前一个输出,JspWriter将数据写入响应流中.这样就有效地创建了写入器栈
    servlet容器是在调用标记的doAfterBody和doEndTag方法之间调用PageContent.popBody()方法的
注意请不要在doEndTag()后面去访问BodyContent,因为servlet容器在调用标记处理程序的doEndTag()方法为止,servlet容器可能已经再次使用了该标记的主题内容,使用doEndTag方法访问自己主体内容的标记,可能会访问到其他标记的主体内容,或者可能访问到空值,这样就导致了不确定的行为

BodyTagSupport类,实现BodyTag接口的类
    public BodyContent getBodyContent();//返回主题内容
    public JspWriter getPreviousOut();//返回前一个out对象
    说了这么一大堆的东西，有什么用呢？我们来写个东西来说明以下：
打印出主体内容！
java 代码
 
  1. import java.io.IOException;  
  2.   
  3. import javax.servlet.jsp.JspException;  
  4. import javax.servlet.jsp.tagext.BodyTagSupport;  
  5.   
  6. public class PrintBodyTag extends BodyTagSupport {  
  7.     public int doAfterTag()throws JspException  
  8.     {  
  9.         try  
  10.         {         
  11.             this.getBodyContent().writeOut(getPreviousOut());//上面讲的理论！  
  12.         }catch(IOException e)  
  13.         {  
  14.             throw new JspException(e);  
  15.         }  
  16.         return SKIP_BODY;  
  17.     }  
  18. }  
部署tld文件
xml 代码
 
  1. ......  
  2.   <tag>  
  3.     <name>printBodyname>  
  4.     <tag-class>PrintBodyTagtag-class>  
  5.       
  6.   tag>  
  7.   ......  
页面加载：
html代码
 
  1. <%@ page language="java" import="java.util.*" pageEncoding="ISO-8859-1"%>  
  2. <%@ taglib uri="" prefix="util"%>  
  3. >  
  4. <html>  
  5.   <head>  
  6.     <title>My JSP 'tag.jsp' starting pagetitle>  
  7.   head>  
  8.   <body>  
  9.     <util:printBody>AAAAAAAAutil:printBody> //结果就是怎么样相信大家猜得到！AAAAAAAA  
  10.   body>  
  11. html>  
阅读(668) | 评论(0) | 转发(0) |
0

上一篇：Taglib的打包部署和使用方式详解

下一篇：eclipse out of memory 问题

给主人留下些什么吧！~~
关于我们 | 关于IT168 | 联系方式 | 广告合作 | 法律声明 | 免费注册

Copyright 2001-2010 ChinaUnix.net All Rights Reserved 北京皓辰网域网络信息技术有限公司. 版权所有

感谢所有关心和支持过ChinaUnix的朋友们

16024965号-6