POI 实现Word替换文本2种情况（正常文本、表格文本）

妖狐艹你老母 2023-01-21 14:19 31阅读 0赞

### 1 Maven依赖 ###

<dependency>
                <groupId>cn.hutool</groupId>
                <artifactId>hutool-all</artifactId>
                <version>5.5.1</version>
            </dependency>
    
            <dependency>
                <groupId>com.alibaba</groupId>
                <artifactId>easyexcel</artifactId>
                <version>2.2.7</version>
            </dependency>

### 2 POIWordUtil ###

POI Word工具类。

package com.util;
    
    import java.util.List;
    import java.util.Map;
    import java.util.Map.Entry;
    import java.util.Set;
    
    import cn.hutool.core.util.StrUtil;
    import org.apache.poi.xwpf.usermodel.XWPFDocument;
    import org.apache.poi.xwpf.usermodel.XWPFParagraph;
    import org.apache.poi.xwpf.usermodel.XWPFRun;
    import org.apache.poi.xwpf.usermodel.XWPFTable;
    import org.apache.poi.xwpf.usermodel.XWPFTableCell;
    import org.apache.poi.xwpf.usermodel.XWPFTableRow;
    
    /**
     * poi word工具类
     */
    public class POIWordUtil {
        /**
         * 替换内容
         *
         * @param textMap 需要替换的信息集合
         */
        public static void replaceWord(XWPFDocument document,
                                       Map<String, String> textMap) {
            //解析替换文本段落对象
            changeText(document, textMap);
            //解析替换表格对象
            changeTable(document, textMap);
    
        }
    
        /**
         * 替换段落文本
         *
         * @param document docx解析对象
         * @param textMap  需要替换的信息集合
         */
        public static void changeText(XWPFDocument document, Map<String, String> textMap) {
            //获取段落集合
            List<XWPFParagraph> paragraphs = document.getParagraphs();
            for (XWPFParagraph paragraph : paragraphs) {
                //判断此段落时候需要进行替换
                String text = paragraph.getText();
                if (StrUtil.isNotBlank(text) && text.contains("${")) {
                    List<XWPFRun> runs = paragraph.getRuns();
                    for (XWPFRun run : runs) {
                        //替换模板原来位置
                        String textValue = changeValue(run.toString(), textMap);
                        run.setText(textValue, 0);
                    }
                }
            }
        }
    
        /**
         * 替换表格对象方法
         *
         * @param document docx解析对象
         * @param textMap  需要替换的信息集合
         */
        public static void changeTable(XWPFDocument document, Map<String, String> textMap) {
            //获取表格对象集合
            List<XWPFTable> tables = document.getTables();
            for (int i = 0; i < tables.size(); i++) {
                //只处理行数大于等于2的表格，且不循环表头
                XWPFTable table = tables.get(i);
                if (table.getRows().size() > 1) {
                    //判断表格内容是否可以替换
                    String cellText = table.getText();
                    if (StrUtil.isNotBlank(cellText) && cellText.contains("${")){
                        List<XWPFTableRow> rows = table.getRows();
                        //遍历表格,并替换模板
                        eachTable(rows, textMap);
                    }
                }
            }
        }
    
        /**
         * 遍历表格
         *
         * @param rows    表格行对象
         * @param textMap 需要替换的信息集合
         */
        public static void eachTable(List<XWPFTableRow> rows, Map<String, String> textMap) {
            for (XWPFTableRow row : rows) {
                List<XWPFTableCell> cells = row.getTableCells();
                for (XWPFTableCell cell : cells) {
                    //判断单元格内容是否可以替换
                    String cellText = cell.getText();
                    if (StrUtil.isNotBlank(cellText) && cellText.contains("${")) {
                        List<XWPFParagraph> paragraphs = cell.getParagraphs();
                        for (XWPFParagraph paragraph : paragraphs) {
                            List<XWPFRun> runs = paragraph.getRuns();
                            for (XWPFRun run : runs) {
                                run.setText(changeValue(run.toString(), textMap), 0);
                            }
                        }
                    }
                }
            }
        }
    
        /**
         * 匹配传入信息集合与模板
         *
         * @param value   模板需要替换的区域
         * @param textMap 传入信息集合
         * @return 模板需要替换区域信息集合对应值
         */
        public static String changeValue(String value, Map<String, String> textMap) {
            Set<Entry<String, String>> textSets = textMap.entrySet();
            for (Entry<String, String> textSet : textSets) {
                //匹配模板与替换值 格式${key}
                String key = "${" + textSet.getKey() + "}";
                if (value.indexOf(key) != -1) {
                    value = value.replace(key, textSet.getValue());
                }
            }
            return value;
        }
    }

### 3 调试代码 ###

/**
         * 替换内容
         *
         * @param response
         */
        @GetMapping("/replaceContent")
        public void replaceContent(HttpServletResponse response) {
            try {
                //读文件
                ClassPathResource cpr = new ClassPathResource("/doc/模板2.docx");
                XWPFDocument document = new XWPFDocument(cpr.getInputStream());
    
                //文本数据
                Map<String, String> contentMap = new HashMap<>();
                contentMap.put("xudongmaster", "旭东怪");
                contentMap.put("xudongmaster2", "旭东怪2");
                contentMap.put("xudongmaster3", "旭东怪3");
                contentMap.put("tablexudongmaster", "表格旭东怪");
                contentMap.put("tablexudongmaster2", "表格旭东怪2");
                contentMap.put("tablexudongmaster3", "表格旭东怪3");
                
                //替换内容
                POIWordUtil.replaceWord(document,contentMap);
    
                //返回流
                response.setHeader("content-type", "application/octet-stream");
                response.setContentType("application/octet-stream;charset=UTF-8");
                response.setHeader("Content-Disposition", "attachment; filename=" + new String("模板.docx".getBytes("utf-8"), "ISO-8859-1"));
                OutputStream outputStream = response.getOutputStream();
                document.write(outputStream);
                outputStream.flush();
                outputStream.close();
            } catch (Exception e) {
                e.printStackTrace();
            }
    
        }

### 4 模板文件 ###

模板目录：

![202105162032226.png][]

模板内容：

![20210516203302550.png][]

### 5 调试结果 ###

![2021051620332393.png][]

### 注： ###

出现内容没有替换成功的情况时，解决办法参考以下博客。

[POI XWPFParagraph.getRuns分段混乱问题解决][POI XWPFParagraph.getRuns]

[202105162032226.png]: /images/20221020/86649293d83a4e1aa72e95215aef271b.png
[20210516203302550.png]: /images/20221020/be9e6de69a72445caa097aed0b74d21a.png
[2021051620332393.png]: /images/20221020/7971b71cff694ac1824760f0f12389f1.png
[POI XWPFParagraph.getRuns]: https://blog.csdn.net/qq_38974638/article/details/116901925