java根據模板動態生成PDF

阿新 • • 發佈：2021-06-12

一、需求說明：根據業務需要，需要在伺服器端生成可動態配置的PDF文件，方便資料視覺化檢視。

二、解決方案：
iText+FreeMarker+JFreeChart生成可動態配置的PDF文件
iText有很強大的PDF處理能力，但是樣式和排版不好控制，直接寫PDF文件，資料的動態渲染很麻煩。
FreeMarker能配置動態的html模板，正好解決了樣式、動態渲染和排版問題。
JFreeChart有這方便的畫圖API，能畫出簡單的折線、柱狀和餅圖，基本能滿足需要。

三、實現功能：

   1、能動態配置PDF文件內容
   2、支援中文字型顯示的動態配置
   3、設定自定義的頁首頁尾資訊
   4、能動態生成業務圖片
   5、完成PDF的分頁和圖片的嵌入

四、主要程式碼結構說明：

   1、component包：PDF生成的元件 對外提供的是PDFKit工具類和HeaderFooterBuilder介面，其中PDFKit負責PDF的生成，HeaderFooterBuilder負責自定義頁首頁尾資訊。
   2、builder包：負責PDF模板之外的額外資訊填寫，這裡主要是頁首頁尾的定製。
   3、chart包：JFreeChart的畫圖工具包，目前只有一個線形圖。
   4、test包：測試工具類
   5、util包：FreeMarker等工具類。

五、關鍵程式碼說明：

1、模板配置

 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
    <meta http-equiv="Content-Style-Type" content="text/css"/>
    <title></title>
    <style type="text/css">
        body {
            font 
-family: pingfang sc light;
        }
        .center{
            text-align: center;
            width: 100%;
        }
    </style>
</head>
<body>
<!--第一頁開始-->
<div class="page" >
    <div class="center"><p>${templateName}</p></div>
    <div><p>iText官網:${ITEXTUrl}</p></div>
    <div><p>FreeMarker官網:${freeMarkerUrl}</p></div>
    <div><p>JFreeChart教程:${JFreeChartUrl}</p></div>
    <div>列表值:</div>
    <div>
        <#list scores as item>
            <div><p>${item}</p></div>
        </#list>
    </div>
</div>
<!--第一頁結束-->
<!---分頁標記-->
<span style="page-break-after:always;"></span>
<!--第二頁開始-->
<div class 
="page">
    <div>第二頁開始了</div>
    <!--外部連結-->
    <p>百度圖示</p>
    <div>
        <img src="${imageUrl}" alt="百度圖示" width="270" height="129"/>
    </div>
    <!--動態生成的圖片-->
    <p>氣溫變化對比圖</p>
    <div>
        <img src="${picUrl}" alt="我的圖片" width="500" height="270"/>
    </div>
</div>


<!--第二頁結束-->
</body>
</html>

2、獲取模板內容並填充資料

/**
 * @description 獲取模板
 */
public static String getContent(String fileName,Object data){

    String templatePath=getPDFTemplatePath(fileName);//根據PDF名稱查詢對應的模板名稱
    String templateFileName=getTemplateName(templatePath);
    String templateFilePath=getTemplatePath(templatePath);
    if(StringUtils.isEmpty(templatePath)){
        throw new FreeMarkerException("templatePath can not be empty!");
    }
    try{
        Configuration config = new Configuration(Configuration.VERSION_2_3_25);//FreeMarker配置
        config.setDefaultEncoding("UTF-8");
        config.setDirectoryForTemplateLoading(new File(templateFilePath));//注意這裡是模板所在資料夾，不是檔案
        config.setTemplateExceptionHandler(TemplateExceptionHandler.RETHROW_HANDLER);
        config.setLogTemplateExceptions(false);
        Template template = config.getTemplate(templateFileName);//根據模板名稱 獲取對應模板
        StringWriter writer = new StringWriter();
        template.process(data, writer);//模板和資料的匹配
        writer.flush();
        String html = writer.toString();
        return html;
    }catch (Exception ex){
        throw new FreeMarkerException("FreeMarkerUtil process fail",ex);
    }
}

　　3、匯出模板到PDF檔案

/**
     * @description     匯出pdf到檔案
     * @param fileName  輸出PDF檔名
     * @param data      模板所需要的資料
     *
     */
public String exportToFile(String fileName,Object data){
     String htmlData= FreeMarkerUtil.getContent(fileName, data);//獲取FreeMarker的模板資料
    if(StringUtils.isEmpty(saveFilePath)){
        saveFilePath=getDefaultSavePath(fileName);//設定PDF檔案輸出路徑
    }
    File file=new File(saveFilePath);
    if(!file.getParentFile().exists()){
        file.getParentFile().mkdirs();
    }
    FileOutputStream outputStream=null;
    try{
        //設定輸出路徑
        outputStream=new FileOutputStream(saveFilePath);
        //設定文件大小
        Document document = new Document(PageSize.A4);//IText新建PDF文件
        PdfWriter writer = PdfWriter.getInstance(document, outputStream);//設定文件和輸出流的關係

        //設定頁首頁尾
        PDFBuilder builder = new PDFBuilder(headerFooterBuilder,data);
        builder.setPresentFontSize(10);
        writer.setPageEvent(builder);

        //輸出為PDF檔案
        convertToPDF(writer,document,htmlData);
    }catch(Exception ex){
        throw new PDFException("PDF export to File fail",ex);
    }finally{
        IOUtils.closeQuietly(outputStream);
    }
    return saveFilePath;

}

4、測試工具類

public  String createPDF(Object data, String fileName){
            //pdf儲存路徑
            try {
                //設定自定義PDF頁首頁尾工具類
                PDFHeaderFooter headerFooter=new PDFHeaderFooter();
                PDFKit kit=new PDFKit();
                kit.setHeaderFooterBuilder(headerFooter);
                //設定輸出路徑
                kit.setSaveFilePath("/Users/fgm/Desktop/pdf/hello.pdf”);//設定出書路徑
                String saveFilePath=kit.exportToFile(fileName,data);
                return  saveFilePath;
            } catch (Exception e) {
                log.error("PDF生成失敗{}", ExceptionUtils.getFullStackTrace(e));
                return null;
            }
        
        }

public static void main(String[] args) {
         ReportKit360 kit=new ReportKit360();
                TemplateBO templateBO=new TemplateBO();//配置模板資料
                templateBO.setTemplateName("Hello iText! Hello freemarker! Hello jFreeChart!");
                templateBO.setFreeMarkerUrl("http://www.zheng-hang.com/chm/freemarker2_3_24/ref_directive_if.html");
                templateBO.setITEXTUrl("http://developers.itextpdf.com/examples-itext5");
    
    templateBO.setJFreeChartUrl("http://www.yiibai.com/jfreechart/jfreechart_referenced_apis.html");
        templateBO.setImageUrl("https://ss0.bdstatic.com/5aV1bjqh_Q23odCf/static/superman/img/logo/bd_logo1_31bdc765.png");
        
        
             List<String> scores=new ArrayList<String>();
                scores.add("90");
                scores.add("95");
                scores.add("98");
                templateBO.setScores(scores);
                List<Line> lineList=getTemperatureLineList();
                TemperatureLineChart lineChart=new TemperatureLineChart();
                String picUrl=lineChart.draw(lineList,0);//自定義的資料畫圖
                templateBO.setPicUrl(picUrl);
                String path= kit.createPDF(templateBO,"hello.pdf");
            System.out.println(path);
        
        }

六、生成效果圖：

七、專案完整程式碼

1、github地址：https://github.com/superad/pdf-kit
2、專案git地址：[email protected]:superad/pdf-kit.git

八、遇到的坑：

1、FreeMarker配置模板檔案樣式，在實際PDF生成過程中，可能會出現一些不一致的情形，目前解決方法，就是換種方式調整樣式。

2、字型檔案放在resource下，在打包時會報錯，執行mvn -X compile 會看到詳細錯誤：
這是字型檔案是二進位制的，而maven專案中配置了資原始檔的過濾，不能識別二進位制檔案導致的，
plugins中增加下面這個配置就好了：

<build>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <filtering>true</filtering>
        </resource>
    </resources>
    <!--增加的配置,過濾ttf檔案的匹配-->
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-resources-plugin</artifactId>
            <version>2.7</version>
            <configuration>
                <encoding>UTF-8</encoding>
                <nonFilteredFileExtensions>
                    <nonFilteredFileExtension>ttf</nonFilteredFileExtension>
                </nonFilteredFileExtensions>
            </configuration>
        </plugin>
    </plugins>
</build>

3、PDF分頁配置：

  在ftl檔案中，增加分頁標籤： <span style="page-break-after:always;"></span>

九、 完整maven配置：

<!--pdf生成 itext-->
  
 <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>itextpdf</artifactId>
        <version>5.4.2</version>
     </dependency>
 <dependency>
    <groupId>com.itextpdf.tool</groupId>
    <artifactId>xmlworker</artifactId>
    <version>5.4.1</version>
</dependency>
<dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>itext-asian</artifactId>
    <version>5.2.0</version>
</dependency>
<dependency>
    <groupId>org.xhtmlrenderer</groupId>
    <artifactId>flying-saucer-pdf</artifactId>
    <version>9.0.3</version>
</dependency>
<!--freemarker-->
<dependency>
    <groupId>org.freemarker</groupId>
    <artifactId>freemarker</artifactId>
    <version>2.3.26-incubating</version>
</dependency>
<!--jfreechart-->
<dependency>
    <groupId>jfreechart</groupId>
    <artifactId>jfreechart</artifactId>
    <version>1.0.0</version>
</dependency>
<!--log-->
<dependency>
    <groupId>ch.qos.logback</groupId>
    <artifactId>logback-core</artifactId>
    <version>1.0.13</version>
</dependency>
<dependency>
    <groupId>ch.qos.logback</groupId>
    <artifactId>logback-classic</artifactId>
    <version>1.0.13</version>
</dependency>
<dependency>
    <groupId>ch.qos.logback</groupId>
    <artifactId>logback-access</artifactId>
    <version>1.0.13</version>
</dependency>
<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-api</artifactId>
    <version>1.7.5</version>
</dependency>
<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>log4j-over-slf4j</artifactId>
    <version>1.7.21</version>
</dependency>
<!--util-->
<dependency>
    <groupId>com.google.guava</groupId>
    <artifactId>guava</artifactId>
    <version>20.0</version>
</dependency>
<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <version>1.14.8</version>
</dependency>
<dependency>
    <groupId>org.apache.commons</groupId>
    <artifactId>commons-io</artifactId>
    <version>1.3.2</version>
</dependency>
<dependency>
    <groupId>commons-lang</groupId>
    <artifactId>commons-lang</artifactId>
    <version>2.6</version>
</dependency>
<!--servlet-->
<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>servlet-api</artifactId>
    <version>2.5</version>
</dependency>

轉載https://segmentfault.com/a/1190000009160184

java根據模板動態生成PDF

java根據模板動態生成PDF

freemarker模板動態生成word檔案

Java執行時動態生成類實現過程詳解

匯出Word工具類（根據資料動態生成並跨列）

使用T4模板動態生成郵件內容並儲存到任意位置（來自網路）

Java 使用i Text 生成 pdf

Java使用iText根據HTML模板生成PDF報表

根據模板PDF動態插入資料(合同等)

通過pdf模板，填充內容，生成pdf檔案---JAVA

Java 動態生成類和例項, 並注入方法操作示例

根據資料庫欄位動態生成excel模版下載，上傳模版獲取資料存入資料庫(poi+反射)

Java Spring動態生成Mysql儲存過程詳解

java spring動態生成定時任務

java使用模板生成word檔案

Jexl表示式引擎-根據字串動態執行JAVA.md

JAVA專案實戰-實現生成固定格式PDF檔案和打包成zip壓縮包並在瀏覽器中輸出

java通過html生成pdf,支援css和圖片以及橫向列印

Power BI 根據使用者許可權動態生成導航跳轉目標

java-常用-iText5生成pdf

java原生動態生成驗證碼

java根據模板動態生成PDF

相關推薦