jsp中的自定义标签



(jsp 1.0规范)

一,自定义标签主要用于移除Jsp页面中的java代码;

使用自定义标签移除jsp页面中的java代码,只需要完成以下两个步骤:

1,编写一个实现Tag接口的Java类(标签处理器类)。

2,编写标签库描述符(tld)文件,在tld文件中对标签处理器类描述成一个标签。(.tld文件放在WEB-INF目录下面)



二,TAG接口的执行流程;

JSP引擎将遇到自定义标签时,首先创建标签处理器类的实例对象,然后按照JSP规范定义的通信规则依次调用它的方法。

1,?public void setPageContext(PageContext pc);

JSP引擎实例化标签处理器后,将调用setPageContext方法将JSP页面的pageContext对象传递给标签处理器,标签处理器以后可以通过这个pageContext对象与JSP页面进行通信。

2,public void setParent(Tag t);

setPageContext方法执行完后,WEB容器接着调用的setParent方法将当前标签的父标签传递给当前标签处理器,如果当前标签没有父标签,则传递给setParent方法的参数值为null。

3,public int doStartTag();

调用了setPageContext方法和setParent方法之后,WEB容器执行到自定义标签的开始标记时,就会调用标签处

理器的doStartTag方法。

4,public int doEndTag();

WEB容器执行完自定义标签的标签体后,就会接着去执行自定义标签的结束标记,此时,WEB容器会去调用标

签处理器的doEndTag方法。

5,public void release();

通常WEB容器执行完自定义标签后,标签处理器会驻留在内存中,为其它请求服务器,直至停止web应用时,web容器才会调用release方法。


代码:

/*
 * 标签处理器类   页面内容不输出
 */
public class TagDemo1 extends TagSupport {//继承自TAG接口的子类

	@Override
	public int doStartTag() throws JspException {

		return Tag.SKIP_BODY;//页面内容不输出
	}
}

/*
 * 页面内容输出  标签处理器类
 */
public class TagDemo2 extends TagSupport {

	@Override
	public int doEndTag() throws JspException {
		return Tag.EVAL_PAGE;

}

/*
 * 页面内容重复输出
 */
public class TagDemo3 extends TagSupport {

	int i = 5;

	@Override
	public int doStartTag() throws JspException {
		return EVAL_BODY_INCLUDE;
	}

	@Override
	public int doAfterBody() throws JspException {
		i--;
		if(i>0){
			return EVAL_BODY_AGAIN;
		}else{
			return SKIP_BODY;
		}

	}

}

/*
 * 改变页面内容
 */
public class TagDemo4 extends BodyTagSupport {

	@Override
	public int doStartTag() throws JspException {
		// TODO Auto-generated method stub
		return EVAL_BODY_BUFFERED;
	}

	@Override
	public int doEndTag() throws JspException {
		BodyContent bc = this.bodyContent;
		String content = bc.getString();
		content = content.toUpperCase();

		try {
			this.pageContext.getOut().write(content);
		} catch (IOException e) {
			throw new RuntimeException(e);
		}

		return EVAL_PAGE;
	}

}


tld描述文件

//tld文件描述
<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>/yujian</uri>
    
     <tag>
           <name>demo1</name>
           <tag-class>cn.yujian.web.tag.TagDemo1</tag-class>
	   <body-content>JSP</body-content>
    </tag>
    

    <tag>
        <name>demo2</name>
	<tag-class>cn.yujian.web.tag.TagDemo2</tag-class>
	<body-content>empty</body-content>
    </tag>
    
     <tag>
        <name>demo3</name>
	<tag-class>cn.yujian.web.tag.TagDemo3</tag-class>
	<body-content>JSP</body-content>
    </tag>
    
    
    <tag>
        <name>demo4</name>
	<tag-class>cn.yujian.web.tag.TagDemo4</tag-class>
	<body-content>JSP</body-content>
    </tag>
    
</taglib>

jsp页面:

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%@taglib uri="/yujian" prefix="flx" %>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
    <title>用标签控制页面内容是否输出</title>
  </head>
  
  <body>
   <flx:demo1>
   	aaaaaaaaaaa
   </flx:demo1>
  </body>
</html>

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%@taglib uri="/yujian" prefix="flx" %>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<flx:demo2/>
<html>
  <head>
    <title>用标签可以控制整个页面是否执行</title>
  </head>
  
  <body>
  aaaaaaaaaaaaaaaaaaaaa 
  </body>
</html>
<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%@taglib uri="/yujian" prefix="flx" %>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<flx:demo2/>
<html>
  <head>
    <title>用标签可以控制整个页面是否执行</title>
  </head>
  
  <body>
  aaaaaaaaaaaaaaaaaaaaa 
  </body>
</html>
<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%@taglib uri="/yujian" prefix="flx" %>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
    <title>用标签修改页面内容</title>
  </head>
  
  <body>
	<flx:demo4> 
	  	aaaaaaaaaaaaaaaaaaaaa
	</flx:demo4>
  </body>
</html>

jsp 2.0规范  简单标签

一,由于传统标签使用三个标签接口来完成不同的功能,显得过于繁琐,不利于标签技术的推广, SUN公司为降低标签技术的学习难度,在JSP 2.0中定义了一个更为简单、便于编写和调用的SimpleTag接口来实现标签的功能。实现SimpleTag接口的标签通常称为简单标签。简单标签共定义了5个方法:

?setJspContext方法

?setParent和getParent方法

?setJspBody方法

?doTag方法



二,SimpleTag方法介绍

 setJspContext方法 

?用于把JSP页面的pageContext对象传递给标签处理器对象

setParent方法 

?用于把父标签处理器对象传递给当前标签处理器对象

getParent方法

?用于获得当前标签的父标签处理器对象

setJspBody方法 

?用于把代表标签体的JspFragment对象传递给标签处理器对象

doTag方法 

?用于完成所有的标签逻辑,包括输出、迭代、修改标签体内容等。在doTag方法中可以抛javax.servlet.jsp.SkipPageException异常,用于通知WEB容器不再执行JSP页面中位于结束标记后面的内容,这等效于在传统标签的doEndTag方法中返回Tag.SKIP_PAGE常量的情况。



三,SimpleTag接口方法的执行顺序

l当web容器开始执行标签时,会调用如下方法完成标签的初始化

1,?WEB容器调用标签处理器对象的setJspContext方法,将代表JSP页面的pageContext对象传递给标签处理器对象。

2,?WEB容器调用标签处理器对象的setParent方法,将父标签处理器对象传递给这个标签处理器对象。注意,只有在标签存在父标签的情况下,WEB容器才会调用这个方法。

3,?如果调用标签时设置了属性,容器将调用每个属性对应的setter方法把属性值传递给标签处理器对象。如果标签的属性值是EL表达式或脚本表达式,则WEB容器首先计算表达式的值,然后把值传递给标签处理器对象。

4,?如果简单标签有标签体,容器将调用setJspBody方法把代表标签体的JspFragment对象传递进来。

l执行标签时:

1,?容器调用标签处理器的doTag()方法,开发人员在方法体内通过操作JspFragment对象,就可以实现是否执行、迭代、修改标签体的目的。



四,JspFragment类

javax.servlet.jsp.tagext.JspFragment类是在JSP2.0中定义的,它的实例对象代表JSP页面中的一段符合JSP语法规范的JSP片段,这段JSP片段中不能包含JSP脚本元素。

WEB容器在处理简单标签的标签体时,会把标签体内容用一个JspFragment对象表示,并调用标签处理器对象的setJspBody方法把JspFragment对象传递给标签处理器对象。JspFragment类中只定义了两个方法,如下所示:

 getJspContext方法 

?用于返回代表调用页面的JspContext对象.

public abstract void invoke(java.io.Writer out) 

?用于执行JspFragment对象所代表的JSP代码片段 ?参数out用于指定将JspFragment对象的执行结果写入到哪个输出流对象中,如果传递给参数out的值为null,则将执行结果写入到JspContext.getOut()方法返回的输出流对象中。(简而言之,可以理解为写给浏览器)



五,invoke方法详解  

?在标签处理器中如果没有调用JspFragment.invoke方法,其结果就相当于忽略标签体内容;

?在标签处理器中重复调用JspFragment.invoke方法,则标签体内容将会被重复执行;

?若想在标签处理器中修改标签体内容,只需在调用invoke方法时指定一个可取出结果数据的输出流对象(例如StringWriter),让标签体的执行结果输出到该输出流对象中,然后从该输出流对象中取出数据进行修改后再输出到目标设备,即可达到修改标签体的目的。

代码:(标签处理器类)

/*
 * 输出标签体
 */
public class SimpleTagDemo1 extends SimpleTagSupport {

	@Override
	public void doTag() throws JspException, IOException {
		JspFragment jf = this.getJspBody();
		jf.invoke(null);
	}
}

/*
 * 循环输出标签体
 */
 public class SimpleTagDemo2 extends SimpleTagSupport {

	@Override
	public void doTag() throws JspException, IOException {
		JspFragment jf = this.getJspBody();
		for(int i=0;i<5;i++){
			jf.invoke(null);
		}
	}
}
 
 
/*
 * 修改内容
 */
 public class SimpleTagDemo3 extends SimpleTagSupport {

	@Override
	public void doTag() throws JspException, IOException {

		JspFragment jf = this.getJspBody();
		StringWriter sw = new StringWriter();
		jf.invoke(sw);//将内容写入缓冲
		String content = sw.toString(); //获取缓冲区的内容进行修改
		content = content.toUpperCase();
		this.getJspContext().getOut().write(content);
	}
}
 
 
/*
 * 采用抛异常的方式在阻止内容执行
 */
 public class SimpleTagDemo4 extends SimpleTagSupport {

	@Override
	public void doTag() throws JspException, IOException {
		throw new SkipPageException();
	}
}

tld描述文件:

<?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>/yujian_simple</uri>
    
     
    <tag>
        <name>simpledemo1</name>
	<tag-class>cn.yujian.web.simpletag.SimpleTagDemo1</tag-class>
	<body-content>scriptless</body-content><!--scriptless表示不能有脚本代码-->
    </tag>
    
    
    <tag>
        <name>simpledemo2</name>
	<tag-class>cn.yujian.web.simpletag.SimpleTagDemo2</tag-class>
	<body-content>scriptless</body-content>
    </tag>
    
     <tag>
        <name>simpledemo3</name>
	<tag-class>cn.yujian.web.simpletag.SimpleTagDemo3</tag-class>
	<body-content>scriptless</body-content>
    </tag>
    
    <tag>
        <name>simpledemo4</name>
	<tag-class>cn.yujian.web.simpletag.SimpleTagDemo4</tag-class>
	<body-content>scriptless</body-content>
    </tag>
    
</taglib>

jsp页面:

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%@taglib uri="/yujian_simple" prefix="flx" %>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
    <title>用简单标签控制页面内容是否输出</title>
  </head>
  
  <body>
  	<flx:simpledemo1>
    	This is my JSP page. <br>
    </flx:simpledemo1>
  </body>
</html>
<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%@taglib uri="/yujian_simple" prefix="flx" %>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
    <title>用简单标签控制页面内容重复输出</title>
  </head>
  
  <body>
  	<flx:simpledemo2>
    	This is my JSP page. <br>
    </flx:simpledemo2>
  </body>
</html>
<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%@taglib uri="/yujian_simple" prefix="flx" %>

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<flx:simpledemo4/>
  <head>
    <title>用简单标签控制整个页面是否执行</title>
  </head>
  
  <body>
    	This is my JSP page. <br>
  </body>
</html>


开发带属性的标签

自定义标签可以定义一个或多个属性,这样,在JSP页面中应用自定义标签时就可以设置这些属性的值,通过这些属性为标签处理器传递参数信息,从而提高标签的灵活性和复用性。

要想让一个自定义标签具有属性,通常需要完成两个任务:

?在标签处理器中编写每个属性对应的setter方法

?在TLD文件中描术标签的属性

l为自定义标签定义属性时,每个属性都必须按照JavaBean的属性命名方式,在标签处理器中定义属性名对应的setter方法,用来接收JSP页面调用自定义标签时传递进来的属性值。例如属性url,在标签处理器类中就要定义相应的setUrl(Stringurl)方法。

l在标签处理器中定义相应的set方法后,JSP引擎在解析执行开始标签前,也就是调用doStartTag方法前,会调用set属性方法,为标签设置属性。

代码:

public class SimpleTagDemo5 extends SimpleTagSupport {

	private int count;
	private Date birthday;
	public void setBirthday(Date birthday) {
		this.birthday = birthday;
	}
	public void setCount(int count) {
		this.count = count;
	}
	@Override
	public void doTag() throws JspException, IOException {

		System.out.println(this.birthday);
		for(int i=0;i<count;i++){
			this.getJspBody().invoke(null);
		}
	}
}

tld描述文件:

   <tag>
                <name>simpledemo5</name>
		<tag-class>cn.yujian.web.simpletag.SimpleTagDemo5</tag-class>
		<body-content>scriptless</body-content>

		<attribute>
			<name>count</name>
			<required>true</required>
			<rtexprvalue>true</rtexprvalue>
		</attribute>

		<attribute>
			<name>birthday</name>
			<required>true</required>
			<rtexprvalue>true</rtexprvalue>
		</attribute>

    </tag>

jsp文件:

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%@taglib uri="/yujian_simple" prefix="flx" %>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
    <title>带属性的标签</title>
  </head>
  
  <body>
  	<flx:simpledemo5 count="10" birthday="<%=new Date() %>">
    	This is my JSP page. <br>
    </flx:simpledemo5>
  </body>
</html>

在TLD中描述标签属性attribute:


description   不是必须;

用于指定属性的描述信息。


name  是必须;

用于指定属性的名称。属性名称是大小写敏感的,并且不能以jsp、_jsp、java和sun

开头。   


required   不是必须;

用于指定在JSP页面中调用自定义标签时是否必须设置这个属性。其取值包括true和

false,默认值为false,true表示必须设置,否则可以设置也可以不设置该属性。



rtexprvalue  不是必须;

rtexprvalue是runtime expression value(运行时表达式)的英文简写,用于指定属性值是一个静态值或动态值。其取值包括true和false,默认值为false,false表示只能为该属性指定静态文本值,例如"123";true表示可以为该属性指定一个JSP动态元素,动态元素的结果作为属性值,例如JSP表达式<%=value %>。


type   不是必须;

用于指定属性值的Java类型。



jsp中的自定义标签

时间: 2024-11-06 07:48:54

jsp中的自定义标签的相关文章

JSP入门之自定义标签

第二部分简单讲解:主要讲解el表达式,核心标签库.本章主要讲解:自定义标签库:404页面,505页面,错误页面配置方法 全部代码下载:链接 1.JSP自定义标签: 自定义标签是用户定义的JSP语言元素.当JSP页面包含一个自定义标签时将被转化为servlet,标签转化为对被 称为tag handler的对象的操作,即当servlet执行时Web container调用那些操作.JSP标签扩展可以让你创建新的标签并且可以直接插入到一个JSP页面. JSP 2.0规范中引入Simple Tag Ha

自定义JSP中的Taglib标签之四自定义标签中的Function函数

转自http://www.cnblogs.com/edwardlauxh/archive/2010/05/19/1918589.html 之前例子已经写好了,由于时间关系一直没有发布,这次带来的是关于taglib中的<tag>的基本功能已经介绍完毕了,在taglib中我们发现有一个标签叫做<function>,这次简单介绍<function>标签的基本用法,<function>标签可以做什么呢?它可以让我们在jsp用直接调用某个方法,根据自定义的方法返回指定

JSP笔记——7.自定义标签

jsp标签具有与html标签一样的格式,可以用来代替jsp中的Java脚本,使代码简介.使用自定义标签之前需要建立一个*.tld文件,每个文件对应一个标签库,里面可以包含很多的自定义标签. 每一个标签都必须由一个继承了SimpleTagSupport类的实现类来实现.类里面的属性必须有get与set方法.需要重写doTag方法,实际上此方法真正完成标签的工作. 创建tld文件  创建的时候最好找一个现成的tld文件,复制进去然后修改uri(此uti能够告诉jsp页面,这个前缀引导的标签应该与哪个

JSP 2.x 自定义标签

JSP 1.x的标签,虽然使用起来非常灵活,但是比较复杂,JSP 2.x提供了一组简化的标签写法 SimpleTagSupport是SimpleTag接口的子类,同时支持参数和标签体,最核心的方法时doTage public AddTag extends SimpleTagSupport{ private int num1; private int num2; public void doTag() throws JspException,IOException{ this.getJspCont

jsp中常用的标签

jsp本质上就是一个servlet,只是tomcat会将其翻译成servlet,servlet本质上是一个类,那么jsp也是一个类.jsp中各种标签都会被tomcat翻译成各种基本的java代码 如果一个jsp页面中定义了变量,在另外一个地方可以直接获取,例如 <% String name = "zhangsan"; %> <%= name %> 但是大家请注意了,现在的开发都不在jsp中写java代码,以上是java代码,现在就是需要用到jsp的标签.什么叫j

如何在JSP中增加c标签

//在JSP页面第二行加入下列语句即可<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %> c标签使用情况: <c:forEach items="${caplist}" var="mr"> <tr> <td class="c3"><c:out value="${mr.i

JSP中利用JSTL标签对日期格式化

数据库:Mysql 开发语言:JAVA 页面类型:JSP 对Mysql中的日期类型格式化,在JSP中,如何办呢,很多人说在JAVA后台去日期格式化,无奈了,于是找到了比较靠谱的答案 需要先引入JSTL库 <%@ taglib uri="http://java.sun.com/jsp/jstl/fmt" prefix="fmt"%> 其次对JSP输出的日期进行格式化 <span>发布时间:<fmt:formatDate value=&qu

【转载】Android中attr自定义标签详解

原文链接:http://blog.sina.com.cn/s/blog_62ef2f14010105vi.html:仅对排版进行优化,更方便阅读 <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:wen=http://schemas.android.com/apk/res/com.iteye.googlers android:orientation="vertic

在html中创建自定义标签

创建并使用自定义标签 Web Components 标准非常重要的一个特性是,它使开发者能够将HTML页面的功能封装为 custom elements(自定义标签),本篇介绍使用 CustomElementRegistry 来管理我们的自定义标签 1. 创建自定义标签 <script> class PopUpInfo extends HTMLElement { constructor () { super(); // 在此定义自定义标签 我顶一个icon和text并列的 // Create a