标签库一般包括两个文件,其一是类包JAR文件,其二是以.tld为扩展名的标签符描述文件。从下载的压缩文档中解压后,我们将taglibs-datetime.jar和taglibs-datetime.tld文件放到<工程目录>/datetimeTag目录下。
要在工程中使用第三方的标签库,必须事先在JBuilder中配置这个标签库,并在工程中引用它。配置标签库和配置类库相似,也是通过Configure Libraries对话框来完成。JBuilder类库及标签库都列在Configure Libraries对话框中左边的树中,类库显示为
![](http://www.yesky.com/image20010518/305129.jpg)
![](http://www.yesky.com/image20010518/305127.jpg)
1.Tools->Configure->Libraries->Configure Libraries对话框。
点击Configure Libraries对话框的左下角的Add...按钮,弹出New Library Wizard对话框,如下图所示:
![](http://www.mobanku.com/file/jsp/images/305128.jpg)
图 17新库向导对话框
在Name中给这个库取一个名字:datetimeTag,按OK返回Configure Libraries对话框。
2.指定标签库文件。
在返回Configure Libraries对话框后,datetimeTag节点出现在左边的树中,因为还没有为其指定类库文件,有别于其他节点显示为显目的红色,点选datetimeTag并将Library Settings设置页切换到Framework标签页中,如下图所示:
![](http://www.mobanku.com/file/jsp/images/305130.jpg)
图 18 切换到Framework中
在Framework下拉框中选择User-Defined JSP Tag Library选项,点击标签页右下方的Add...按钮,弹出Define New Tag Library对话框,如下图所示:
![](http://www.mobanku.com/file/jsp/images/305131.jpg)
图 19 指定标签库的描述文件
在Define New Tag Library对话框中,点击TLD file后的…按钮,导航到<工程目录>/datetimeTag/taglibs-datetime.tld文件中,确认后JBuilder自动填充其余的设置项,一般不需要更改JBuilder这些自动补充的设置。其中Prefix为这个标签库指定了一个引用前缀。点击OK按钮返回Configure Libraries对话框,datetimeTag节点显示为正常的颜色如下图所示:
![](http://www.mobanku.com/file/jsp/images/305132.jpg)
图 20 正确配置标签库后的效果
点击Configure Libraries对话框的OK按钮完成datetime标签库的配置。
3.在当前工程中引用这个新配置的标签库。
Project->Project Properties...->Paths->切换到Required Libraries标签页中->点击Add...按钮从JBuilder类库中选择datetimeTag。配置成功后,Project Properties对话框如下所示:
![](http://www.mobanku.com/file/jsp/images/305133.jpg)
图 21 工程引用库
创建欢迎JSP页面
1.File->New…->Web->双击JSP图标,启动创建JSP向导,指定JSP文件名为welcome,点击Next到下一步。
2.在welcome.jsp页面中引用datetimeTag标签库。
在向导的第2步中允许你选择JBuilder中的各种标签库,我们在上一节中配置的datetimeTag标签库也出现在Tag Libraries列表中,如下图所示:
![](http://www.mobanku.com/file/jsp/images/305134.jpg)
图 22 引用标签库
展开datetime Tag并勾选taglibs-datetime,按Next到一下步。
3.引用在switch.jsp中放入session域的userBean对象。
![](http://www.mobanku.com/file/jsp/images/305135.jpg)
图 23 引用switch.jsp中放入session的userBean
点击Add Bean...选择bookstore.User类,在ID栏中指定Bean的名字为ses_userBean,Scope栏中选择session作用域。ses_userBean即是在switch.jsp为userBean所指定的名字,Web容器将根据这个名字到session中查找对象,如果找不到才创建bookstore.User对象,因为welcome.jsp在switch.jsp之后才被调用,所以除非session对期,否则都可以找到userBean对象。
直接点击Finish创建welcome.jsp文件,其代码如下所示:
代码清单 15 welcome.jsp欢迎页面
1. <%@ page contentType="text/html; charset=GBK" %>
2. <%@ taglib uri="http://jakarta.apache.org/taglibs/datetime-1.0" prefix="dt" %>
3. <html>
4. <head>
5. <title>
6. welcome
7. </title>
8. </head>
9. <jsp:useBean id="ses_userBean" scope="session" class="bookstore.User" />
10. <jsp:setProperty name="ses_userBean" property="*" />
11. <body bgcolor="#ffffff">
12. <h1>
13. JBuilder Generated JSP
14. </h1>
15. </body>
16. </html>
在向导第2步所引用的标签库设置对应第2行的引用标签库声明代码。而在第3步中设定的Bean对应第9~10行代码,因为在welcome.jsp中无需填充Bean的值,所以应该手工去除第10行的代码。
下面我们在welcome.jsp文件中引用datetime标签库,用它生成一个当前时间格式化串。打开welcone.jsp文件并切换到Source视图页中。首先清除<body></body>中JBuilder所产生的代码,在<body></body>中输入"<dt:",JBuilder将使用TagInsight功能显示出这个标签库中所有可用的标签项,如下图所示:
![](http://www.mobanku.com/file/jsp/images/305136.jpg)
图 24 利用TagInsight录入标签库
使用TagInsight可以非常方便地录入标签库中的可用标签,大大加速标签库的代码录入并保证正确性。在welcome.jsp中我们使用标签库获得一个当前的格式化时间串,此外我们还通过ses_userBean获取用户的名字。welcome.jsp的最终代码如下所示:
代码清单 16 welcome.jsp 引用标签库和Session对象
1. <%@page contentType="text/html; charset=GBK" errorPage="error.jsp"%>
2. <%@taglib uri="http://jakarta.apache.org/taglibs/datetime-1.0" prefix="dt"%>
3. <html>
4. <head>
5. <title>welcome</title>
6. </head>
7. <jsp:useBean id="ses_userBean" scope="session" class="bookstore.User"/>
8. <body bgcolor="#ffffff">你是
9. <%=ses_userBean.getUserName()%>,欢迎登录。<br>
10. 现在的时间是<dt:表单at pattern="MM/dd/yyyy hh:mm"><dt:currentTime/></dt:表单at>
11. <br>点击<a href="quit.jsp">这儿</a>退出系统
12. </body>
13. </html>
此外,JBuilder将datetime标签库描述文件taglibs-datetime.tld拷贝到WEB-INF下,并对web.xml文件动了手脚,声明taglibs-datetime.tld所在的地址:
代码清单 17 web.xml中声明标签描述文件
1. <?xml version="1.0" encoding="UTF-8"?>
2. …
3. <web-app>
4. <taglib>
5. <taglib-uri>http://jakarta.apache.org/taglibs/datetime-1.0</taglib-uri>
6. <taglib-location>/WEB-INF/taglibs-datetime.tld</taglib-location>
7. </taglib>
8. </web-app>
如上所示,web.xml的第4~7行,JBuilder自动加入了datetime标签库的描述文件,以便Web容器正确找到所需的信息。
在编译工程生成Web目录时,JBuilder会将datetime标签库的JAR文件taglibs-datetime.jar拷贝到WEB-INF/lib目录下。
当用户登录成功后,将转向welcome.jsp页面,其页面效果如下图所示:
![](http://www.mobanku.com/file/jsp/images/305137.jpg)
图 25 welcome.jsp效果页面
当用户点击"这儿"的链接时,将链接到quit.jsp,quit.jsp页面负责清除session,清除session后,将引用session中的对象解绑并释放资源。
quit.jsp退出处理页面
由于HTTP协议以请求/响应的方式工作,所以客户端退出系统时需要主动往Web服务器发送一个请求,通知Web服务器及时销毁会话,否则Web服务器只会等到会话过期时才会销毁它。
我们用一个quit.jsp来处理用户退出系统的操作,quit.jsp负责注销session,及时释放资源。
·注销session。
·关闭浏览器窗口。
其代码如下所示:
1. <%@ page contentType="text/html; charset=GBK" %>
2. <%
3. session.invalidate();
4. %>
5. <script language="javaScript" >
6. window.opener = null;
7. window.close();
8. </script>
其中第3行负责注销session,原先放入session的对象将解绑定,等待垃圾回收以释放资源。对于本例而言,session中有一个名为ses_userBean的userBean对象(它是在switch.jsp中放入session的),调用session.invalidate()后,userBean从session中解绑定,它的valueUnbound()方法会被触发调用,然后再等待垃圾回收。
第5~8行是一段JavaScript脚本程序,负责关闭窗口,如果网页不是通过脚本程序打开的(window.open()),调用window.close()脚本关闭窗口前,必须先将window.opener对象置为null,如第6行所示,否则浏览器会弹出一个确定关闭的对话框,笔者发现这个问题困扰了不少的Web程序员,故特别指出。
实战经验:
在用户退出系统时,需要注销session,否则只有等到session在服务器中过期后, session对象才会被清除。假设一个session的不活动最大时间为30分钟(默认的时间),如果不手工清除session对象,则当一个用户退出系统后再过30分钟,这些对象所占用的系统资源才会被释放。