在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 里控制输出。
下面是一个简单的例子
Java代码
- 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;
- }
- }
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 下面。
Java代码
- <?xml version="1.0" encoding="UTF-8"?>
- <!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.1//EN" "http://java.sun.com/j2ee/dtds/web-jsptaglibrary_1_1.dtd">
- <taglib>
- <tlibversion>1.2</tlibversion>
- <jspversion>1.1</jspversion>
- <shortname>tagTest</shortname>
- <uri>/taiji</uri>
- <tag>
- <name>permission</name>
- <tagclass>com.test.tag.PermissionBodyTag</tagclass>
- <bodycontent>JSP</bodycontent>
- <attribute>
- <name>permission</name>
- <required>true</required>
- <rtexprvalue>true</rtexprvalue>
- </attribute>
- </tag>
- </taglib>
-
<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.1//EN" "http://java.sun.com/j2ee/dtds/web-jsptaglibrary_1_1.dtd"><taglib> <tlibversion>1.2</tlibversion> <jspversion>1.1</jspversion> <shortname>tagTest</shortname> <uri>/taiji</uri> <tag> <name>permission</name> <tagclass>com.test.tag.PermissionBodyTag</tagclass> <bodycontent>JSP</bodycontent> <attribute> <name>permission</name> <required>true</required> <rtexprvalue>true</rtexprvalue> </attribute> </tag></taglib>
三.加到web.xml中
当然,我们还需要将我们自定义的标签添加到 web.xml 中,否则还是无法使用。
Java代码
- <taglib>
- <taglib-uri>/tagTest </taglib-uri>
- <taglib-location>/WEB-INF/tagTest-html.tld</taglib-location>
- </taglib>
<taglib> <taglib-uri>/tagTest </taglib-uri> <taglib-location>/WEB-INF/tagTest-html.tld</taglib-location> </taglib>
四.在jsp页面导入tld
Java代码
- <%@ taglib uri="/tagTest " prefix="tagTest "%>
<%@ taglib uri="/tagTest " prefix="tagTest "%>
这样,你的jsp页面就可以使用自己的tag了。用这个标签就可以根据传人的boolean值来决定标签包的jsp内容是否输出
Java代码
- <tagTest:permission permission="<% java code%>">
- //需有权限输出,用户才能看到的内容
- </tagTest:permission>
<tagTest:permission permission="<% java code%>">//需有权限输出,用户才能看到的内容</tagTest:permission>
优点
1. 修改后的JSP文件不再或尽量少包含java代码,. html代码变得非常干净,页面设计人员修改页面文件时,不用担心误删除程序代码了。
2. 程序开发人员使用简单的空白页就可以进行开发,待页面设计人员提交目标页后,只需简单的编辑即可完成替换
最终使页面和代码尽量分离。
相关推荐
JSP自定义标签JSP自定义标签JSP自定义标签JSP自定义标签JSP自定义标签JSP自定义标签
本人自行研究JSP自定义标签的学习笔记 目录如下: 目录 一、概述 1 1.1 使用简单标签机制 2 1.2 使用标签文件 3 二 、自定义标签简介 3 2.1 自定义标签概念 3 2.2 标签相关概念 3 2.3 如何创建自定义标签 3 三、自...
jsp 自定义标签 一个简单的自定义标签实现
jsp自定义标签jsp自定义标签jsp自定义标签
在网上学习jsp自定义标签的时候, 出现了异常, 在网上寻找了好久, 都没有找到合适的答案, 自己通过摸索最后成功, 分享给大家, 希望能够帮助到你, 自定义标签不能放在java Project中, 只能在java web Project中才可以.
jsp自定义标签jsp自定义标签jsp自定义标签jsp自定义标签
使用jsp自定义标签的功能实现权限的控制。(如果用户没有某个模块的删除权限,就不现实这个删除按钮) 在整个项目中所有的页面都可以引入自定义的标签去做到权限的控制。 自定义标签文件 删除 可以控制页面中的每...
jsp自定义标签库实现数据列表显示,包括代码,文档,希望对大家有帮助.
jsp自定义标签例子,能在Tomcat下直接运行 具体讲解参考 http://blog.csdn.net/zwhfyy/archive/2008/06/13/2543904.aspx
权威实用的jsp自定义标签demo,checkbox,radio> 导入eclipse 部署 看效果吧 带源代码哦
是用jsp自定义标签编写的一个非常不错的分页,扩展性非常不错,不依赖于数据库。
JSP自定义标签。在自定义标签的起始和结束标签之间的部分为标签体(Body)。 标签处理程序类:定义标签的行为,并在JSP引擎遇到自定义标签时调用执行。 标签库描述符(TLD)文件:描述标签库的XML文档,向JSP引擎...
jsp初学者实例,以及分页封装,下拉框绑定值封装
java jsp自定义标签非常好用大家下载学习java jsp自定义标签非常好用大家下载学习java jsp自定义标签非常好用大家下载学习java jsp自定义标签非常好用大家下载学习java jsp自定义标签非常好用大家下载学习java jsp...
创建JSP自定义标签.doc 创建JSP自定义标签.doc 创建JSP自定义标签.doc