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

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

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

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

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

　　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>

在浏览器中观察：　

　　通过上面的例子我们也可以看到，虽然“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页面属性上若以字符串，则因为在标签处理器类并非八大基本数据类型，因此只能使用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>

浏览器中观察：

您可能感兴趣的文章:

• JavaWeb开发之JSTL标签库的使用、 自定义EL函数、自定义标签（带属性的、带标签体的）
• javaWeb自定义标签用法实例详解
• Java开发框架spring实现自定义缓存标签
• Java自定义简单标签实例
• java基础之标签、按钮和按钮事件简介
• java实现利用String类的简单方法读取xml文件中某个标签中的内容
• Java基于线程实现带有滚动效果的Label标签实例
• java使用正则表达式过滤html标签
• Java自定义标签用法实例分析