-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

在博主完成尚未完成的web專案的過程中，又遇到了這樣一個需求，當用戶點選相關按鈕時，系統依據模板生成一份Word文件並提供下載。

實現的依據參考了這篇部落格，現在將我的實現過程記錄下來，為後人行個方便也為自己留個記錄。

首先要指出的是，實現的思路和freeMarker差不離，將.doc的文件做相應的轉換後轉為.ftl文件，其中的變數會以${xxx}來代替，這樣就可以

使用freeMarker模板引擎來替換變數啦為例，動態生成檔案後傳送到瀏覽器端提供使用者下載。所以，實現該功能分為以下幾個步驟，以我的

專案為例，一些敏感的資訊可能不予展示，但不影響該功能的學習。

1.為你的專案匯入freeMarker包

我的專案是依靠maven來維護依賴的，所以引入很方便，只需要在pom檔案中加入下面這個依賴就好

<dependency>
    <groupId>org.freemarker</groupId>
    <artifactId>freemarker</artifactId>
    <version>2.3.23</version>
</dependency>
 

2.依據模板動態生成word文件，首先你得有個模板

模板是doc型別就好，注意不是docx，docx沒有嘗試，doc型別已經滿足了我的需求，朋友們如果嘗試成功了可以告訴我一下

test.doc,注意“產品品質證明書”是一張圖片哦，圖片會漂亮的留在生成的新文件中。將變數替換成${xxx}即可，這裡只選了兩

個變數

3.點選 檔案->另存為 將test.doc儲存為xml型別，即 Word XML文件 .xml型別 ，得到test.xml

4.用notepad或者sublime開啟test.xml，你會發現${xxx}會被分割成${*********xxx********)的樣子，將*******刪除，保證它又成了完整的變數

標籤，像這樣

5.將檔案已utf-8編碼儲存，另存為為.ftl，找不到該格式直接改檔案字尾名就行，這樣得到test.ftl

6.前臺觸發事件

我的專案是基於SpringMVC的，所以前臺觸發只需要在view層的檔案里加個按鈕事件即可，直接上程式碼

function generateMillCertificate(id) {//點選下載按鈕觸發的事件
        window.location.href = '../deliveryOrder/exportMillCertificate?id=' + id;
    }

這裡又分為兩步

a.controller層接收請求，根據引數拼湊資料，放在map中

/***
     * 匯出Word材質單
     *
     * @return
     * @throws Exception
     */
    @RequestMapping(value = "exportMillCertificate", method = RequestMethod.GET)
    @ResponseBody
    public void exportMillCertificate(HttpServletRequest request,
                      HttpServletResponse response) throws Exception {
        //獲得資料，系統相關，就不展示了
        Map<String, Object> map = new HashMap<String, Object>();
        map.put("customerShortName",deliveryOrder.getRepositoryName());
        map.put("productName",deliveryOrderDetail.getProductName());
        WordUtils.exportMillCertificateWord(request,response,map);
    }

生成新的文件，通過response返回給瀏覽器並提供使用者下載

public class WordUtils {
    //配置資訊,程式碼本身寫的還是很可讀的,就不過多註解了
    private static Configuration configuration = null;
    //這裡注意的是利用WordUtils的類載入器動態獲得模板檔案的位置
    private static final String templateFolder = WordUtils.class.getClassLoader().getResource("../../").getPath() + "asserts/templete/";
    static {
        configuration = new Configuration();
        configuration.setDefaultEncoding("utf-8");
        try {
            configuration.setDirectoryForTemplateLoading(new File(templateFolder));
        } catch (IOException e) {
            e.printStackTrace();
        }
   }

    private WordUtils() {
        throw new AssertionError();
    }

    public static void exportMillCertificateWord(HttpServletRequest request, HttpServletResponse response, Map map) throws IOException {
        Template freemarkerTemplate = configuration.getTemplate("test.ftl");
        File file = null;
        InputStream fin = null;
        ServletOutputStream out = null;
        try {
            // 呼叫工具類的createDoc方法生成Word文件
            file = createDoc(map,freemarkerTemplate);
            fin = new FileInputStream(file);

            response.setCharacterEncoding("utf-8");
            response.setContentType("application/msword");
            // 設定瀏覽器以下載的方式處理該檔名
            String fileName = "材質單"+DateUtils.curDateTimeStr14() + ".doc";
            response.setHeader("Content-Disposition", "attachment;filename="
                    .concat(String.valueOf(URLEncoder.encode(fileName, "UTF-8"))));

            out = response.getOutputStream();
            byte[] buffer = new byte[512];  // 緩衝區
            int bytesToRead = -1;
            // 通過迴圈將讀入的Word檔案的內容輸出到瀏覽器中
            while((bytesToRead = fin.read(buffer)) != -1) {
                out.write(buffer, 0, bytesToRead);
            }
        } finally {
            if(fin != null) fin.close();
            if(out != null) out.close();
            if(file != null) file.delete(); // 刪除臨時檔案
        }
    }

    private static File createDoc(Map<?, ?> dataMap, Template template) {
        String name =  "test.doc";
        File f = new File(name);
        Template t = template;
        try {
            // 這個地方不能使用FileWriter因為需要指定編碼型別否則生成的Word文件會因為有無法識別的編碼而無法開啟
            Writer w = new OutputStreamWriter(new FileOutputStream(f), "utf-8");
            t.process(dataMap, w);
            w.close();
        } catch (Exception ex) {
            ex.printStackTrace();
            throw new RuntimeException(ex);
        }
        return f;
    }
}

是不是完美的一腿。寫到這裡就結束啦。

您的幫助是我莫大的鼓勵！喜歡的話可以掃描左側二維碼隨意打賞哈~支付寶微信都可以，歡迎看看我的其他文章~

這篇文章目前收到了不少朋友的支援，在這裡謝謝你們了，打賞有價，支援與鼓勵無價！