前陣子在論壇看到一個討論:後端用 Response.BinaryWrite() 把一張圖片的二進位內容直接寫進輸出流,前端想用 Ajax 把它取回來顯示,卻不知從何下手。樓中回覆五顏六色,可惜多半沒命中要害。真正的需求其實很單純:資料還在傳輸時,先讓使用者看到「圖片載入中…」的提示;一旦接收完成,立刻把圖片換上去。
如果圖片是存在資料庫裡的二進位欄位,最直覺的做法根本用不到 Ajax:後端讀資料、輸出圖片,前端一行 <img src="getimage.aspx?id=xxxx" /> 就搞定了。既然直接呼叫這麼省事,又何必繞遠路?更何況用 JavaScript 硬啃二進位圖形資料,不但麻煩,也不是個好方法。
所以問題只剩下兩個:怎麼知道資料收完了?收完之後又怎麼交給瀏覽器?
答案其實很樸素——利用快取(Cache)。同一個 URL 的請求會先命中外掛的快取,而當 XMLHttpRequest 回報 readyState == 4 且 status == 200 時,代表資料已經完整下載並落地。這時候只要把同一個 URL 設給 <img> 的 src,瀏覽器就會直接從快取取用,圖片瞬間顯示,不必再走一次後端。
這裡最容易踩的坑是:img.src 用的 URL 必須和 xhr.open() 裡的完全一致,一個參數不同就會重新發一次請求,快取也就白搭了。
function loadImage(elementId, id) {
// elementId:<img> 標籤的 id;id:要請求的圖片識別碼
var url = "getimage.aspx?ID=" + id + "&stamp=" + new Date().getTime();
var xhr = getXhrObject();
if (!xhr) { return; }
xhr.onreadystatechange = function () {
if (xhr.readyState == 4) {
if (xhr.status == 200) {
// 資料已完整進入快取,把同一個 URL 交給 img 即可
document.getElementById(elementId).src = url;
} else {
document.getElementById(elementId).src = "images/failed.gif";
}
}
};
xhr.open("GET", url, true);
xhr.send(null);
}
function getXhrObject() {
if (window.XMLHttpRequest) { return new XMLHttpRequest(); }
if (window.ActiveXObject) { return new ActiveXObject("Microsoft.XMLHTTP"); }
return null;
}
網址後面那串 new Date().getTime() 時間戳有兩個作用:一是讓每次請求的 URL 都不同,避開快取直接拿到新圖;二是當你希望「強制重抓」時,只要換掉時間戳,瀏覽器就會重新向後端索取。
既然主打「載入中」的體驗,不妨在送出請求前先把 <img> 的 src 換成一張 loading 動圖,或替容器加上半透明遮罩;成功後再切換成真正的圖片,失敗則顯示一張提示圖。這樣即使網路慢,使用者也知道系統正在忙,而不是畫面一片空白或以為壞了。
整套做法的核心只有一句話:Ajax 負責「等」,快取負責「給」,<img> 負責「顯示」。理解這層分工,二進位圖片的非同步載入就不再神祕。