今天要实现的功能是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,到此为止