安裝程式、下載任務裡的進度條大家都不陌生,它用來傳達「還剩多少」。本文用一個可運行的例子,示範如何以 Ajax 反覆向後端詢問百分比,再把結果畫成格子狀的進度條。
後端只做一件事:依請求參數回傳目前的百分比數字,並用 XML 包起來。
<%@ page contentType="text/html; charset=gb2312" language="java" import="java.sql.*" errorPage="" %>
<%!
int counter = 1; // 注意:多使用者會共用此變數,本例僅適用單一使用者
%>
<%
String task = request.getParameter("task");
String res = "";
if (task.equals("create")) {
res = "1";
counter = 1;
} else {
String percent = "";
switch (counter) {
case 1: percent = "10"; break;
case 2: percent = "23"; break;
case 3: percent = "35"; break;
case 4: percent = "51"; break;
case 5: percent = "64"; break;
case 6: percent = "73"; break;
case 7: percent = "89"; break;
case 8: percent = "100"; break;
}
counter++;
res = "<percent>" + percent + "</percent>";
}
response.setContentType("text/xml");
response.setHeader("Cache-Control", "no-cache");
out.println("<response>");
out.println(res);
out.println("</response>");
out.close();
%>
存檔為 ProgressBar.jsp。counter 是回傳百分比的依據;task=create 代表重新開始並重置 counter,其他值則依 counter 查表回傳並累加。實務上這個計數器應該放在 session 或資料庫,本例為求簡潔放在 page 層級。
<html>
<head>
<title>JSP + Ajax 進度條</title>
<script type="text/javascript">
var xmlHttp;
var bar_color = 'blue';
var clear = " ";
function createXMLHttpRequest() {
if (window.ActiveXObject) {
xmlHttp = new ActiveXObject("Microsoft.XMLHTTP");
} else if (window.XMLHttpRequest) {
xmlHttp = new XMLHttpRequest();
}
}
// 起點:通知後端並啟動進度條
function go() {
createXMLHttpRequest();
checkDiv();
var url = "ProgressBarJsp.jsp?task=create";
xmlHttp.open("GET", url, true);
xmlHttp.onreadystatechange = goCallback;
xmlHttp.send(null);
}
// 只執行一次,之後改由 pollServer 接手
function goCallback() {
if (xmlHttp.readyState == 4 && xmlHttp.status == 200) {
setTimeout("pollServer()", 2000);
}
}
function pollServer() {
createXMLHttpRequest();
var url = "ProgressBarJsp.jsp?task=poll";
xmlHttp.open("GET", url, true);
xmlHttp.onreadystatechange = pollCallback;
xmlHttp.send(null);
}
// 會被呼叫多次,依回傳數字更新畫面
function pollCallback() {
if (xmlHttp.readyState == 4 && xmlHttp.status == 200) {
var percent_complete = xmlHttp.responseXML.getElementsByTagName("percent")[0].firstChild.data;
var index = processResult(percent_complete);
for (var i = 1; i <= index; i++) {
var elem = document.getElementById("block" + i);
elem.innerHTML = clear;
elem.style.backgroundColor = bar_color;
var next_cell = i + 1;
if (next_cell > index && next_cell <= 9) {
document.getElementById("block" + next_cell).innerHTML = percent_complete + "%";
}
}
if (index < 9) {
setTimeout("pollServer()", 2000);
} else {
document.getElementById("complete").innerHTML = "網站已完成加載!";
}
}
}
// 把百分比換算成要點亮的格子數
function processResult(percent_complete) {
var ind;
if (percent_complete.length == 1) {
ind = 1;
} else if (percent_complete.length == 2) {
ind = percent_complete.substring(0, 1);
} else {
ind = 9;
}
return ind;
}
function checkDiv() {
var progress_bar = document.getElementById("progressBar");
if (progress_bar.style.visibility == "visible") {
clearBar();
document.getElementById("complete").innerHTML = "";
} else {
progress_bar.style.visibility = "visible";
}
}
function clearBar() {
for (var i = 1; i < 10; i++) {
var elem = document.getElementById("block" + i);
elem.innerHTML = clear;
elem.style.backgroundColor = "white";
}
}
</script>
</head>
<body onload="go();">
<h1 align=center>網站正在加載中,請稍候</h1>
<p>
<table align="center">
<tbody>
<tr><td>
<div id="progressBar" style="padding:2px;border:solid yellow 2px;visibility:hidden">
<span id="block1"></span><span id="block2"></span><span id="block3"></span>
<span id="block4"></span><span id="block5"></span><span id="block6"></span>
<span id="block7"></span><span id="block8"></span><span id="block9"></span>
</div>
</td></tr>
<tr><td align="center" id="complete"></td></tr>
</tbody>
</table>
</body>
</html>
存檔為 JspprogressBar.html。各函式職責如下:createXMLHttpRequest() 建立跨瀏覽器的 XHR 物件;go() 在頁面載入時發出第一次請求,通知後端開始並顯示進度條;goCallback() 只跑一次,負責排程第一次輪詢;pollServer() 每兩秒問一次百分比;pollCallback() 依回傳值決定點亮到第幾格;processResult() 負責百分比到格數的換算;checkDiv() 與 clearBar() 則處理顯示與重置。
把兩個檔案放進 JSP 目錄即可運行:

這份範例寫於 XHR 需要手動判斷 ActiveX 的年代,今天可以直接用 fetch 取代 createXMLHttpRequest,並改用 response.json() 免去手動解析 XML。另外,進度資訊更適合以 SSE 或 WebSocket 推送,輪詢在長任務下會產生不少無謂請求。