DIV CSS 佈局教程網

用 XMLHttpRequest 請求並處理二進制流(圖片/檔案)
編輯:JavaScript基礎知識     

寫在前面:從提出需求到完美解決問題,整個實現過程可謂一波三折。

需求:在「前端(web client)與後端(Restful Service)完全解耦」的框架下,webclient 需要請求 Service 返回的圖片檔案(二進制流),並在 client 端顯示出來。

第一步思考:基於工程師的自信,心想不就是顯示個圖片嘛,用 jQuery ajax 直接 GET 請求,把返回的 data 賦值給 img 標籤的 src 屬性不就搞定了?so easy~

於是小伙子埋頭碼了幾分鐘,寫出下面的程式碼,自信滿滿準備測試。

 //$.ajax({ // method: "GET", // url: serverUrlBase + "/server/images/" + mapid + "/files/png",//跨域,請求會返回流文件 png圖片 // beforeSend: function (xhr) { // xhr.setRequestHeader("client_type", "DESKTOP_WEB"); // xhr.setRequestHeader("desktop_web_access_key", _desktop_web_access_key); // }, // success: function (data) { // //$("#remoteimg").attr("url", data); // } //});

結果在瀏覽器中打開一看——這是什麼鬼?!完全不符合期望。

第二步思考:一定是後端那傢伙給的 API 有問題,先用工具測測看。

打開 Chrome 裡裝好的 Postman,輸入請求地址,點擊 SEND。等兩秒鐘,一張超大的圖片顯示出來了~看來後端沒問題。

第三步思考:後端接口正常,問題出在自己身上。把請求到的數據 console.log(data) 一下。卡頓幾分鐘後,數據終於印了出來。

第四步思考:怎麼會是這樣的數據?Postman 返回的是圖片,我的卻是亂碼?對了,看看 Postman 返回的到底是什麼數據。

在 Postman 中選中圖片 → 右鍵 → 檢查:

第五步思考:為什麼我的數據與 Postman 不同、是亂碼?難道 ajax 返回的數據被改了編碼?難道不支援二進制流?一邊想,一邊打開 jQuery 官網查 ajax 的 datatype 數據類型。

發現竟然沒有二進制數據選項,那是不是返回的數據被預設當成文字處理了。看來 jQuery 的 ajax 仍停留在 XMLHttpRequest 1 的思維,並不支援流檔案。既然別人靠不住,只能自己動手。依稀記得 XMLHttpRequest 2 標準支援流檔案,並且應該用 xhr.response 而非 responseText 來接收。於是開始動手:

 var url = serverUrlBase + "/server/images/" + mapid + "/files/png";'
var xhr = new XMLHttpRequest(); xhr.open('GET', url, true);//get請求,請求地址,是否異步
xhr.setRequestHeader("client_type", "DESKTOP_WEB"); xhr.setRequestHeader("desktop_web_access_key", _desktop_web_access_key);
xhr.onload = function() { if (this.status == 200) { var data = this.response;
//TODO...............................................如何接收數據呢。
} } xhr.send();

第六步思考:這樣應該可行,但拿到數據後該怎麼處理呢?對了,HTML5 新特性裡不是提到一個 Blob 物件嗎?試試看。

查閱 Blob 相關資料後得知,返回類型應設定為 blob:

在請求成功的地方加上:var blob = this.response;。既然二進制數據拿到了,就要把它放進 img 標籤裡顯示:

var img = document.createElement("img");

img.src = window.URL.createObjectURL(blob);

img.onload = function(e) { window.URL.revokeObjectURL(img.src); }; //載入後釋放 blob 佔用的資源

再把 img 放進一個 div 容器即可:$("#imgcontainer").html(img);

最終的完整程式碼如下:

 var url = serverUrlBase + "/server/images/" + mapid + "/files/png"; var xhr = new XMLHttpRequest(); xhr.open('GET', url, true); xhr.responseType = "blob"; xhr.setRequestHeader("client_type", "DESKTOP_WEB"); xhr.setRequestHeader("desktop_web_access_key", _desktop_web_access_key); xhr.onload = function() { if (this.status == 200) { var blob = this.response; var img = document.createElement("img"); img.onload = function(e) { window.URL.revokeObjectURL(img.src); }; img.src = window.URL.createObjectURL(blob); $("#imgcontainer").html(img); } } xhr.send();

結語:如此便解決了載入二進制流的問題。結合上一篇提到的 AJAX 跨域請求,距離「前後端完全分離」的理念又更近了一步(當然,安全層面仍有許多要考量的地方)。這整個過程也讓我體會到:高階的封裝(如 ajax)固然好用,但面對一些特殊請求(如流檔案)卻無能為力,因此唯有掌握底層原理,才能應對苛刻的需求。

參考資料:

https://api.jquery.com/jQuery.ajax/ jquery ajax api

https://xhr.spec.whatwg.org/ xmlhttprequest 規範

https://xhr.spec.whatwg.org/#the-responsetype-attribute responsetype 返回類型支援

https://www.zhangxinxu.com/wordpress/2013/10/understand-domstring-document-formdata-blob-file-arraybuffer/ xmlhttprequest 相關學習

https://www.ruanyifeng.com/blog/2012/09/xmlhttprequest_level_2.html xmlhttprequest 使用指南

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved