JSP标签自定义的详细介绍

JSP标签自定义的详细介绍

最近一直在学习自定义标签,于是就想试着去实现一些JSP中自带的标签库功能,顺便也把反射机制复习一下。(如果你对这两种技术不很熟悉,这篇blog的最下边有一些关于反射和自定义标签的example和PPT文档下载)

今天要实现的功能是useBean标签。下表是它的一些属性和用途。(我只选了个比较重要的属性,并没有实现所有属性)

 

属性 用途
id 给将要应用bean的变量一个名字,如果发现有相同id和scope的bean对象,则应用此对象而不会产生一个新的例示。
class 指明了bean的整个包名。
scope 表明了此bean的作用范围,共有四个值:page, request, session, 和 application,缺省的是page属性,表明此bean只能应用于当前页(保存在当前页的PageContext 中);request属性表明此bean只能应用于当前的用户请求中(保存在ServletRequest对象中);session属性表明此bean能应用于当前HttpSession生命周期内的所有页面;application属性值则表明此bean能应用于共享ServletContext的所有页面。需要注意的是,当没有具有相同的id和scope对象时,一个jsp:useBean 实体只能作用于一个新的例示中,反之,则作用于以前的对象,这时,在jsp:useBean标签之间的任何jsp:setParameter和其它实体都将被忽略。
type 说明将要索引对象的变量类型,它必须与类名及父类名相匹配。记住,这个变量的名字是由id属性值代替的。
beanName 给定此bean的名字,可以将其提供给bean的例示方法,只提供beanName和type而忽略class属性的情况是允许的。

下面是标签处理方法类:UseBean.java:

import javax.servlet.jsp.*;

import javax.servlet.jsp.tagext.*;

import java.lang.reflect.*;

//

public class UseBean extends TagSupport{ //继承自TagSupport类

private String scope;

private String type;

public UseBean(){super();}

/**

*设置属性存取方法,这个方法由容器自动调用。setId()和getId()由系统自动实现

*/

public void setScope(String s) {

this.scope = s;

}

public String getScope(){return this.scope;}

public void setType(String type){

this.type=type;

}

public String getType(){return this.type;}

/**

*覆盖doStartTag方法

*/

public int doStartTag() throws JspTagException

{

Object o = null;

// find the bean in the specified scope

if (scope.equals("page")) {

o = pageContext.getAttribute(getId(),PageContext.PAGE_SCOPE);

} else if (scope.equals("request")) {

o = pageContext.getAttribute(getId(), PageContext.REQUEST_SCOPE);

} else if (scope.equals("session")) {

o = pageContext.getAttribute(getId(), PageContext.SESSION_SCOPE);

} else if (scope.equals("application")) {

o = pageContext.getAttribute(getId(), PageContext.APPLICATION_SCOPE);

}

if(o==null)

{

System.out.println("o is null!");

try{

Class u=Class.forName(type);

o=u.newInstance();//无参构造方法

System.out.println("create success!");

}

catch(Exception e){

throw new JspTagException("error to created a "+getId()+" object!");

}

}

pageContext.setAttribute(getId(), o); //保存实例对象到上下文对象中

return EVAL_BODY_INCLUDE; //返回类型

}

}

现在我们已经把对象实例放到pageContext里了,是不是这样就可以在JSP页面中直接引用了?当然不是了,直接将JAVA对象放进pageContext中与在脚本中直接引用是不同的。差别在于JSP容器要负责取得这个对象,以脚本变量的形式提供给页面。即JSP容器负责来维护脚本变量与pageContext中相应对象的状态。有两种方法可以为自定义标签来声明脚本变量。

一种是声明variable,一种是通过TagExtraInfo类声明变量。前者是JDK1.2后的方法,优点是比较方便。后者因为要再写一个类文件,所以显得麻烦些,但更灵活,出于兼容性与功能上的考虑,建议还是采用后者。(关于此类的详细说明,请参考PPT文档)

import javax.servlet.jsp.*;

import javax.servlet.jsp.tagext.*;

public class UseBeanTag extends TagExtraInfo {

public VariableInfo[] getVariableInfo(TagData data) {

return new VariableInfo[] {

new VariableInfo(

data.getId(),

data.getAttributeString("type"),

true,

VariableInfo.AT_BEGIN)

};

}

}

现在,定义一个useBean标签的工作已进行大半,下面该定义标签库描述(TLD)文件了,该文件是一个XML文档,主要定义标签的属性、处理类和扩展信息类的声明。主要声明部分如下:(tag.tld)

……………………(省去标头部分)

<!-- useBEAN 标签-->

<tag>

<name>useBEAN</name>

<!—声明标签处理类-->

<tag-class>cn.dever.tag.UseBean</tag-class>

<!—声明标签扩展信息类-->

<tei-class>cn.dever.taginfo.UseBeanTag</tei-class>

<!—主体内容类型-->

<body-content>jsp</body-content>

<!—属性设置-->

<attribute>

<name>scope</name>

<!—是否必选-->

<required>true</required>

<!—是否可以使用JSP表达式-->

<rtexprvalue>true</rtexprvalue>

</attribute>

 

<attribute>

<name>id</name>

<required>true</required>

<rtexprvalue>true</rtexprvalue>

</attribute>

 

<attribute>

<name>type</name>

<required>true</required>

<rtexprvalue>true</rtexprvalue>

</attribute>

</tag>

其实这个标签库描述文件应该是最先建立的,因为我们主要是为了说明实现的方法,所以标签描述放在后边了。接下就是将刚才做的这些东西部署到我们的应用中去。在目标JSP页面中引用一下就OK了。

<%@ taglib uri="/WEB-INF/tag.tld" prefix="dever" %>

<dever:useBEAN id="test" type="cn.dever.common.User" scope="page" />


OK,到此为止,我们自定义的useBean标签已经可以开始工作了,是不是觉得很容易,其实本来就不难,只要大家掌握了定义标签的流程和配置方法,剩下的就只是写标签处理类了,在以后的几篇blog中,我就不再详述这些部署和配置,直接给出标签处理类的代码。

自定义标签PPT

反射机制example