java導出word，記錄主要步驟和遇到的問題及解決的方法

        最近有個項目需要導出word，大概有26頁，主要是圖片，不過圖片不是連續的，圖片下有標註說明，而且圖片需要通過JFreeChart生成餅狀圖和折線圖，本來頁面上的圖是echart的，太多了，不能用傳參到後臺，只能通過JFreeChart生成。找了很多方法，最後確定的方法是XML+FreeMarker來實現的。

        首先，製作word模板，我開始使用的是docx，導出word後，圖片的位置有向上或向下偏移，然後使用了doc，最後發現不是使用了docx或doc的問題，是另外的問題，後面詳解。網上有人說不能使用wps，會造成轉xml文件時，解析錯誤，這個沒有驗證過，不過有人說，應該是有可能的，所以還是建議使用office製作word模板。

       其次，將word模板轉xml，點擊word左上角的文件按鈕，再點擊另存爲，選擇保存路徑，最後選擇保存類型爲Word 2003XML文檔。我使用的編輯工具是Notepad++，在Notedpad++中的插件項中安裝XML Tools，就可以編輯格式化XML文件了，不然新打開的xml文件，內容是堆砌在一起的，不好看。安裝XML Tools後，插件項中會出現XML Tools，其中的pretty print(XML  only - with line breaks就是格式化，這樣就很好看層次了。<w:body>是word上的整個內容，<w:p>是段，<w:t>是具體的一組詞或句。

      現在可以使用ftl的方式替換需要動態生成的內容了。例如word的標題，可以使用ftl的格式，${title}替換，後端調用時，使用Map<String,Object>傳參，key爲title，如果需要List也是一樣的，Object是List即可。List的格式爲<#list maps as map></#list>，如果有的內容需要一定條件下使用時，可以使用：<#if name??></#if>，判斷循環是否爲空：<#if orgList?? && (orgList?size > 0) > </#if>。

      word導出，最麻煩的是圖片，圖片需要處理成base64，即是value值是base64的，而且是必須是base64的。

圖片的爲唯一標識不能相同，相同的話，就是一樣的圖片，兩個紅框的值必須相同，我在生成xml模板時，圖片有遺失，發現是圖片代碼段落缺少<w:binData>行，可以直接複製添加即可，將圖片唯一標識設置成與所有圖片的不同就可以了。也可以循環處理圖片，也是用<#list></#list>加在圖片的段落上<w:p>。

       最後，將xml的後綴改成ftl就可以了。再通過java後端生成Map數據，傳入word的參數是Map的，key就是word模板中ftl格式${key}。

       導出word時，遇到一個問題，就是圖片向上偏移或向下偏移了，經過研究，發現是<w:p wsp:rsidR="00C31F00" wsp:rsidRDefault="00C31F00" wsp:rsidP="00C31F00"/>的問題，是word中的回車符，通過增刪它，可以調整圖片的位置。

 

 

 

import freemarker.template.Configuration;
import freemarker.template.Template;
import org.jfree.chart.ChartUtilities;
import org.jfree.chart.JFreeChart;
import sun.misc.BASE64Encoder;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.*;
import java.net.URLEncoder;
import java.util.Map;


public class WordExportUtil {

    /**
     * 導出word
     * @param dataMap
     */
    public static void exportTemplateWord(Map<String,Object> dataMap, String year,
                                        HttpServletRequest request, HttpServletResponse response){
        try {
            File file = createWord(dataMap, year);
            response.setContentType("text/html;charset=utf-8");
            request.setCharacterEncoding("UTF-8");
            java.io.BufferedInputStream bis = null;
            java.io.BufferedOutputStream bos = null;

            try {
                long fileLength = file.length();
                response.setContentType("application/msword");
                response.setHeader("Content-disposition", "attachment; filename="
                        + URLEncoder.encode(year + "word名稱.doc", "utf-8"));
                response.setHeader("Content-Length", String.valueOf(fileLength));
                bis = new BufferedInputStream(new FileInputStream(file));
                bos = new BufferedOutputStream(response.getOutputStream());
                byte[] buff = new byte[2048];
                int bytesRead;
                while (-1 != (bytesRead = bis.read(buff, 0, buff.length))) {
                    bos.write(buff, 0, bytesRead);
                }
            } catch (Exception e) {
                e.printStackTrace();
            } finally {
                if (bis != null)
                    bis.close();
                if (bos != null)
                    bos.close();
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    public static File createWord(Map<String,Object> dataMap, String year) {
        Writer out = null;
        try {
            File outFile = new File(year + "word名稱");
            Template template=getTemplate();
            //將模板和數據模型合併生成文件
            out = new BufferedWriter(new OutputStreamWriter(new FileOutputStream(outFile),"UTF-8"));
            template.process(dataMap, out);
            out.flush();
            return outFile;
        } catch (Exception e) {
            e.printStackTrace();
        }finally {
            if(out != null){
                try {
                    out.close();
                } catch (IOException e) {
                    e.printStackTrace();
                }
            }
        }
        return null;
    }

    private static Template getTemplate() throws IOException {
        //創建配置實例
        Configuration configuration = new Configuration();
        //設置編碼
        configuration.setDefaultEncoding("UTF-8");
        //ftl模板文件統一放至/包下面
        configuration.setClassForTemplateLoading(WordExportUtil.class,"/templates/word/");
        // 獲取模板
        Template template=configuration.getTemplate("template.ftl");
        return template;
    }

    /**
     * 生成JFreeChart圖片並生成64位編碼
     * @param chart
     * @return
     */
    public static String getBase64Image(JFreeChart chart){
        ByteArrayOutputStream bos = null;
        InputStream is = null;
        try {
            BASE64Encoder encoder = new BASE64Encoder();
            bos = new ByteArrayOutputStream();
            ChartUtilities.writeChartAsPNG(bos, chart, 500, 200,null);
            bos.flush();

            byte[] byteArray = bos.toByteArray();
            is = new ByteArrayInputStream(byteArray);
            byteArray = new byte[is.available()];
            is.read(byteArray);
            String baseStr = encoder.encode(byteArray);
            return baseStr;
        } catch (IOException e) {
            e.printStackTrace();
        }finally {
            if(bos != null){
                try {
                    bos.close();
                } catch (IOException e) {
                }
            }
            if(is != null){
                try {
                    is.close();
                } catch (IOException e) {
                }
            }
        }
       return null;
    }
}