欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

JSP自定义标签-标签属性_动力节点Java学院整理

程序员文章站 2022-06-29 13:30:03
对自定义标签添加一些属性,可以使我们的标签功能更加灵活和复用。例如前一篇博客使用简单标签来对标签体内容执行一定的次数,就无法在标签上规定要执行的次数,必须在标签处理器类中修...

对自定义标签添加一些属性,可以使我们的标签功能更加灵活和复用。例如前一篇博客使用简单标签来对标签体内容执行一定的次数,就无法在标签上规定要执行的次数,必须在标签处理器类中修改,很不方便,如果使用带属性的标签就能很好的解决这个问题。

  要想使简单标签具有属性,通常需要满足以下两个步骤:

  ① 在标签处理器类中定义属性,同时为每个属性生成setter方法;

  ② 在tld文件中对于的<tag>标签下添加属性的<attribute>标签,同时<attribute>标签下定义其从标签,其中<name>从标签是必须要有的。<attribute>标签所拥有的从标签如下:  

JSP自定义标签-标签属性_动力节点Java学院整理

  name标签:用于指定标签中属性的名称。

  required标签:指定该属性是否必须。

  rtexprvalue标签:指定该属性是否支持运行时表达式,如jsp表达式(<%=value  %>)和el表达式( ${value} )。如果我们设定为“false”的话,那么该属性只能支持字符串。 

例1:使用简单标签来控制标签体内容执行次数(带属性标签方式)
编写标签处理器类:

 package com.bjpowernode.simpletag;
 public class looptagbody extends simpletagsupport {
   private int count; //定义一个属性,用来指定循环次数
   public void setcount(int count) {  //为该属性设置setter方法
     this.count = count;
   }
   @override
   public void dotag() throws jspexception, ioexception {  
     jspfragment fragment = this.getjspbody();
     for(int i=0;i<this.count;i++) {  //使用属性就可以指定循环次数
       fragment.invoke(null);
     }
   }  
 }  

 在tld文件中定义和描述标签处理器类,同时指定标签所在的uri:

<?xml version="1.0" encoding="utf-8" ?>
 <taglib xmlns="http://java.sun.com/xml/ns/j2ee"
   xmlns:xsi="http://www.w3.org/2001/xmlschema-instance"
xsi:schemalocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd"
   version="2.0">
   <description>a tag library exercising simpletag handlers.</description>
   <tlib-version>1.0</tlib-version>
   <short-name>simpletaglibrary</short-name>
 <uri>simpletag</uri>
   <tag>
     <name>loopbody</name>
     <tag-class>com.bjpowernode.simpletag.looptagbody</tag-class>
     <body-content>scriptless</body-content>
     <attribute>
       <name>count</name>
       <required>true</required>
       <rtexprvalue>true</rtexprvalue>
     </attribute>
   </tag>
 </taglib>

  在jsp页面的开头导入taglib指令:

  <%@ taglib uri="simpletag" prefix="simple" %>

最后就能在jsp页面的主体中使用刚才定义好的带属性的简单标签了,使用“count”属性就能指定标签体循环的次数:

 <simple:loopbody count="5">
       神乐! <br>
   </simple:loopbody>

在浏览器中观察: 

JSP自定义标签-标签属性_动力节点Java学院整理 

  通过上面的例子我们也可以看到,虽然“count”属性在标签处理器looptagbody类中的类型为int整型,但是在标签上传入的是字符串类型,这是因为jsp容器支持将标签的属性类型(字符串)转换为八大基本数据类型。如果在标签处理器类中定义一个非八大基本数据类型的属性,那么上面的以上面的方式必定要报错,因为jsp容器无法将字符串转换为其它类型。除非在标签属性中使用其它类型:

例2:

 package com.bjpowernode.simpletag;
 public class dateattributetag extends simpletagsupport {
   private date date;
 
   public void setdate(date date) {
     this.date = date;
   }
   @override
   public void dotag() throws jspexception, ioexception {
     this.getjspcontext().getout().write(date.tostring());
   }
 }

在tld文件中描述(这里省略首尾,详细内容请看例1):

<tag>
 <name>showtime</name>    <tag-class>com.bjpowernode.simpletag.dateattributetag</tag-class>
   <body-content>empty</body-content>
   <attribute>
       <name>date</name>
       <required>true</required>
       <rtexprvalue>true</rtexprvalue>
 </attribute>
 </tag>

注:这里<rtexprvalue>标签是必须要的。

在jsp页面中导入taglib指令(此处略)后,在jsp页面的主体中使用刚才定义的简单标签:

  <simple:showtime date="<%=new date() %>"/>

在浏览器中观察:  

JSP自定义标签-标签属性_动力节点Java学院整理

  因为在jsp页面属性上若以字符串,则因为在标签处理器类并非八大基本数据类型,因此只能使用jsp表达式或el表达式将对象传入,因此必须在tld文件中将<rtexprvalue>标签设置为“true”。 

简单标签的应用,包括无属性的和带属性的标签如何使用都已经学习完毕,内容就这么多,剩下的就可以根据所学的进行开发了。

例3:使用简单标签来防盗链

  如果某个jsp页面需要防止被别的网站盗链,可以在该jsp页面的最开始部分使用一个简单标签,添加一些属性如指定从哪过来的网站才可以浏览本页面内容,指定如果是非指定网址过来的链接应该先让请求跳到哪里去。

编写标签处理器类:

 package com.bjpowernode.simpletag;
 public class referertag extends simpletagsupport {
   private string site; //指定允许来访请求的网址
   private string location;    //若非指定来访请求的网址应该先跳转到哪里去   
   public void setsite(string site) {
     this.site = site;
   }
   public void setlocation(string location) {
     this.location = location;
   }
   @override
   public void dotag() throws jspexception, ioexception {
     pagecontext pagecontext = (pagecontext) this.getjspcontext();
     httpservletrequest request = (httpservletrequest) pagecontext.getrequest();
     httpservletresponse response = (httpservletresponse) pagecontext.getresponse();
     
     string requesturl = request.getheader("referer");
     
     if(requesturl==null || !requesturl.startswith(site)) {
       response.sendredirect(request.getcontextpath()+this.location);
       throw new skippageexception();
     }
   }
 }

在tld文件中描述(这里省略首尾,详细内容请看例1):

 <tag>
     <name>referer</name>
     <tag-class>com.bjpowernode.simpletag.referertag</tag-class>
     <body-content>empty</body-content>
     <attribute>
       <name>site</name>
       <required>true</required>
       <rtexprvalue>true</rtexprvalue>
     </attribute>
     <attribute>
       <name>location</name>
       <required>true</required>
       <rtexprvalue>true</rtexprvalue>
     </attribute>
 </tag>

在jsp页面中导入taglib指令(此处略)后,在jsp页面的主体中使用刚才定义的简单标签:

 <simple:referer site="http://www.bjpowernode.com" location="/index.jsp" />
 <!doctype html>
 <html>
  <head>
  <title>my jsp 'simpletagdemo.jsp' starting page</title>
  </head>
  。。。
 </html>

  结果:若想访问该jsp页面,只有满足请求的url前缀为page属性指定的网址才能访问,如果是别的web中的超链接或者直接在浏览器中输入该jsp的url,都会被跳转到location属性指定的网页。 

例4:使用简单标签将标签体中的html过滤转义

编写标签处理器类:

 package com.bjpowernode.simpletag;
 public class htmlfiltertag extends simpletagsupport {
   @override
   public void dotag() throws jspexception, ioexception {
     jspfragment fragment = this.getjspbody();
     stringwriter writer = new stringwriter();
     fragment.invoke(writer);
     stringbuffer buffer = writer.getbuffer();
     string content = filter(buffer.tostring());
     this.getjspcontext().getout().write(content);
   }
   public string filter(string message) {
     if (message == null)
       return (null);
     char content[] = new char[message.length()];
     message.getchars(0, message.length(), content, 0);
     stringbuilder result = new stringbuilder(content.length + 50);
     for (int i = 0; i < content.length; i++) {
       switch (content[i]) {
       case '<':
         result.append("<");
         break;
       case '>':
         result.append(">");
         break;
       case '&':
         result.append("&");
         break;
       case '"':
         result.append(""");
         break;
       default:
         result.append(content[i]);
       }
     }
     return (result.tostring());
   }
 }

  其中过滤方法filter方法可以在tomcat中参考代码(位置:【tomcat】--->【webapps】--->【examples】--->【web-inf】--->【classes】--->【utils】--->“htmlfilter.java”)。
在tld文件中定义和描述标签:

 <tag>
     <name>filterhtml</name>
     <tag-class>com.bjpowernode.simpletag.htmlfiltertag</tag-class>
     <body-content>scriptless</body-content>
  </tag>

在jsp页面中的主体部分中使用刚才自定义的简单标签:

 <simple:filterhtml>
    <a href="www.baidu.com" rel="external nofollow" >百度</a>
   </simple:filterhtml>

浏览器中观察:

JSP自定义标签-标签属性_动力节点Java学院整理