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;
    }
}