JSP编程进度条设计实例

     许多Web应用、企业应用涉及到长时间的操作，例如复杂的数据库查询或繁重的XML处理等，虽然这些任务主要由数据库系统或中间件完成，但任务执行的结果仍旧要借助JSP才能发送给用户。本文介绍了一种通过改进前端表现层来改善用户感觉、减轻服务器负载的办法。

当JSP调用一个必须长时间运行的操作，且该操作的结果不能（在服务器端）缓冲，用户每次请求该页面时都必须长时间等待。很多时候，用户会失去耐心，接着尝试点击浏览器的刷新按钮，最终失望地离开。

本文介绍的技术是把繁重的计算任务分离开来，由一个独立的线程运行，从而解决上述问题。当用户调用JSP页面时，JSP页面会立即返回，并提示用户任务已经启动且正在执行；JSP页面自动刷新自己，报告在独立线程中运行的繁重计算任务的当前进度，直至任务完成。

一、模拟任务

首先我们设计一个TaskBean类，它实现java.lang.Runnable接口，其run()方法在一个由JSP页面（start.jsp）启动的独立线程中运行。终止run()方法执行由另一个JSP页面stop.jsp负责。TaskBean类还实现了java.io.Serializable接口，这样JSP页面就可以将它作为JavaBean调用：

package test.barBean;

import java.io.Serializable;

public class TaskBean implements Runnable, Serializable {

private int counter;

private int sum;

private boolean started;

private boolean running;

private int sleep;

public TaskBean() {

counter = 0;

sum = 0;

started = false;

running = false;

sleep = 100;

}

}

　　TaskBean包含的“繁重任务”是计算1+2+3…+100的值，不过它不通过100*(100+1)/2=5050公式计算，而是由run()方法调用work()方法100次完成计算。work()方法的代码如下所示，其中调用Thread.sleep()是为了确保任务总耗时约10秒。

protected void work() {

try {

Thread.sleep(sleep);

counter++;

sum += counter;

} catch (InterruptedException e) {

setRunning(false);

}

}

　　status.jsp页面通过调用下面的getPercent()方法获得任务的完成状况：

public synchronized int getPercent() {

return counter;

}

　　如果任务已经启动，isStarted()方法将返回true：

public synchronized boolean isStarted() {

return started;

}

　　如果任务已经完成，isCompleted()方法将返回true：

public synchronized boolean isCompleted() {

return counter == 100;

}

　　如果任务正在运行，isRunning()方法将返回true：

public synchronized boolean isRunning() {

return running;

}

　　SetRunning()方法由start.jsp或stop.jsp调用，当running参数是true时。SetRunning()方法还要将任务标记为“已经启动”。调用setRunning(false)表示要求run()方法停止执行。

public synchronized void setRunning(boolean running) {

this.running = running;

if (running)

started = true;

}

　　任务执行完毕后，调用getResult()方法返回计算结果；如果任务尚未执行完毕，它返回null：

public synchronized Object getResult() {

if (isCompleted())

return new Integer(sum);

else

return null;

}

　　当running标记为true、completed标记为false时，run()方法调用work()。在实际应用中，run()方法也许要执行复杂的SQL查询、解析大型XML文档，或者调用消耗大量CPU时间的EJB方法。注意“繁重的任务”可能要在远程服务器上执行。报告结果的JSP页面有两种选择：或者等待任务结束，或者使用一个进度条。

public void run() {

try {

setRunning(true);

while (isRunning() && !isCompleted())

work();

} finally {

setRunning(false);

}

}

　　二、启动任务

　　start.jsp是web.xml部署描述符中声明的欢迎页面，web.xml的内容是：

＜?xml version="1.0" encoding="GB2312"?>

＜!DOCTYPE web-app

PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"

"http://java.sun.com/dtd/web-app_2_3.dtd">

＜web-app>

＜welcome-file-list>

＜welcome-file>start.jsp＜/welcome-file>

＜/welcome-file-list>

＜/web-app>

　　start.jsp启>动一个专用的线程来运行“繁重的任务”，然后把HTTP请求传递给status.jsp。

　　start.jsp页面利用＜jsp:useBean>标记创建一个TaskBean的实例，将scope属性定义为session使得对于来自同一浏览器的HTTP请求，其他页面也能提取到同一个Bean对象。start.jsp通过调用session.removeAttribute("task")确保＜jsp:useBean>创建了一个新的Bean对象，而不是提取一个旧对象（例如，同一个用户会话中更早的JSP页面所创建的Bean对象）。

　　下面是start.jsp页面的代码清单：

＜% session.removeAttribute("task"); %>

＜jsp:useBean id="task" scope="session"

class="test.barBean.TaskBean"/>

＜% task.setRunning(true); %>

＜% new Thread(task).start(); %>

＜jsp:forward page="status.jsp"/>

　　start.jsp创建并设置好TaskBean对象之后，接着创建一个Thread，并将Bean对象作为一个Runnable实例传入。调用start()方法时新创建的线程将执行TaskBean对象的run()方法。

　　现在有两个线程在并发执行：执行JSP页面的线程（称之为“JSP线程”），由JSP页面创建的线程（称之为“任务线程”）。接下来，start.jsp利用调用status.jsp，status.jsp显示出进度条以及任务的执行情况。注意status.jsp和start.jsp在同一个JSP线程中运行。

　　start.jsp在创建线程之前就把TaskBean的running标记设置成了true，这样，即使当JSP线程已开始执行status.jsp而任务线程的run()方法尚未启动，也能够确保用户会得到“任务已开始运行”的状态报告。

　　将running标记设置成true、启动任务线程这两行代码可以移入TaskBean构成一个新的方法，然后由JSP页面调用这个新方法。一般而言，JSP页面应当尽量少用Java代码，即我们应当尽可能地把Java代码放入Java类。不过本例中我们不遵从这一规则，把new Thread(task).start()直接放入start.jsp突出表明JSP线程创建并启动了任务线程。

　　在JSP页面中操作多线程必须谨慎，注意JSP线程和其它线程实际上是并发执行的，就象在桌面应用程序中，我们用一个线程来处理GUI事件，另外再用一个或多个线程来处理后台任务。不过在JSP环境中，考虑到多个用户同时请求某一个页面的情况，同一个JSP页面可能会在多个线程中同时运行；另外，有时同一个用户可能会向同一个页面发出多个请求，虽然这些请求来自同一个用户，它们也会导致服务器同时运行一个JSP页面的多个线程。

　　三、任务进度

　　status.jsp页面利用一个HTML进度条向用户显示任务的执行情况。首先，status.jsp利用＜jsp:useBean>标记获得start.jsp页面创建的Bean对象：

＜jsp:useBean id="task" scope="session"

class="test.barBean.TaskBean"/>

　　为了及时反映任务执行进度，status.jsp会自动刷新。JavaScript代码setTimeout("location='status.jsp'", 1000)将每隔1000毫秒刷新页面，重新请求status.jsp，不需要用户干预。

＜HTML>

＜HEAD>

＜TITLE>JSP进度条＜/TITLE>

＜% if (task.isRunning()) { %>

＜SCRIPT LANGUAGE="JavaScript">

setTimeout("location='status.jsp'", 1000);

＜/SCRIPT>

＜% } %>

＜/HEAD>

＜ODY>

　　进度条实际上是一个HTML表格，包含10个单元——即每个单元代表任务总体的10%进度。

＜H1 ALIGN="CENTER">JSP进度条＜/H1>

＜H2 ALIGN="CENTER">

结果:

＜%= task.getResult(＜) %>＜BR>

% int percent = task.getPercent(); %>

＜%= percent %>%

＜/H2>

＜TABLE WIDTH="60%" ALIGN="CENTER"

BORDER=1 CELLPADDING=0 CELLSPACING=2>

＜TR>

＜% for (int i = 10; i ＜= percent; i += 10) { %>

＜TD WIDTH="10%" BGCOLOR="#000080"> ＜/TD>

＜% } %>

＜% for (int i = 100; i > percent; i -= 10) { %>

＜TD WIDTH="10%"> ＜/TD>

＜% } %>

＜/TR>

＜/TABLE>

 

　任务执行情况分下面几种状态：正在执行，已完成，尚未开始，已停止：

＜TABLE WIDTH="100%" BORDER=0 CELLPADDING=0 CELLSPACING=0>

＜TR>

＜TD ALIGN="CENTER">

＜% if (task.isRunning()) { %>

正在执行

＜% } else { %>

＜% if (task.isCompleted()) { %>

完成

＜% } else if (!task.isStarted()) { %>

尚未开始

＜% } else { %>

已停止

＜% } %>

＜% } %>

＜/TD>

＜/TR>

 

页面底部提供了一个按钮，用户可以用它来停止或重新启动任务：

＜TR>

＜TD ALIGN="CENTER">

＜BR>

＜% if (task.isRunning()) { %>

＜FORM METHOD="GET" ACTION="stop.jsp">

＜INPUT TYPE="SUBMIT" VALUE="停止">

＜/FORM>

＜% } else { %>

＜FORM METHOD="GET" ACTION="start.jsp">

＜INPUT TYPE="SUBMIT" VALUE="开始">

＜/FORM>

＜% } %>

＜/TD>

＜/TR>

＜/TABLE>

＜/BODY>＜/HTML>

 

　只要不停止任务，约10秒后浏览器将显示出计算结果5050：

　　四、停止任务

　　stop.jsp页面把running标记设置成false，从而停止当前的计算任务：

＜jsp:useBean id="task" scope="session"

class="test.barBean.TaskBean"/>

＜% task.setRunning(false); %>

＜jsp:forward page="status.jsp"/>

 

　注意最早的Java版本提供了Thread.stop方法，但JDK从1.2版开始已经不赞成使用Thread.stop方法，所以我们不能直接调用Thread.stop()。

　　第一次运行本文程序的时候，你会看到任务的启动有点延迟；同样地，第一次点击“停止”按钮时也可以看到任务并没有立即停止运行（特别是如果机器配置较低的话，延迟的感觉更加明显），这些延迟都是由于编译JSP页面导致的。编译好JSP页面之后，应答速度就要快多了。

　　五、实际应用

　　进度条不仅使得用户界面更加友好，而且对服务器的性能也有好处，因为进度条会不断地告诉用户当前的执行进度，用户不会再频繁地停止并重新启动（刷新）当前的任务。另一方面，创建单独的线程来执行后台任务也会消耗不少资源，必要时可考虑通过一个线程池来实现Thread对象的重用。另外，频繁地刷新进度页面也增加了网络通信开销，所以务必保持进度页面简洁短小。

　　在实际应用中，后台执行的繁重任务可能不允许停止，或者它不能提供详细的执行进度数据。例如，查找或更新关系数据库时，SQL命令执行期间不允许中途停止——不过如果用户表示他想要停止或中止任务，程序可以在SQL命令执行完毕后回退事务。

　　解析XML文档的时候，我们没有办法获知已解析内容精确的百分比。如果用DOM解析XML文档，直到解析完成后才得到整个文档树；如果用SAX，虽然可以知道当前解析的内容，但通常不能确定还有多少内容需要解析。在这些场合，任务的执行进度只能靠估计得到。

　　估计一个任务需要多少执行时间通常是很困难的，因为它涉及到许多因素，即使用实际测试的办法也无法得到可靠的结论，因为服务器的负载随时都在变化之中。一种简单的办法是测量任务每次执行所需时间，然后根据最后几次执行的平均时间估算。如果要提高估计时间的精确度，应当考虑实现一种针对应用特点的算法，综合考虑多种因素，例如要执行的SQL语句类型、要解析的XML模式的复杂程度，等等。

　　结束语：本文例子显示出用JSP、Java、HTML和JavaScript构造进度条是相当容易的，真正困难的是如何将它用到实际应用之中，特别是获得后台任务的进度信息，但这个问题没有通用的答案，每一种后台执行的任务都有它自己的特点，必须按照具体情况具体分析。