`

JSP:自定义标签——开发实例

阅读更多
【实例109】  开发带属性的标签:helloTagHaveProp
  本实例中开发的标签在实例108的helloTag标签上作出改进,开发目标是在helloTag标签上增加两个属性fontSize和fontColor,fontSize用于设置字体大小,fontColor用于设置文字的颜色。
  (1)第一步:开发标签实现类。
  helloTagHaveProp.java
  package hello;
  import javax.servlet.jsp.JspWriter;
  import javax.servlet.jsp.tagext.TagSupport;
  public class helloTagHaveProp extends TagSupport {
    private String fontSize="3";//字体大小,默认3号
    private String fontColor="#000000";//字体颜色,默认黑色
    //----标签开始时调用此方法-------
    public int doStartTag(){
        try{
            JspWriter out=pageContext.getOut();
            out.print("标签开始了。<font color=\""+fontColor +
                 "\" size=\""+fontSize+"\">hello!</font>");
        }catch(Exception e){
            System.out.println(e);
        }
        return EVAL_BODY_INCLUDE;
    }
    //----标签结束时调用此方法-------
    public int doEndTag(){
        try{
            JspWriter out=pageContext.getOut();
            out.print("标签结束了。");
        }catch(Exception e){
            System.out.println(e);
        }
        return EVAL_PAGE;
    }  
    public String getFontColor() { 
        return fontColor;
    }
    public void setFontColor(String fontColor) {
        this.fontColor = fontColor;
    }
    public String getFontSize() {
        return fontSize;
    }
    public void setFontSize(String fontSize) {
        this.fontSize = fontSize;
      }
  }

  (2)第二步:编写标签描述tld文件。这里在myTag.tld文件中增加内容,在<taglib>与</taglib>之间增加的内容如下:
  <!-- helloTagHaveProp-->
  <tag>
     <!-- 标签名称-->
     <name>helloTagHaveProp</name>
     <!-- 标签对应的处理类-->
     <tag-class>hello.helloTagHaveProp</tag-class>
     <!-- 标签体内容,没有标签体则设为empty-->
     <body-content>empty</body-content>
     <!-- 标签的属性声明-->
     <attribute>
      <name>fontSize</name>
      <required>false</required>
     </attribute>
     <attribute>
      <name>fontColor</name>
      <required>false</required>
     </attribute>
  </tag>

  其中,name为属性的名称,required设置此属性是否必须设置,如果为true则在JSP页面中使用此标签时,必须给标签的这个属性赋值。

  (3)第三步:在Web应用的web.xml文件中声明标签库引用。本例与实例108使用同一个tld文件,故不必再修改。

  (4)第四步:在JSP页面中声明并调用标签。
  useHelloTagHaveProp.jsp
  <%@ taglib uri="/myTag" prefix="myTag" %>
  <%@ page contentType="text/html;charset=GB2312" %>
  <html>
    <head>
   <title>一个简单的自定义标签</title>
   </head>
   <body>
   下面是应用这个简单的自定义标签的结果:<br>
  <myTag:helloTagHaveProp fontSize="5"/><br>
  <myTag:helloTagHaveProp fontSize="4" fontColor="red"/>
    </body>
  </html>

  程序的运行结果如图13-3所示。




三、 开发带标签体的标签
  要开发带标签体的标签,可实现BodyTag接口,也可从BodyTag接口的实现类BodyTagSupport继承,为简化开发,推荐从BodyTagSupport类继承开发。
  编写标签对应的实现类时,需要重载BodyTagSupport类几个方法:doStartTag(), setBodyContent(), doInitBody(), doAfterBody(), doEndTag(),他们执行顺序如下:doStartTag()→doInitBody()→setBodyContent()→doAfterBody()→doEndTag()doStartTag()方法可返回EVAL_BODY_INCLUDE或SKIP_BODY,如果返回EVAL_BODY_ INCLUDE则继续执行;如果返回SKIP_BODY则接下来的doInitBody(),setBodyContent(), doAfterBody()三个方法不会被执行,而直接执行doEndTag()方法。

  setBodyContent()方法用于设置标签体内容,如果在此之前要作一些初始化工作,则在doInitBody()方法中完成。标签体内容执行完后,会调用doAfterBody()方法,此方法可返回EVAL_BODY_TAG, SKIP_BODY,

  EVAL_PAGE或SKIP_PAGE。如果返回EVAL_BODY_TAG则会再次设置标签体内容,直到返回SKIP_BODY;如果返回EVAL_PAGE则标签体执行完后会继续执行JSP页面中接下来的部分;如果返回SKIP_PAGE,则JSP页面的后续内容将不再执行。

  【实例110】  开发带标签体的标签:bodyTag1
  本实例将要开发一个带标签体的标签bodyTag1,这个标签有一个属性countNum,用于设置输出标签体内容的次数,输出内容为当前的系统时间。

  (1)第一步:开发标签实现类。
  BodyTag1.java
  package body;
  import javax.servlet.jsp.JspWriter;
  import javax.servlet.jsp.tagext.BodyTagSupport;
  public class bodyTag1 extends BodyTagSupport{
    private int countNum=0;//循环显示时间的次数
    private int currentNum=1;//当前执行次数
    //----标签开始时调用此方法-------
    public int doStartTag(){
        try{
            JspWriter out=pageContext.getOut();
            out.print("标签开始了:<br>");
            if(countNum>0)
                return EVAL_BODY_TAG;
            else
                return SKIP_BODY;
           
        }catch(Exception e){
            System.out.println(e);
            return SKIP_BODY;
        }
    }
    //----标签体执行完后调用此方法----
    public int doAfterBody(){
        try{
         JspWriter out=pageContext.getOut();
         out.print("第"+currentNum+"次执行标签体。标签体执行完毕。<br>");
         if(countNum>1){//如果还需要执行标签体
             countNum--;
             currentNum++;
             return EVAL_BODY_TAG;
         }else return SKIP_BODY;
        }catch(Exception e){
            System.out.println(e);
            return SKIP_BODY;
        }
    }
    //----标签结束时调用此方法-------
    public int doEndTag(){
        try{
            JspWriter out=pageContext.getOut();
            //----输出标签体的内容----
            bodyContent.writeOut(bodyContent.getEnclosingWriter());
            out.print("标签结束了。");
        }catch(Exception e){
            System.out.println(e);
        }
        return EVAL_PAGE;
    }  
    public int getCountNum() {
        return countNum;
    }
    public void setCountNum(int countNum) {
        this.countNum = countNum;
        this.currentNum=1;
      }
  }

  执行标签体并不会直接输出标签体中的内容,因此本实例在doEndTag()方法中一次性把执行的结果输出。

  (2)第二步:编写标签描述tld文件。
  因为本章所有实例共用一个Web应用,故本例在myTag.tld文件中增加内容。在<taglib>与</taglib>之间增加的内容如下:
  <!-- bodyTag1-->
  <tag>
  <!-- 标签名称-->
  <name>bodyTag1</name>
  <!-- 标签对应的处理类-->
  <tag-class>body.bodyTag1</tag-class>
  <!-- 标签体内容,有标签体则设为jsp-->
  <body-content>jsp</body-content>
  <!-- 标签的属性声明-->
  <attribute>
   <name>countNum</name>
   <required>true</required>
   <rtexprvalue>true</rtexprvalue>
  </attribute>
  </tag>

  对于属性countNum的声明中,<required>设置为true,表示此属性为必输项;<rtexprvalue>设置为true,表示标签体支持运行时的表达式取值,如果为false则表示标签体为一个静态文本,默认情况下设置为true。

  (3)第三步:在Web应用的web.xml文件中声明标签库引用。
  同样,本例与实例108使用同一个tld文件,不必再修改。

  (4)第四步:在JSP页面中声明并调用标签。
  UseBodyTag1.jsp
  <%@ taglib uri="/myTag" prefix="myTag" %>
  <%@ page contentType="text/html;charset=GB2312" %>
  <%@ page import="java.util.Date" %>
  <html>
    <head>
    <title>开发带有标签体的标签</title>
    </head>
    <body>
  下面是应用这个带有属性的自定义标签的结果:<br>
  <myTag:bodyTag1 countNum="6">
   现在的时间是:<%=new Date()%><br>
  </myTag:bodyTag1>
   </body>
  </html>
  该程序的运行结果如图13-4所示。



【实例111】  开发嵌套的标签:haveChildTag
  实际工程中往往需要多个标签来配合完成一定的功能,嵌套的标签存在父子关系,其中,父为外层标签,子为内层标签。本实例将用两个简单的标签来演示,父标签则作出逻辑判断,如果isOutput属性为true,则输出实例108中的标签helloTag;如果为false,则不输出。

  (1)第一步:开发标签实现类。
  内层的标签helloTag在实例108中已有,此处不再列出。
  haveChildTag.java
  package hello;
  import javax.servlet.jsp.tagext.BodyTagSupport;
    public class haveChildTag extends BodyTagSupport {
      private boolean isOutput;//是否输出子标签内容
      //----标签开始时调用此方法-------
      public int doStartTag(){
          if(isOutput)
              return EVAL_BODY_INCLUDE;
          else return SKIP_BODY;
      }
      //----标签结束时调用此方法-------
      public int doEndTag(){
          try{
              if(bodyContent!=null)
                bodyContent.writeOut(bodyContent.getEnclosingWriter());
          }catch(Exception e){
              System.out.println(e);
          }
          return EVAL_PAGE;
      }  
      public boolean getIsOutput() {
          return isOutput;
      }
      public void setIsOutput(boolean isOutput) {
          this.isOutput = isOutput;
      }
  }

  (2)第二步:编写标签描述tld文件。
  本例在myTag.tld文件中增加内容。在<taglib>与</taglib>之间增加的如下内容:
  <!-- haveChildTag-->
  <tag>
  <!-- 标签名称-->
  <name>haveChildTag</name>
  <!-- 标签对应的处理类-->
  <tag-class>hello.haveChildTag</tag-class>
  <!-- 标签体内容,有标签体则设为jsp-->
  <body-content>jsp</body-content>
  <!-- 标签的属性声明-->
  <attribute>
   <name>isOutput</name>
   <required>true</required>
   <rtexprvalue>true</rtexprvalue>
  </attribute>
  </tag>

  (3)第三步:在Web应用的web.xml文件中声明标签库引用。
  同样,本例与本章前面的实例使用同一个tld文件,此处不必再修改。

  (4)第四步:在JSP页面中声明并调用标签。
  useHaveChildTag.jsp
  <%@ taglib uri="/myTag" prefix="myTag" %>
  <%@ page contentType="text/html;charset=GB2312" %>
  <%@ page import="java.util.Date" %>
  <html>
   <head>
   <title>开发嵌套的标签</title>
   </head>
    <body>
  输出子标签时的结果:<br>
  <myTag:haveChildTag isOutput="true">
   <myTag:helloTag/>
  </myTag:haveChildTag><br>
  不输出子标签时的结果:<br>
  <myTag:haveChildTag isOutput="false">
   <myTag:helloTag/>
  </myTag:haveChildTag><br>
   </body>
  </html>
  该程序的运行结果如图13-5所示。



《JSP网络编程从实践到实践》原码下载地址:http://shop.csai.cn/itbook/itbookinfo.asp?lbbh=10051575    

  五、 开发迭代的标签
  【实例112】  开发迭代的标签:iterateTag
  对于集合对象的Iterator类对象,在JSP的Java代码中需要用while循环或for循环来输出,难于维护,且可复用性不好,程序员总是在大量地做这样的工作,这时可以考虑用迭代的标签来开发,需要输出数据时只须在JSP页面中声明标签即可。

  开发迭代的标签,需要设计两个Java类:标签实现类和表示标签信息的类。本实例中标签实现类为iterateTag.java,表示标签信息的类为IterateTEI.java。开发迭代的标签可实现IterationTag接口,也可从TagSupport类或BodyTagSupport类继承,由于BodyTagSupport类继承自TagSupport类,而TagSupport类又实现了IterationTag接口,为简化开发,直接从BodyTagSupport类继承即可。

  (1)第一步:开发标签实现类和表示标签信息的类。
  iterateTag.java
  package body;
  import java.util.Collection;
  import java.util.Iterator;
  import javax.servlet.jsp.tagext.BodyTagSupport;
  public class iterateTag extends BodyTagSupport{
      private String name;//在pageContext中标识的一个属性名
      private Iterator it;//要迭代的对象
      private String type;//it中对象的类型
      public void setCollection(Collection collection){
          if(collection.size()>0)
              it=collection.iterator();
      }
   
      //----标签开始时调用此方法-------
    public int doStartTag(){
        if(it==null) return SKIP_BODY;
        else return continueNext(it);
    }
    //----标签体执行完后调用此方法----
    public int doAfterBody(){
        return continueNext(it);
    }
    //----标签结束时调用此方法-------
      public int doEndTag(){
          try{
              if(bodyContent!=null)
                bodyContent.writeOut(bodyContent.getEnclosingWriter());
         }catch(Exception e){
              System.out.println(e);
          }
          return EVAL_PAGE;
      } 
      //----迭代----
      protected int continueNext(Iterator it){
          if(it.hasNext()){
              pageContext.setAttribute(name,it.next(),pageContext.PAGE_SCOPE);
              return EVAL_BODY_TAG;
          }else return SKIP_BODY;
      }
      public String getName() {
          return name;
      }
      public void setName(String name) {
          this.name = name;
      }
      public String getType() {
          return type;
      }
      public void setType(String type) {
          this.type = type;
      }
  }

  在标签实现类中,有3个属性:name、type和it。其中,name代表在pageContext中标识一个属性的名字;type代表待迭代内容的数据类型;it为要迭代的内容。在doStartTag()方法中,如果it不为null,就开始迭代,迭代时调用continueNext()方法。
  IterateTEI.java
  package body;
  import javax.servlet.jsp.tagext.TagData;
  import javax.servlet.jsp.tagext.TagExtraInfo;
  import javax.servlet.jsp.tagext.VariableInfo;
  //----提供标签翻译时的一些相关信息----
  public class IterateTEI extends TagExtraInfo {
      public IterateTEI() {
          super();
      }
      public VariableInfo[] getVariableInfo(TagData data){
          return new VariableInfo[]{
                  new VariableInfo(data.getAttributeString("name"),
                          data.getAttributeString("type"),
                          true,VariableInfo.NESTED)             
            };
        }
    }
  VariableInfo类中有几个常量,具体的含义为:
  NESTED:标签中的参数在标签开始到标签结束之间是有效的。
  AT_BEGIN:标签中的参数在标签开始到使用它的JSP页面结束是有效的。
  AT_END:标签中的参数在标签的结束到使用它的JSP页面结束是有效的。

  (2)第二步:编写标签描述tld文件。本例在myTag.tld文件中增加内容。在<taglib>与</taglib>之间增加如下内容:
     <!-- iterateTag-->
      <tag>
      <!-- 标签名称-->
      <name>iterateTag</name>
      <!-- 标签对应的处理类-->
      <tag-class>body.iterateTag</tag-class>
      <tei-class>body.IterateTEI</tei-class>
      <!-- 标签体内容,有标签体则设为jsp-->
      <body-content>jsp</body-content>
      <!-- 标签的属性声明-->
      <attribute>
       <name>collection</name>
       <required>true</required>
       <rtexprvalue>true</rtexprvalue>
      </attribute>
      <attribute>
       <name>name</name>
       <required>true</required>
      </attribute>
      <attribute>
       <name>type</name>
       <required>true</required>
      </attribute>
      </tag>
  </taglib>

  (3)第三步:在Web应用的web.xml文件中声明标签库引用。同样,本例与本章前面的实例使用同一个tld文件,因此不必再修改。

  (4)第四步:在JSP页面中声明并调用标签。
  <%@ taglib uri="/myTag" prefix="myTag" %>
  <%@ page contentType="text/html;charset=GB2312" %>
  <%@ page import="java.util.ArrayList"%>
    <head>
    <title>开发迭代的标签</title>
    </head>
   <body>
    开发一个迭代的标签,输出结果:<br>
    <%//----------设置一个ArrayList对象的初始值----------
   ArrayList testCol=new ArrayList();
   testCol.add("邓佳容");
   testCol.add("黄婧");
   testCol.add("邓子云");
   request.setAttribute("testCol",testCol);
   %>
    <myTag:iterateTag name="testColOne" collection="<%=testCol%>" type="String">
     输出一个值:<%=testColOne.toString()%><br>
   </myTag:iterateTag>
   </body>
  </html>
  该程序的运行结果如图13-6所示。


分享到:
评论

相关推荐

    《Java Web开发教程——入门与提高篇(JSP+Servlet)》附赠电子资料——框架基础及实例

    本文档是《Java Web开发教程——入门与提高篇(JSP+Servlet)》一书的附赠电子资料,对Struts2、JSF、Hibernate、iBATIS和JPA等框架进行了简单介绍,并且给出了两个自定义简单框架,还包括3个实例,共149页。

    JSP2.0技术手册pdf(带示例源码).zip

    本书图文并茂,以丰富的实例为引导,全面介绍了主流的 Java Web 开发技术—— JSP 2.0,重点介绍Java在展示层的两项重要技术:Java Servlet与JavaServer Pages。 它们是最重要的 Java 核心技术。对这两项技术的深入...

    Google Android SDK开发范例大全(完整版)

    余志龙,来自于手机制造业、电视媒体业、网络、电信产业、软件开发等领域,擅长嵌入式系统软件设计、J2ME游戏开发、Android开发,以及J2EE、JSP、Servlet、JavaBeans、PHP、C#等程序语言,熟悉面向对象技术与Eclipse...

    Java开发技术大全 电子版

    14.12GUI程序设计实例3——字体选择对话框553 14.12.1界面的实现554 14.12.2监听ListSelectionEvent事件556 14.12.3按钮响应事件556 14.12.4对话框的显示557 14.12.5返回用户选择的字体557 14.12.6如何使用...

    低清版 大型门户网站是这样炼成的.pdf

    7.6.2 文本新闻列表分页控制自定义标签类textnewspagetag 502 7.6.3 图片新闻列表自定义标签类picnewstag 505 7.6.4 幻灯片新闻列表自定义标签类slidenewstag 507 7.6.5 struts2与ajax完全结合实现点击数加一 510...

    java源码包---java 源码 大量 实例

     Java局域网通信——飞鸽传书源代码,大家都知道VB版、VC版还有Delphi版的飞鸽传书软件,但是Java版的确实不多,因此这个Java文件传输实例不可错过,Java网络编程技能的提升很有帮助。 Java聊天程序,包括服务端和...

    JAVA上百实例源码以及开源项目源代码

     Java局域网通信——飞鸽传书源代码,大家都知道VB版、VC版还有Delphi版的飞鸽传书软件,但是Java版的确实不多,因此这个Java文件传输实例不可错过,Java网络编程技能的提升很有帮助。 Java聊天程序,包括服务端和...

    java初学者必看

    4.6 综合实例:水仙花数 4.7 本章习题 第5章 字符串 5.1 字符串简介 5.1.1 字符串常量 5.1.2 String创建字符串常量 5.1.3 StringBuffer创建字符串 5.2 连接字符串 5.2.1 与字符串的连接 5.2.2 与其他数据...

    java源码包2

     Java局域网通信——飞鸽传书源代码,大家都知道VB版、VC版还有Delphi版的飞鸽传书软件,但是Java版的确实不多,因此这个Java文件传输实例不可错过,Java网络编程技能的提升很有帮助。 Java聊天程序,包括服务端和...

    深入浅出Struts 2 .pdf(原书扫描版) part 1

    Servlet①技术和1JSP(JaLvaServer Pages)是利用Java语言开发Web/_立用程序的两种主要技术。Sun公司于1996年首次推出Servlet技术时,人们认为这种技术远优于当时占主导地位的公共网关接口(Common Gateway Inter。...

    JAVA上百实例源码以及开源项目

     Java局域网通信——飞鸽传书源代码,大家都知道VB版、VC版还有Delphi版的飞鸽传书软件,但是Java版的确实不多,因此这个Java文件传输实例不可错过,Java网络编程技能的提升很有帮助。 Java聊天程序,包括服务端和...

    java源码包3

     Java局域网通信——飞鸽传书源代码,大家都知道VB版、VC版还有Delphi版的飞鸽传书软件,但是Java版的确实不多,因此这个Java文件传输实例不可错过,Java网络编程技能的提升很有帮助。 Java聊天程序,包括服务端和...

    java源码包4

     Java局域网通信——飞鸽传书源代码,大家都知道VB版、VC版还有Delphi版的飞鸽传书软件,但是Java版的确实不多,因此这个Java文件传输实例不可错过,Java网络编程技能的提升很有帮助。 Java聊天程序,包括服务端和...

    swing界面设计之JTree

    代码实例:构建一棵树 101 相关语句解释 101 (十六) JTree应用示例——文件路径 103 AnimatedIconTreeExample.java源代码 103 //内部类NodeImageObserver.java源代码 105 //IconNodeRenderer.java源代码 106 //...

    成百上千个Java 源码DEMO 4(1-4是独立压缩包)

    28个目标文件 内容索引:JAVA源码,媒体网络,飞鸽传书 Java局域网通信——飞鸽传书源代码,大家都知道VB版、VC版还有Delphi版的飞鸽传书软件,但是Java版的确实不多,因此这个Java文件传输实例不可错过,Java网络编程...

    成百上千个Java 源码DEMO 3(1-4是独立压缩包)

    28个目标文件 内容索引:JAVA源码,媒体网络,飞鸽传书 Java局域网通信——飞鸽传书源代码,大家都知道VB版、VC版还有Delphi版的飞鸽传书软件,但是Java版的确实不多,因此这个Java文件传输实例不可错过,Java网络编程...

    JAVA程序开发大全---上半部分

    9.4 Hibernate应用实例:基于Struts+Hibernate的登录系统 155 9.5 本章小结 160 第10章 Spring框架的开发及应用 161 10.1 Spring框架概述 161 10.2 Spring框架中的IoC编程 162 10.2.1 控制反转的原理 163 10.2.2 ...

Global site tag (gtag.js) - Google Analytics