需求是「把目前頁面導出成 PDF」。這件事的標準解法分兩段:前端用 html2canvas 把 DOM 截成圖,後端用 iText 把圖片排進 PDF。前端有 jsPDF 可以直接生成,但它對舊版 IE 支援不佳,所以走「圖片 + 後端組版」這條路相容性最好。
流程是:截圖 → toDataURL 轉成 base64 → 轉成 Blob 塞進 FormData → 用 XHR 上傳。
html2canvas(document.body, {
//截圖對象,此處可配置詳細參數
onrendered: function(canvas) {
canvas.id = "mycanvas";
//產生 base64 圖片數據,指定格式也可不帶參數
var dataUrl = canvas.toDataURL('image/png');
var formData = new FormData(); //模擬表單物件
formData.append("imgData", convertBase64UrlToBlob(dataUrl), "123.png");
var xhr = new XMLHttpRequest();
xhr.open("POST", "../bulletin/exportPdf");
xhr.send(formData);
xhr.onreadystatechange = function(){
if (xhr.readyState == 4) {
if (xhr.status == 200) {
var back = JSON.parse(xhr.responseText);
if (back.success == true) {
alertBox({content: 'Pdf導出成功!', lock: true, drag: false, ok: true});
} else {
alertBox({content: 'Pdf導出失敗!', lock: true, drag: false, ok: true});
}
}
}
};
}
});
//把 base64 的圖片 url 轉為 Blob
function convertBase64UrlToBlob(urlData){
//去掉 url 的頭,並轉為 byte
var bytes = window.atob(urlData.split(',')[1]);
//處理異常:將 ascii 碼小於 0 的轉為大於 0
var ab = new ArrayBuffer(bytes.length);
var ia = new Uint8Array(ab);
for (var i = 0; i < bytes.length; i++) {
ia[i] = bytes.charCodeAt(i);
}
return new Blob([ab], {type: 'image/png'});
}
支援 Firefox 3.5+、Chrome、Opera、IE10+。不支援 iframe 內容、瀏覽器外掛與 Flash。跨域圖片需要在該伺服器的回應標頭加上:
access-control-allow-origin: * access-control-allow-credentials: true
SVG 圖片無法直接支援(社群已有補丁,但穩定性需自行評估)。另外 IE9 不支援 FormData 與 Blob,這種情況下就把 toDataURL 去掉 url 頭之後的字串直接 POST 給後端:
String base64 = img.split(",")[1];
BASE64Decoder decode = new BASE64Decoder();
byte[] imgByte = decode.decodeBuffer(base64);
先引入 iText 的 jar 檔。iText 是 SourceForge 上知名的開源專案,用來產生 PDF 的 Java 類庫,速度快、支援許多進階特性。
@RequestMapping("/exportPdf")
public @ResponseBody void exportPdf(MultipartHttpServletRequest request,
HttpServletResponse response) throws ServletException, IOException {
ResultData result = new ResultData(); //自定義結果格式
String filePath = "c:\\exportPdf2.pdf";
String imagePath = "c:\\exportImg2.bmp";
Document document = new Document();
try {
Map getMap = request.getFileMap();
MultipartFile mfile = (MultipartFile) getMap.get("imgData");
//取得上傳的資料
InputStream file = mfile.getInputStream();
byte[] fileByte = FileCopyUtils.copyToByteArray(file);
//寫成本地圖片檔
FileImageOutputStream imageOutput = new FileImageOutputStream(new File(imagePath));
imageOutput.write(fileByte, 0, fileByte.length);
imageOutput.close();
PdfWriter.getInstance(document, new FileOutputStream(filePath));
// document.setPageSize(PageSize.A2);
document.open();
document.add(new Paragraph("JUST TEST ..."));
Image image = Image.getInstance(imagePath);
float heigth = image.getHeight();
float width = image.getWidth();
//按比例縮小圖片,避免超出頁面
int percent = getPercent2(heigth, width);
image.setAlignment(Image.MIDDLE);
image.scalePercent(percent + 3);
document.add(image);
document.close();
result.setSuccess(true);
operatelogService.addOperateLogInfo(request, "導出成功:成功導出簡報Pdf");
} catch (DocumentException de) {
System.err.println(de.getMessage());
} catch (Exception e) {
e.printStackTrace();
result.setSuccess(false);
result.setErrorMessage(e.toString());
try {
operatelogService.addOperateLogError(request, "導出失敗:服務器異常");
} catch (Exception e1) {
e1.printStackTrace();
}
}
response.getWriter().print(JSONObject.fromObject(result).toString());
}
private static int getPercent2(float h, float w) {
int p = 0;
float p2 = 0.0f;
p2 = 530 / w * 100;
p = Math.round(p2);
return p;
}
iText 有個惱人的特性:出錯時它不會明確拋錯,而是跳過繼續執行,最後得到一個損壞的 PDF,你完全不知道哪一步失敗。除錯時建議分段檢查——先把圖片檔存下來確認截圖正常,再確認 iText 能單獨把這張圖寫成 PDF,最後才接上網路層。
另外幾點實務考量:截長頁面時 html2canvas 的記憶體用量會隨高度急遽上升,必要時應分段截圖並跨頁排版;產生的 PDF 若需要給使用者下載,別忘了改用 response.setContentType("application/pdf") 直接輸出串流,而不是先落地成實體檔案再提供路徑;檔名與暫存位置也要處理好,避免多人同時導出時互相覆蓋。