使用Apache POI将DOCX内容插入ContentControl遇问题求助

我尝试将一个DOCX文件的byte[]内容插入到另一个DOCX文件的ContentControl中。此前类似场景里，我通过创建XWPFParagraph并传入XWPFDocument实现了带特殊格式文本的插入，因此以为直接传入该DOCX对应的XWPFDocument即可，但ContentControl显示为空。请帮忙排查：

1. 运行后ContentControl无内容的代码问题是什么？
2. 若该ContentControl位于句子中，要求插入内容不换行，插入XWPFParagraph是否会强制换行？是否应改用Run实现？

附代码：

void setContentControlClause(SDTContentControl contentControl) {
    //file is actually retrieved in code that would be here, but don't need to post that

    XWPFDocument doc = null
    try {
        doc = new XWPFDocument(OPCPackage.open(new ByteArrayInputStream(file.fileData)))
    } catch (IOException | InvalidFormatException e) {
        throw new Exception(e.getMessage(), e)
    } catch (InvalidOperationException invalidFile) {
        invalidFile.printStackTrace()
    }

    XWPFParagraph paragraph = new XWPFParagraph(CTP.Factory.newInstance(), doc)
    contentControl.setContent(paragraph)
}

1. ContentControl无内容的核心问题 #

你的代码完全没用到打开的源DOCX文档内容，只是创建了一个空的XWPFParagraph，自然不会显示任何内容。具体问题点：

• XWPFParagraph paragraph = new XWPFParagraph(CTP.Factory.newInstance(), doc) 生成的是一个没有文本、没有格式的空段落
• 你打开了源DOCX文档doc，但没有做任何内容提取、复制的操作，等于白打开了文档

修复思路 #

需要遍历源DOCX里的段落、表格、Run等元素，把这些内容的底层XML结构复制到ContentControl中。示例修复代码：

void setContentControlClause(SDTContentControl contentControl) {
    XWPFDocument sourceDoc = null;
    try {
        sourceDoc = new XWPFDocument(OPCPackage.open(new ByteArrayInputStream(file.fileData)));
        
        // 先清空ContentControl原有内容
        contentControl.getContent().clear();
        
        // 复制源文档的段落（带格式）
        for (XWPFParagraph sourcePara : sourceDoc.getParagraphs()) {
            // 复制段落的底层CTP结构，保留所有格式
            CTP copiedCTP = CTP.Factory.parse(sourcePara.getCTP().xmlText());
            XWPFParagraph newPara = new XWPFParagraph(copiedCTP, contentControl.getDocument());
            contentControl.getContent().add(newPara);
        }
        
        // 如果源文档有表格，也需要复制
        for (XWPFTable sourceTable : sourceDoc.getTables()) {
            CTTbl copiedCTTbl = CTTbl.Factory.parse(sourceTable.getCTTbl().xmlText());
            XWPFTable newTable = new XWPFTable(copiedCTTbl, contentControl.getDocument());
            contentControl.getContent().add(newTable);
        }
        
    } catch (IOException | InvalidFormatException | XmlException e) {
        throw new RuntimeException(e.getMessage(), e);
    } finally {
        if (sourceDoc != null) {
            try {
                sourceDoc.close();
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
    }
}

2. 换行问题与Run的使用 #

• 插入XWPFParagraph一定会强制换行，因为段落是Word的块级元素，每个段落自带段落标记，会把前后内容分割成独立的行。
• 如果ContentControl在句子中间，要求插入内容不打断原有行，必须改用Run实现。Run是Word的行内元素，可以直接嵌入到现有段落的行中，不会产生换行。

行内插入（不换行）的示例思路 #

如果源DOCX内容都是行内文本，可直接提取Run的内容和格式，复制到ContentControl所在的段落中：

// 获取ContentControl所在的原有段落
XWPFParagraph existingPara = contentControl.getParagraph();
// 清空原有内容
existingPara.removeAllRuns();

for (XWPFParagraph sourcePara : sourceDoc.getParagraphs()) {
    for (XWPFRun sourceRun : sourcePara.getRuns()) {
        XWPFRun newRun = existingPara.createRun();
        // 复制文本内容
        newRun.setText(sourceRun.getText(0));
        // 复制格式（字体、大小、加粗、斜体等）
        newRun.setFontFamily(sourceRun.getFontFamily());
        newRun.setFontSize(sourceRun.getFontSize());
        newRun.setBold(sourceRun.isBold());
        newRun.setItalic(sourceRun.isItalic());
        // 其他格式（下划线、颜色等）按需复制
    }
}

注意：如果源DOCX包含表格、图片、段落级格式（如行距、缩进）等块级元素，用Run插入就不适用了，这种情况只能接受段落带来的换行，或者提前调整源文档结构，确保插入内容都是行内元素。

内容的提问来源于stack exchange，提问作者bytor99999