全部博文(83)
分类: Java
2007-06-12 12:45:53
在JSP编程中,Struts一般用来处理form和业务逻辑,Struts中使用了很多自定义标签,如html、bean等,但很多时候我们还是需要使用
"<% java code %>"
这样的语句来操作一些输出。为了减少这种代码,可以创建自定义标签。
一个tag就是一个普通的java类,它唯一特别之处是它必须继承TagSupport或者BodyTagSupport类。这两个类提供了一些方法,负
责jsp页面和你编写的类之间的交互,例如输入,输出。而这两个类是由jsp容器提供的,无须开发人员自己实现。换句话说,你只需把实现了业务逻辑的类继
承TagSupport或者BodyTagSupport,再做一些特别的工作,你的类就是一个Tag。并且它自己负责和jsp页面的交互,不用你多操
心。
下面介绍如何创建一个自定义标签。
一.编写java类继承TagSupport或TagSupport
1) 提供属性的set方法,
此后这个属性就可以在jsp页面设置。以jstl标签为例 <c:out
value=""/>,这个value就是jsp数据到tag之间的入口。所以tag里面必须有一个setValue方法,具体的属性可以不叫value。例如setValue(String
data){this.data = data;}
这个“value”的名称是在tld里定义的。取什么名字都可以,只需tag里提供相应的set方法即可。
2)处理 doStartTag 或 doEndTag
这两个方法是 TagSupport提供的。 还是以<c:out
value=""/>为例,当jsp解析这个标签的时候,在“<”处触发 doStartTag
事件,在“>”时触发 doEndTag 事件。通常在 doStartTag
里进行逻辑操作,在 doEndTag 里控制输出。
下面是一个简单的例子
代码
package com.test.tag;
import
java.io.IOException;
import
javax.servlet.jsp.JspTagException;
import
javax.servlet.jsp.tagext.BodyContent;
import
javax.servlet.jsp.tagext.BodyTagSupport;
/**
* PermissionBodyTag
根据是否有权限显示body内容
*/
public class PermissionBodyTag extends BodyTagSupport
{
boolean
permission;
public
boolean isPermission() {
return permission;
}
public void
setPermission(boolean permission)
{
this.permission =
permission;
}
public int
doStartTag() throws JspTagException
{
if (permission) {
return EVAL_BODY_INCLUDE;
} else {
return SKIP_BODY;
}
}
public int
doEndTag() throws JspTagException
{
System.out.println("doEndTag");
try {
if (bodyContent != null)
{
bodyContent.writeOut(bodyContent.getEnclosingWriter());
}else{
}
} catch (IOException e) {
throw new JspTagException("IO ERROR:" +
e.getMessage());
}
return EVAL_PAGE;
}
public void
doInitBody() throws JspTagException
{
}
public void
setBodyContent(BodyContent bodyContent)
{
this.bodyContent =
bodyContent;
}
}
通常你会发现自己绝大多数活动都集中在 doStartTag 或 doEndTag 方法里。确实如此,熟悉一些接口和类之后,写taglib很容易。正如《jsp设计》的作者所言:里面的逻辑稍微有点复杂,但毕竟没有火箭上天那么难。
二.编写tld文件
标签文件其实只是一个XML格式的说明文件,内容也很简单。
创建tagTest-html.tld文件在这个标签文件中,我们将我们创建的标签取名
tagTest,并声明了类型和参数(permission)。将该文件保存在 /WEB-INF
下面。
代码
三.加到web.xml中
当然,我们还需要将我们自定义的标签添加到 web.xml
中,否则还是无法使用。
代码
四.在jsp页面导入tld
代码
<%@ taglib uri="/tagTest " prefix="tagTest
"%>
这样,你的jsp页面就可以使用自己的tag了。用这个标签就可以根据传人的boolean值来决定标签包的jsp内容是否输出
代码
//需有权限输出,用户才能看到的内容
chinaunix网友2008-08-28 16:20:58
看了你写的东西很后收获,按照你的描述我也在电脑上做了一个 在布置到weblogic上的时候发生了weblogic.servlet.jsp.JspException: (line 2): Error in using tag library uri='/tagTest' prefix='tagTest': cannot find tag class: 'com.test.tag.PermissionBodyTag'错误 不知道为什么,你能帮忙解释吗如果能请发到我的邮箱里面weiknight@163.com谢谢