Spring Boot + FreeMarker制作word模板導出Word表格

freemarker

• FreeMarker是一款模板引擎： 即一種基於模板和要改變的數據， 並用來生成輸出文本（HTML網頁、電子郵件、配置文件、源代碼等）的通用工具。 它不是面向最終用戶的，而是一個Java類庫，是一款程序員可以嵌入他們所開發產品的組件。
• FreeMarker是免費的，基於Apache許可證2.0版本發布。其模板編寫為FreeMarker Template Language（FTL），屬於簡單、專用的語言。需要准備數據在真實編程語言中來顯示，比如數據庫查詢和業務運算， 之后模板顯示已經准備好的數據。在模板中，主要用於如何展現數據， 而在模板之外注意於要展示什么數據

 

<!--添加freeMarker-->
        <dependency>
            <groupId>org.freemarker</groupId>
            <artifactId>freemarker</artifactId>
            <version>2.3.20</version>
        </dependency>

下一步我們要做的是先好我們的word模板然后將模板轉換為xml文件。在word模板中需要定義好我們的占位符哦，使用${string}的方式。“string”根據自己的愛好定義就好了。

過程如下：

word文檔：

 

然后將我們的word文檔另存為xml文檔。

 

將我們的xml文檔的后綴改為ftl，然后用可以打開ftl文件的軟件打開我們的ftl文件。在這里我們有幾個需要注意的地方。

第一，定義的占位符可能會被分開了。就像下面這樣：

我們需要做的就是刪掉多余的部分，圖中我定義的是${userName}.所以我就把多余的刪掉，變成${userName}就可以了。

第二，我們需要注意的就是在我們的表格部分需要自己添加freeMarker標簽。在表格代碼間用自定的標簽括起來。定義的參數要和我們在方法中定義的一致，否則無法取到值。

表格開始：

 

 結束：</list>

 

package czc.sup.system.model.six;



import freemarker.template.Configuration;
import freemarker.template.Template;

import java.io.*;
import java.util.Map;

public class WordUtil {

    /**
     * 生成word文件
     * @param dataMap word中需要展示的動態數據，用map集合來保存
     * @param templateName word模板名稱，例如：test.ftl
     * @param filePath 文件生成的目標路徑，例如：D:/wordFile/
     * @param fileName 生成的文件名稱，例如：test.doc
     */
    @SuppressWarnings("unchecked")
    public static void createWord(Map dataMap,String templateName,String filePath,String fileName){
        try {
            //創建配置實例
            Configuration configuration = new Configuration();

            //設置編碼
            configuration.setDefaultEncoding("UTF-8");

            //ftl模板文件
            configuration.setClassForTemplateLoading(WordUtil.class,"/");

            //獲取模板
            Template template = configuration.getTemplate(templateName);

            //輸出文件
            File outFile = new File(filePath+File.separator+fileName);

            //如果輸出目標文件夾不存在，則創建
            if (!outFile.getParentFile().exists()){
                outFile.getParentFile().mkdirs();
            }

            //將模板和數據模型合並生成文件
            Writer out = new BufferedWriter(new OutputStreamWriter(new FileOutputStream(outFile),"UTF-8"));


            //生成文件
            template.process(dataMap, out);

            //關閉流
            out.flush();
            out.close();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

 

 

    
    public static void main(String[] args) {
         /** 用於組裝word頁面需要的數據 */
        Map<String, Object> dataMap = new HashMap<String, Object>();
        DataWord dataWord = new DataWord("model", "name", "designCode", "code", "met", "date", "temp", "humi", "hly");
        List<Object> datas = new ArrayList<>();
        for(int i=0;i<10;i++){
            Data data = new Data("1","檢測名"+i, "norm", "result", "remark");
            datas.add(data);
        }
        dataMap.put("product",dataWord);
        dataMap.put("datas",datas);
        String filePath = "";
        if (IsWhatSystem.whatSystem()) {
            //文件路徑
            filePath = "D:/doc_f/";
        }else {
            filePath = "/doc_f/";
        }
        //文件唯一名稱
        String fileOnlyName = "生成Word文檔.doc";
        /** 生成word  數據包裝，模板名，文件生成路徑，生成的文件名*/
        WordUtil.createWord(dataMap, "quality.ftl", filePath, fileOnlyName);
    }
    

然后就在相應的目錄下導出word文檔了