JBuilder2005实战JSP之特殊页面
- 中国WEB开发者网络 (http://www.webasp.net)
-- 技术教程 (http://www.webasp.net/article/)
--- JBuilder2005实战JSP之特殊页面 (http://www.webasp.net/article/27/26205.htm)
-- 发布日期： 2005-09-06
当用户录入正确的密码后，switch.jsp控制JSP页面导向welcome.jsp欢迎页面，在这节里，我们来开发这个welcome.jsp页面。因为welcome.jsp需要使用到一个第三方的标签库，所以在开发welcome.jsp之前需要在JBuilder中作一些配置引入这个标签库。
将第三方标签库配置到JBuilder中
Apache开源组织提供了许多有用标签库，欢迎页面welcome.jsp需要使用一个来源于Apache的datetime标签库，可以用这个标签库在JSP中提供各种时间的显示，下载的地址是：http://apache.justdn.org/jakarta/taglibs/datetime/binaries/jakarta-taglibs-datetime-1.0.1.zip。
标签库一般包括两个文件，其一是类包JAR文件，其二是以.tld为扩展名的标签符描述文件。从下载的压缩文档中解压后，我们将taglibs-datetime.jar和taglibs-datetime.tld文件放到＜工程目录＞/datetimeTag目录下。
要在工程中使用第三方的标签库，必须事先在JBuilder中配置这个标签库，并在工程中引用它。配置标签库和配置类库相似，也是通过Configure Libraries对话框来完成。JBuilder类库及标签库都列在Configure Libraries对话框中左边的树中，类库显示为
图标，而标签库显示为
图标。下面我们来将datetime标签库配置到JBuilder中。1．Tools-＞Configure-＞Libraries-＞Configure Libraries对话框。
点击Configure Libraries对话框的左下角的Add...按钮，弹出New Library Wizard对话框，如下图所示：
 图 17新库向导对话框 |
在Name中给这个库取一个名字：datetimeTag，按OK返回Configure Libraries对话框。
2．指定标签库文件。
在返回Configure Libraries对话框后，datetimeTag节点出现在左边的树中，因为还没有为其指定类库文件，有别于其他节点显示为显目的红色，点选datetimeTag并将Library Settings设置页切换到Framework标签页中，如下图所示：
 图 18 切换到Framework中 |
在Framework下拉框中选择User-Defined JSP Tag Library选项，点击标签页右下方的Add...按钮，弹出Define New Tag Library对话框，如下图所示：
 图 19 指定标签库的描述文件 |
在Define New Tag Library对话框中，点击TLD file后的…按钮，导航到＜工程目录＞/datetimeTag/taglibs-datetime.tld文件中，确认后JBuilder自动填充其余的设置项，一般不需要更改JBuilder这些自动补充的设置。其中Prefix为这个标签库指定了一个引用前缀。点击OK按钮返回Configure Libraries对话框，datetimeTag节点显示为正常的颜色如下图所示：
 图 20 正确配置标签库后的效果 |
点击Configure Libraries对话框的OK按钮完成datetime标签库的配置。
3．在当前工程中引用这个新配置的标签库。
Project-＞Project Properties...-＞Paths-＞切换到Required Libraries标签页中-＞点击Add...按钮从JBuilder类库中选择datetimeTag。配置成功后，Project Properties对话框如下所示：
 图 21 工程引用库 |
创建欢迎JSP页面
1．File-＞New…-＞Web-＞双击JSP图标，启动创建JSP向导，指定JSP文件名为welcome，点击Next到下一步。
2．在welcome.jsp页面中引用datetimeTag标签库。
在向导的第2步中允许你选择JBuilder中的各种标签库，我们在上一节中配置的datetimeTag标签库也出现在Tag Libraries列表中，如下图所示：
 图 22 引用标签库 |
展开datetime Tag并勾选taglibs-datetime，按Next到一下步。
3．引用在switch.jsp中放入session域的userBean对象。
 图 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功能显示出这个标签库中所有可用的标签项，如下图所示：
图 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页面，其页面效果如下图所示：
 图 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分钟，这些对象所占用的系统资源才会被释放。 |