Warning: error_log(/data/www/wwwroot/hmttv.cn/caches/error_log.php): failed to open stream: Permission denied in /data/www/wwwroot/hmttv.cn/phpcms/libs/functions/global.func.php on line 537 Warning: error_log(/data/www/wwwroot/hmttv.cn/caches/error_log.php): failed to open stream: Permission denied in /data/www/wwwroot/hmttv.cn/phpcms/libs/functions/global.func.php on line 537 老司机成人在线视频,一级黄色毛片播放,亚洲国产高清视频

          整合營銷服務(wù)商

          電腦端+手機(jī)端+微信端=數(shù)據(jù)同步管理

          免費(fèi)咨詢熱線:

          java將html轉(zhuǎn)為pdf


          html轉(zhuǎn)為pdf的組件有很多,但是還沒有哪一款能達(dá)到這個效果,其只要原因是wkhtmltopdf使用webkit網(wǎng)頁渲染引擎開發(fā)的用來將 html轉(zhuǎn)成 pdf的工具,可以跟多種腳本語言進(jìn)行集成來轉(zhuǎn)換文檔。但是就使用簡便性來說還是itext等組件占據(jù)優(yōu)勢,如果你要轉(zhuǎn)換格式有比較高的要求,那么wkhtmltopdf絕對是不二之選!

          下載路徑

          官網(wǎng)地址 wkhtmltopdf.org/

          github地址 github.com/wkhtmltopdf…

          使用方法

          1. windows直接使用:只要在windows命令行中輸入c:\wkhtmltopdf.exe my.oschina.net/papio/blog/… c:\blog.pdf 就可以把這篇文章轉(zhuǎn)成pdf,并保存到C盤根目錄。
          2. java調(diào)用:java中調(diào)用wkhtmltopdf的命令Runtime.getRuntime().exec("c:\wkhtmltopdf.exe my.oschina.net/papio/blog/… c:\blog.pdf")就可以實(shí)現(xiàn)轉(zhuǎn)換。

          java調(diào)用demo

          public class HtmlToPdfInterceptor extends Thread { private InputStream is; public HtmlToPdfInterceptor(InputStream is){ this.is = is; } public void run(){ try{ InputStreamReader isr = new InputStreamReader(is, "utf-8"); BufferedReader br = new BufferedReader(isr); String line = null; while ((line = br.readLine()) != null) { System.out.println(line.toString()); //輸出內(nèi)容 } }catch (IOException e){ e.printStackTrace(); } }}public class HtmlToPdf { //wkhtmltopdf在系統(tǒng)中的路徑 private static final String toPdfTool = "D:\wkhtmltopdf\bin\wkhtmltopdf.exe"; /** * html轉(zhuǎn)pdf * @param srcPath html路徑,可以是硬盤上的路徑,也可以是網(wǎng)絡(luò)路徑 * @param destPath pdf保存路徑 * @return 轉(zhuǎn)換成功返回true */ public static boolean convert(String srcPath, String destPath){ File file = new File(destPath); File parent = file.getParentFile(); //如果pdf保存路徑不存在,則創(chuàng)建路徑 if(!parent.exists()){ parent.mkdirs(); } StringBuilder cmd = new StringBuilder(); cmd.append(toPdfTool); cmd.append(" "); cmd.append(" --header-line");//頁眉下面的線 cmd.append(" --header-center 這里是頁眉這里是頁眉這里是頁眉這里是頁眉 ");//頁眉中間內(nèi)容 //cmd.append(" --margin-top 30mm ");//設(shè)置頁面上邊距 (default 10mm) cmd.append(" --header-spacing 10 ");//(設(shè)置頁眉和內(nèi)容的距離,默認(rèn)0) cmd.append(srcPath); cmd.append(" "); cmd.append(destPath); boolean result = true; try{ Process proc = Runtime.getRuntime().exec(cmd.toString()); HtmlToPdfInterceptor error = new HtmlToPdfInterceptor(proc.getErrorStream()); HtmlToPdfInterceptor output = new HtmlToPdfInterceptor(proc.getInputStream()); error.start(); output.start(); proc.waitFor(); }catch(Exception e){ result = false; e.printStackTrace(); } return result; } public static void main(String[] args) { HtmlToPdf.convert("https://my.oschina.net/papio/blog/835645", "d:/wkhtmltopdf.pdf"); }}復(fù)制代碼

          wkhtmltopdf 參數(shù)詳解

          wkhtmltopdf [OPTIONS]... <input file> [More input files] <output file>常規(guī)選項 --allow <path> 允許加載從指定的文件夾中的文件或文件(可重復(fù)) --book* 設(shè)置一會打印一本書的時候,通常設(shè)置的選項 --collate 打印多份副本時整理 --cookie <name> <value> 設(shè)置一個額外的cookie(可重復(fù)) --cookie-jar <path> 讀取和寫入的Cookie,并在提供的cookie jar文件 --copies <number> 復(fù)印打印成pdf文件數(shù)(默認(rèn)為1) --cover* <url> 使用HTML文件作為封面。它會帶頁眉和頁腳的TOC之前插入 --custom-header <name> <value> 設(shè)置一個附加的HTTP頭(可重復(fù)) --debug-javascript 顯示的javascript調(diào)試輸出 --default-header* 添加一個缺省的頭部,與頁面的左邊的名稱,頁面數(shù)到右邊,例如: --header-left '[webpage]' --header-right '[page]/[toPage]' --header-line --disable-external-links* 禁止生成鏈接到遠(yuǎn)程網(wǎng)頁 --disable-internal-links* 禁止使用本地鏈接 --disable-javascript 禁止讓網(wǎng)頁執(zhí)行JavaScript --disable-pdf-compression* 禁止在PDF對象使用無損壓縮 --disable-smart-shrinking* 禁止使用WebKit的智能戰(zhàn)略收縮,使像素/ DPI比沒有不變 --disallow-local-file-access 禁止允許轉(zhuǎn)換的本地文件讀取其他本地文件,除非explecitily允許用 --allow --dpi <dpi> 顯式更改DPI(這對基于X11的系統(tǒng)沒有任何影響) --enable-plugins 啟用已安裝的插件(如Flash --encoding <encoding> 設(shè)置默認(rèn)的文字編碼 --extended-help 顯示更廣泛的幫助,詳細(xì)介紹了不常見的命令開關(guān) --forms* 打開HTML表單字段轉(zhuǎn)換為PDF表單域 --grayscale PDF格式將在灰階產(chǎn)生 --help Display help --htmldoc 輸出程序HTML幫助 --ignore-load-errors 忽略claimes加載過程中已經(jīng)遇到了一個錯誤頁面 --lowquality 產(chǎn)生低品質(zhì)的PDF/ PS。有用縮小結(jié)果文檔的空間 --manpage 輸出程序手冊頁 --margin-bottom <unitreal> 設(shè)置頁面下邊距 (default 10mm) --margin-left <unitreal> 將左邊頁邊距 (default 10mm) --margin-right <unitreal> 設(shè)置頁面右邊距 (default 10mm) --margin-top <unitreal> 設(shè)置頁面上邊距 (default 10mm) --minimum-font-size <int> 最小字體大小 (default 5) --no-background 不打印背景 --orientation <orientation> 設(shè)置方向?yàn)闄M向或縱向 --page-height <unitreal> 頁面高度 (default unit millimeter) --page-offset* <offset> 設(shè)置起始頁碼 (default 1) --page-size <size> 設(shè)置紙張大小: A4, Letter, etc. --page-width <unitreal> 頁面寬度 (default unit millimeter) --password <password> HTTP驗(yàn)證密碼 --post <name> <value> Add an additional post field (repeatable) --post-file <name> <path> Post an aditional file (repeatable) --print-media-type* 使用的打印介質(zhì)類型,而不是屏幕 --proxy <proxy> 使用代理 --quiet Be less verbose --read-args-from-stdin 讀取標(biāo)準(zhǔn)輸入的命令行參數(shù) --readme 輸出程序自述 --redirect-delay <msec> 等待幾毫秒為JS-重定向(default 200) --replace* <name> <value> 替換名稱,值的頁眉和頁腳(可重復(fù)) --stop-slow-scripts 停止運(yùn)行緩慢的JavaScripts --title <text> 生成的PDF文件的標(biāo)題(第一個文檔的標(biāo)題使用,如果沒有指定) --toc* 插入的內(nèi)容的表中的文件的開頭 --use-xserver* 使用X服務(wù)器(一些插件和其他的東西沒有X11可能無法正常工作) --user-style-sheet <url> 指定用戶的樣式表,加載在每一頁中 --username <username> HTTP認(rèn)證的用戶名 --version 輸出版本信息退出 --zoom <float> 使用這個縮放因子 (default 1) 頁眉和頁腳選項--header-center* <text> (設(shè)置在中心位置的頁眉內(nèi)容) --header-font-name* <name> (default Arial) (設(shè)置頁眉的字體名稱)--header-font-size* <size> (設(shè)置頁眉的字體大小)--header-html* <url> (添加一個HTML頁眉,后面是網(wǎng)址)--header-left* <text> (左對齊的頁眉文本)--header-line* (顯示一條線在頁眉下)--header-right* <text> (右對齊頁眉文本)--header-spacing* <real> (設(shè)置頁眉和內(nèi)容的距離,默認(rèn)0)--footer-center* <text> (設(shè)置在中心位置的頁腳內(nèi)容) --footer-font-name* <name> (設(shè)置頁腳的字體名稱) --footer-font-size* <size> (設(shè)置頁腳的字體大小default 11)--footer-html* <url> (添加一個HTML頁腳,后面是網(wǎng)址)--footer-left* <text> (左對齊的頁腳文本)--footer-line* 顯示一條線在頁腳內(nèi)容上)--footer-right* <text> (右對齊頁腳文本)--footer-spacing* <real> (設(shè)置頁腳和內(nèi)容的距離)./wkhtmltopdf --footer-right '[page]/[topage]' http://www.baidu.com baidu.pdf./wkhtmltopdf --header-center '報表' --header-line --margin-top 2cm --header-line http://192.168.212.139/oma/ oma.pdf表內(nèi)容選項中 --toc-depth* <level> Set the depth of the toc (default 3) --toc-disable-back-links* Do not link from section header to toc --toc-disable-links* Do not link from toc to sections --toc-font-name* <name> Set the font used for the toc (default Arial) --toc-header-font-name* <name> The font of the toc header (if unset use --toc-font-name) --toc-header-font-size* <size> The font size of the toc header (default 15) --toc-header-text* <text> The header text of the toc (default Table Of Contents) --toc-l1-font-size* <size> Set the font size on level 1 of the toc (default 12) --toc-l1-indentation* <num> Set indentation on level 1 of the toc (default 0) --toc-l2-font-size* <size> Set the font size on level 2 of the toc (default 10) --toc-l2-indentation* <num> Set indentation on level 2 of the toc (default 20) --toc-l3-font-size* <size> Set the font size on level 3 of the toc (default 8) --toc-l3-indentation* <num> Set indentation on level 3 of the toc (default 40) --toc-l4-font-size* <size> Set the font size on level 4 of the toc (default 6) --toc-l4-indentation* <num> Set indentation on level 4 of the toc (default 60) --toc-l5-font-size* <size> Set the font size on level 5 of the toc (default 4) --toc-l5-indentation* <num> Set indentation on level 5 of the toc (default 80) --toc-l6-font-size* <size> Set the font size on level 6 of the toc (default 2) --toc-l6-indentation* <num> Set indentation on level 6 of the toc (default 100) --toc-l7-font-size* <size> Set the font size on level 7 of the toc (default 0) --toc-l7-indentation* <num> Set indentation on level 7 of the toc (default 120) --toc-no-dots* Do not use dots, in the toc輪廓選項 --dump-outline <file> 轉(zhuǎn)儲目錄到一個文件 --outline 顯示目錄(文章中h1,h2來定) --outline-depth <level> 設(shè)置目錄的深度(默認(rèn)為4)頁腳和頁眉 * [page] 由當(dāng)前正在打印的頁的數(shù)目代替 * [frompage] 由要打印的第一頁的數(shù)量取代 * [topage] 由最后一頁要打印的數(shù)量取代 * [webpage] 通過正在打印的頁面的URL替換 * [section] 由當(dāng)前節(jié)的名稱替換 * [subsection] 由當(dāng)前小節(jié)的名稱替換 * [date] 由當(dāng)前日期系統(tǒng)的本地格式取代 * [time] 由當(dāng)前時間,系統(tǒng)的本地格式取代
          作者:曹元
          鏈接:https://juejin.im/post/6856547881873047559
          來源:掘金
          著作權(quán)歸作者所有。商業(yè)轉(zhuǎn)載請聯(lián)系作者獲得授權(quán),非商業(yè)轉(zhuǎn)載請注明出處。

          tml2pdf

          pdfbox

          PDFBox是一個Java庫,可用于創(chuàng)建,修改和提取PDF文件的內(nèi)容。它是一個Apache軟件基金會的項目,使用Apache License 2.0許可證。
          PDFBox提供了一組API,可用于提取文本和圖像,添加和刪除頁面,提取PDF元數(shù)據(jù)和加密PDF文件等。

          主要依賴

                  <!-- 將 html 轉(zhuǎn)換為 xml 工具庫 -->
                  <dependency>
                      <groupId>org.jsoup</groupId>
                      <artifactId>jsoup</artifactId>
                      <version>1.17.1</version>
                  </dependency>
          
                  <!-- 第三方 pdfbox 包裝庫,提供 html 轉(zhuǎn) pdf 功能 -->
                  <dependency>
                      <groupId>com.openhtmltopdf</groupId>
                      <artifactId>openhtmltopdf-pdfbox</artifactId>
                      <version>1.0.10</version>
                  </dependency>
          

          測試代碼

                  // 獲取 java 版本
                  String version = System.getProperty("java.specification.version");
          
                  // 獲取系統(tǒng)類型
                  String platform = System.getProperty("os.name", "");
                  platform = platform.toLowerCase().contains("window") ? "win" : "linux";
          
                  // 當(dāng)前程序目錄
                  String current = System.getProperty("user.dir");
          
                  System.out.println(String.format("current=%s", current));
          
                  // html 文件路徑
                  File index = Paths.get(current, "..", "index.html").toFile();
                  if (!index.exists()) {
                      System.out.println(String.format("file not exist,file=%s", index.getAbsolutePath()));
                      return;
                  }
          
                  try {
                      Document doc = Jsoup.parse(index, "UTF-8");
                      // 補(bǔ)全標(biāo)記
                      doc.outputSettings().syntax(Document.OutputSettings.Syntax.xml);
          
                      File file = Paths.get(current, String.format("java%s_%s.pdf", version, platform)).toFile();
                      FileOutputStream stream = new FileOutputStream(file);
          
                      PdfRendererBuilder builder = new PdfRendererBuilder();
          
                      // NOTE 字體問題,文檔中出現(xiàn)過的字段,需要手動加載字體
                      builder.useFont(Paths.get(current, "..", "fonts", "simsun.ttc").toFile(), "SimSun");
                      builder.useFont(Paths.get(current, "..", "fonts", "msyh.ttc").toFile(), "font-test");
                      builder.useFont(Paths.get(current, "..", "fonts", "msyh.ttc").toFile(), "Microsoft YaHei UI");
          
                      // NOTE 設(shè)置根目錄
                      String baseUrl = Paths.get(current, "..").toUri().toString();
                      builder.withHtmlContent(doc.html(), baseUrl);
          
                      builder.toStream(stream);
                      builder.run();
                  } catch (IOException e) {
                      throw new RuntimeException(e);
                  }

          效果預(yù)覽

          pdfbox-demo/java1.8_win.pdf · yjihrp/linux-html2pdf-demo - Gitee.com

          pdfbox-demo/java11_linux.pdf · yjihrp/linux-html2pdf-demo - Gitee.com

          實(shí)用工具

          # 查看 pdf 內(nèi)部結(jié)構(gòu)
          java -jar pdfbox-app debug path-to-pdf/test.pdf
          java -jar debugger-app path-to-pdf/test.pdf

          測試結(jié)果

          測試結(jié)果

          下一篇 5-LINUX HTML 轉(zhuǎn) PDF-selenium




          目前,教學(xué)、教研各種內(nèi)容線上沉淀、展示豐富多彩,但線上內(nèi)容“線下化”能力不足或過分依賴人力,比如,線上練習(xí)題組卷后以PDF形式分發(fā)給學(xué)生,家長希望將考試、練習(xí)題目打印后,學(xué)生帶到學(xué)校去做(高中生使用手機(jī)等電子設(shè)備的時間有限),線上各類分析報告以PDF形式分享給學(xué)生/家長等。


          從業(yè)務(wù)方面看,不同業(yè)務(wù)線的多個業(yè)務(wù)場景都有輸出PDF的訴求,如果各業(yè)務(wù)線自己設(shè)計、實(shí)現(xiàn)符合自身業(yè)務(wù)場景的具體方案,除調(diào)研、開發(fā)工作量較大之外,還會有重復(fù)調(diào)研,踩坑的情況。


          從技術(shù)角度看,線上內(nèi)容轉(zhuǎn)PDF的內(nèi)容源頭來自于H5富文本內(nèi)容,業(yè)界內(nèi)以此為基礎(chǔ)的PDF生成方案多種多樣,也各有優(yōu)劣,比如:


          方案對比-表格-1


          因此,我們綜合了各種PDF生成方案并總結(jié)了在探索講義生成PDF過程中的經(jīng)驗(yàn),抽象出了一套通用的,可復(fù)用的能力供各業(yè)務(wù)線快速利用,基本方案和優(yōu)劣如下:


          最終方案-表格-2


          目 標(biāo)




          旨在提供一套以H5為載體的PDF通用生成方案,這套方案有如下特點(diǎn):

          1. 通用性強(qiáng):能夠處理各類H5頁面,從分頁到生成,做到一套方案,多般兼容。
          2. 擴(kuò)展性、配置性強(qiáng):各場景可根據(jù)自己的需要自定義頁眉、頁腳、頁碼,水印,背景等配置,做到輸出形式豐富多彩。
          3. 方便易接入:各業(yè)務(wù)場景只需關(guān)注要展現(xiàn)的內(nèi)容,無需關(guān)注分頁,PDF生成等背后的處理 ,為需要產(chǎn)出PDF的業(yè)務(wù)場景提效賦能;整體來看,調(diào)研、設(shè)計、開發(fā)(+踩坑)一整套 H5 轉(zhuǎn) PDF的能力至少需要近 30人/日,我們希望這套通用能力的接入成本控制在 7人/日左右;在很多場景接入后,從實(shí)際反饋來看,平均只需要 2-3 人/日就接入了。
          4. 質(zhì)量高:保證輸出PDF中內(nèi)容的展示與H5中無異,各種復(fù)雜公式的展示也絲毫無差錯。
          5. 性能好:保證 1 分鐘內(nèi)能處理 100+ 的 20頁左右的PDF生成任務(wù)
          6. 穩(wěn)定性高:保證有各種兜底策略妥善處理各類異常,同時能夠通過限流方案應(yīng)對突發(fā)流量,保證服務(wù)穩(wěn)定。


          這套方案可分為兩個核心部分,頁面展示側(cè) - Medusa,PDF生成側(cè) - Hydra


          頁面展示側(cè) - Medusa




          我們頁面展示側(cè)的通用能力——Medusa,是基于Paged.js的二次封裝,并以NPM包形式提供給業(yè)務(wù)方使用。Medusa可對任何HTML進(jìn)行分頁、并根據(jù)配置添加頁眉、頁腳等,最終將處理后的HTML渲染到頁面中。Medusa封裝并簡化了對PDF格式的配置,可覆蓋絕大多數(shù)業(yè)務(wù)場景,使得各業(yè)務(wù)場景將更多精力投入其自身業(yè)務(wù)邏輯的開發(fā)。


          之所以選擇Pagedjs為基礎(chǔ)開發(fā)我們自己的SDK,是因?yàn)樗悄壳拔覀兡苷业降奈ㄒ?/span>開源的、具有HTML內(nèi)容分頁,樣式處理的前端庫,同時我們也在講義中經(jīng)過了長期的摸索與沉淀。


          接下來將詳細(xì)介紹Paged.js原理、Medusa支持的功能與使用方法。


          一 Paged.js是如何工作的




          Paged.js包含了 3 個大模塊

          • Chunker(負(fù)責(zé)HTML內(nèi)容分頁)
          • Polisher (負(fù)責(zé)CSS樣式處理)
          • Previewer (負(fù)責(zé)預(yù)覽呈現(xiàn)Chunker和Polisher處理后的內(nèi)容)

          這里將主要介紹 Previewer 和 Chunker,因?yàn)槲覀兊亩伍_發(fā)和維護(hù)不涉及到Polisher。


          Previewer

          Previewer 的工作非常簡單,但我們會主要利用它封裝我們的Medusa,初始化一個Previewer對象,Previewer初始化了Chunker和Polisher對象:


          Medusa-代碼-1


          再調(diào)用Previewer的preview()方法,preview()方法做了兩件事:

          1. 通過Polisher處理樣式內(nèi)容
          2. 通過Chunker處理需要分頁的HTML內(nèi)容,如果沒有指定需要分頁的HTML,則會處理整個Body的內(nèi)容

          Medusa-代碼-2


          當(dāng)chunker.flow結(jié)束,即可在瀏覽器看到整個頁面處理完之后的樣子。


          Chunker


          首先,Chunker解析、預(yù)處理需要分頁的HTML,為其添加一些必要的屬性


          Medusa-代碼-3


          然后創(chuàng)建容納所有頁(pages)的容器,并掛載到renderTo容器下(默認(rèn)Body),以備組織后續(xù)的所有頁:



          Medusa-代碼-4


          接著,chunker創(chuàng)建了一個page模版,以便增加頁面使用:


          Medusa-代碼-5


          其中,TEMPLATE是Pagedjs內(nèi)部創(chuàng)建頁面時所使用的基礎(chǔ)模版。


          Medusa-代碼-6


          接下來,chunker進(jìn)入了渲染+分頁過程(這個過程我們不會在二次開發(fā)中做修改,但需要了解其基本思路以便在出問題時能有解決思路),這個過程在循環(huán)一個迭代器(*layout),迭代器一直在做3件事:


          1. 將內(nèi)容添加到模版內(nèi)容區(qū)域的容器中 -> 渲染。
          2. 探測overflow,找到overflow的offset并創(chuàng)建BreakToken (探測overflow過程中很多處都用到了迭代器,此處為了說明思路,簡化了相關(guān)代碼)。


          原則:

          尋找overflow時會將盡可能多的內(nèi)容節(jié)點(diǎn)插入內(nèi)容區(qū)域,這里,“盡可能多”分為幾種情況,比如:

          • 沒有剩余節(jié)點(diǎn)需要再添加了
          • 達(dá)到了一頁所能承載的最大字符數(shù);剛開始的時候,如果沒有指定每頁的最大字符數(shù),Pagedjs會給一個默認(rèn)值為 1500 的每頁最大字符用做判斷,在之后會記錄分隔好的每一頁中的字符數(shù),并取最近4頁 (少于4頁取全部)的平均值作為之后分頁的判斷條件,這里,Pagedjs相當(dāng)于對每一頁中能夠承載的內(nèi)容做了一個簡單的預(yù)測,這個算法對于比較規(guī)律的內(nèi)容做分頁時還是比較簡單高效的。

          步驟:

          Pagedjs遵循了如下步驟去尋找overflow:

          兩個前置條件:

          • 內(nèi)容區(qū)域盒子邊界已經(jīng)確定,下面以contentArea.right 和 contentArea.bottom 分別代指其右邊界和下邊界。
          • 處理過程中每個節(jié)點(diǎn)的邊界可以計算(對于文字節(jié)點(diǎn),Pagedjs中使用了Range對象為其創(chuàng)建邊界),下面以 node.left、 node.right、node.top 和 node.bottom 分別代指節(jié)點(diǎn)的左、右、上、下邊界。

          i. 從需要處理的內(nèi)容第一個節(jié)點(diǎn)開始,判斷是否 node.left >= contentArea.right || node.top >= contentArea.bottom


          Medusa-代碼-7


          ii.如果不滿足,則判斷 node.right <= contentArea.right && node.bottom <= contentArea.bottom


          Medusa-代碼-8


          iii.如果不滿足,那說明有子節(jié)點(diǎn)overflow了,則繼續(xù)深入其子節(jié)點(diǎn)查找即可。


          3.使用模版添加新的頁面,并從BreakToken處繼續(xù)上述動作。


          二 Medusa支持的功能及使用方法




          基于Paged.js,Medusa支持了如下功能,并為業(yè)務(wù)方提供了更加簡潔、定制化的配置。


          1. 動態(tài)頁面分頁能力
          2. 單頁模版配置 -> 生成能力
          3. 前、后置靜態(tài)頁面生成、與分頁后的動態(tài)頁面拼接能力
          4. 頁面處理成功后,通知PDF生成服務(wù)(Hydra)執(zhí)行任務(wù)


          下方是調(diào)用Medusa的代碼示例:


          Medusa-代碼-9


          1.1 動態(tài)頁面分頁能力

          Medusa核心功能,可將連續(xù)的HTML頁面轉(zhuǎn)化成一頁頁P(yáng)DF樣式的HTML。


          1.2 單頁模版配置 -> 生成能力


          通過Grid布局,Paged.js將一個單頁模版分為多個區(qū)域,整體分為2個大的部分:

          1. base 頁面基礎(chǔ)配置:每個PDF紙型、水印,內(nèi)容區(qū)域的寬高、margin與padding等等
          2. surround 頁面周圍區(qū)域:如頁眉、頁腳等配置


          業(yè)務(wù)方通過簡單的配置,即可還原UI設(shè)計稿中的PDF樣式,例子如下圖:



          1.2.1 base

          頁面基礎(chǔ)配置是對每頁的。支持紙型或頁面寬高、內(nèi)容區(qū)域margin、padding、背景及水印的設(shè)置。



          在封裝Medusa時,Medusa將讀取傳入的頁面模版配置、靜態(tài)頁內(nèi)容配置,并將樣式上的配置解析并轉(zhuǎn)化為Previewer可理解的樣式內(nèi)容,比如頁面寬高的設(shè)置:


          Medusa-代碼-10


          將被轉(zhuǎn)化為:


          Medusa-代碼-11


          1.2.2 surround


          1. 可以看到圖中的16種不同位置的surround區(qū)域。通過設(shè)置position,可將業(yè)務(wù)方自定義的元素渲染到對應(yīng)的位置上。



          2. 目前支持3種類型的surround item:

          • text 文字
          • img 圖片
          • pageNum (動態(tài)獲取)當(dāng)前頁碼


          example:


          Medusa-代碼-12


          1.3 前/后置靜態(tài)頁面


          業(yè)務(wù)方可通過如下方式配置靜態(tài)頁面的具體內(nèi)容:


          Medusa-代碼-13


          其中,傳入的React JSX Element將會被這樣處理:


          Medusa-代碼-14


          處理完成后,將HTML String拼接到頁面模版中,再插入分頁后內(nèi)容的前后。


          PDF生成側(cè) - Hydra:




          頁面展示側(cè)為PDF生成做好了頁面的準(zhǔn)備,對于PDF生成側(cè),需要做的工作就更純粹了,業(yè)務(wù)方除了請求生成PDF,定期檢查PDF生成的進(jìn)度,無需做任何額外工作。


          1.整體流程:

          PDF生成是CPU和內(nèi)存密集型的,由于頁面內(nèi)容的不確定性,也意味著頁面渲染時間與生成PDF的時間都是不確定的,因此整體PDF生成的鏈路被設(shè)計成是異步的,如下圖:



          整體流程上,業(yè)務(wù)方在請求生成PDF時,會先在后端做一條記錄,后端再將任務(wù)發(fā)送給Node服務(wù),即Hydra;


          在生成PDF時, 第 1 步是做頁面上的準(zhǔn)備,一個生成任務(wù)可能有多個URL頁面需要生成PDF,所以我們預(yù)先啟動對應(yīng)URL數(shù)量的PPTR Page,頁面都啟動完成后,進(jìn)入下一步;


          第 2 步:渲染頁面,這個過程中,如果請求是包含多個URL的,這些頁面會同步渲染,在所有頁面渲染完成后,進(jìn)入下一步。


          第 2.5 步,如果是需要生成連續(xù)頁碼的一整個PDF,還會做額外的一個動作:頁碼矯正,通過頁碼矯正,可以將同步渲染的每個頁面,按照其之前頁面的頁碼數(shù)修正,以保證整體PDF的頁碼的連貫。


          第 3 步,通過PPTR Page的能力將頁面轉(zhuǎn)換為PDF buffer,如有必要,再將生成的PDF buffer拼接到一起生成一整個PDF,或者將每個PDF buffer都生成一個PDF,壓縮成zip文件。


          第 4 步,文件上傳OSS,最終返回OSS CDN鏈接。


          2.請求生成PDF:


          業(yè)務(wù)側(cè)請求將對應(yīng)頁面生成PDF的時,只需傳入如下字段:


          Hydra-代碼-1


          3.PDF生成過程:


          正如在整體流程中所述,PDF生成側(cè),我們借助 PPTR 的能力打開頁面并生成PDF流。


          在頁面調(diào)用 Medusa 分頁、組裝能力時,所有內(nèi)容分頁組裝完成后會向body中插入了一個額外的DOM以標(biāo)識該頁面處理完成:


          Hydra-代碼-2


          這是為了 Hydra 感知頁面渲染完成所做的準(zhǔn)備,當(dāng)生成服務(wù)的 PPTR 等到該DOM出現(xiàn)時,則表示頁面成功渲染并處理完成了:


          Hydra-代碼-3


          此后,在上面已經(jīng)提到過,對于需要將多個頁面生成的PDF拼接成一個PDF的情況,在生成PDF之前需要做一個重要的動作,即頁碼矯正,原因如下:


          1. 每個頁面無法感知其他頁面情況的,如:第二個頁面不知道第一個頁面會生成多少頁的PDF。
          2. 它們的頁碼需要是連續(xù)的。


          并且我們不希望頁面的處理是串行的,因?yàn)榇袆荼貙?dǎo)致速度較慢,生成時間長。


          這個問題的解決方案如下:

          1. 對于每個頁面都啟用一個page,并同時處理

          2. 每個頁面處理完成后(pdfLastDOM出現(xiàn)),通過Page.$eval()來統(tǒng)計頁數(shù)并記錄:

          Hydra-代碼-4


          3. 計算出頁面中分頁之后每一個頁面的起始頁碼,以及所有頁面的頁碼總和

          4. 再修改頁碼容器樣式的 counterReset 值即可,其后續(xù)頁碼可自遞增。


          Hydra-代碼-5


          5. 之后,再通過 Medusa 在頁面window對象中Polyfill的相關(guān)配置,比如需要生成的PDF的單頁寬、高以生成PDF流。


          Hydra-代碼-6


          6. 最后如有必要,通過pdf-lib拼接這些 pdfBuffer 即可。


          Hydra-代碼-7


          7. PDF生成完成后,上傳OSS并返回URL鏈接


          4.性能、穩(wěn)定性保證:


          在整體方案落地前,我們對服務(wù)進(jìn)行了多次性能測試:


          以下載題目為例,在4個容器,每個容器 3C 12G 的配置下的并行處理能力如下:


          對于 20 道題目,每個PDF生成任務(wù)在 15 頁左右,平均 1 分鐘內(nèi)能完成 280 個任務(wù)的處理。

          對于 40 道題目,每個PDF生成任務(wù)在 30 頁左右,平均 1 分鐘內(nèi)能完成 105 個任務(wù)的處理。

          對于 60 到題目,每個PDF生成任務(wù)在 40 頁左右,平均 1 分鐘內(nèi)能完成 54 個任務(wù)的處理。


          同時,根據(jù) Hydra 服務(wù)的整體的處理能力,后端通過任務(wù)隊列的形式幫助我們保證服務(wù)不被瞬間的突刺流量擊垮。


          已接入/正在接入的相關(guān)業(yè)務(wù)線及場景:




          目前,公司有 5 大業(yè)務(wù)線,8 個場景已經(jīng)完全接入我們的能力用于 H5 轉(zhuǎn) PDF,如下是錯題本、內(nèi)容資料庫接入后生成的PDF樣例:


          錯題本:




          內(nèi)容資料庫試卷:




          未來展望




          目前整體的PDF生成方案已經(jīng)能夠滿足大多數(shù)場景和內(nèi)容,但依然有可改進(jìn)空間。


          HTML的流式布局要求我們必須手動的對內(nèi)容分頁,才能添加頁眉,頁腳等(即Mdusa做的工作),正因?yàn)槿绱?,在處理?fù)雜的內(nèi)容時,可能會出現(xiàn)一些問題:比如,遇到復(fù)雜表格時,由于表格可能會有多種多樣的行、列合并,同時表格單元格內(nèi)的內(nèi)容也可以多種多樣,在分頁過程中,Medusa內(nèi)部的PagedJS并不能完美的處理對于長、且復(fù)雜的表格的分割,因此可能遇到分割后表格單元格缺失、錯亂或?qū)捀咤e誤的問題,這些問題在講義中體現(xiàn)較明顯。


          我們?nèi)栽诔掷m(xù)關(guān)注與研究復(fù)雜DOM內(nèi)容的分割問題,會嘗試加以優(yōu)化和改進(jìn)PagedJS的能力,同時,我們也以另外一種思路設(shè)計了自己的DOM分頁器方案,但經(jīng)過評估,由于實(shí)現(xiàn)比較復(fù)雜,成本較高,暫時沒有投入開發(fā)資源。


          不過,我們相信,未來我們一定能以更完美的方式分割DOM以生成更高質(zhì)量的PDF。


          作者:高源、陳欣博

          來源:微信公眾號:高途技術(shù)

          出處:https://mp.weixin.qq.com/s/c_N7jdNklrNFKR_Cub2Tgg


          主站蜘蛛池模板: 久久久久女教师免费一区| 麻豆aⅴ精品无码一区二区| 在线精品亚洲一区二区三区| 亚洲bt加勒比一区二区| 日韩三级一区二区三区| 国产一区麻豆剧传媒果冻精品| 交换国产精品视频一区| 亚洲av一综合av一区| 日本一区午夜艳熟免费| 白丝爆浆18禁一区二区三区 | 视频一区二区三区在线观看| 国产福利一区二区三区在线观看 | 亚洲丶国产丶欧美一区二区三区| 在线视频一区二区三区三区不卡 | 国产综合精品一区二区三区| 精品乱人伦一区二区| 日本人的色道www免费一区 | 国产AV午夜精品一区二区三区| 国产精品视频一区二区三区不卡| 国产伦精品一区二区| 日本一区二区三区久久| 国产精品视频无圣光一区| 国产一区二区三区美女| 动漫精品第一区二区三区| 日韩一区二区三区在线精品| 免费一区二区无码视频在线播放| 精品一区中文字幕| 一区二区高清视频在线观看| 久久精品国产第一区二区| 国产熟女一区二区三区四区五区| 亚洲国模精品一区| 日韩精品无码一区二区三区AV| 台湾无码一区二区| AA区一区二区三无码精片| 国模视频一区二区| 亚洲国产精品一区二区第一页免| 亚洲一区AV无码少妇电影☆| 色欲AV蜜臀一区二区三区 | 果冻传媒一区二区天美传媒| 国产亚洲一区区二区在线| 亚洲色精品aⅴ一区区三区|