Apache POI HWPFDocument插入超链接及CharacterRun设置超链接方法咨询

CharacterRun设置超链接可行性结论 #

无法直接通过CharacterRun的原生API将对应内容设置为超链接。
HWPF对应处理Word 97-2003版本的.doc格式文件，该格式中超链接属于字段类型，需要同时关联文本范围和跳转地址，属性没有绑定在单个CharacterRun上，因此不能仅通过修改CharacterRun的参数实现。

可行实现方案 #

操作逻辑是通过插入超链接类型的文档字段关联指定文本范围，具体步骤如下：

• 定位或生成要作为超链接显示的文本，记录该文本对应的起始、结束偏移量
• 在文档的字段集合中插入类型为HYPERLINK的字段，关联上文的偏移量范围，同时设置跳转地址
• 可选：给对应CharacterRun设置蓝色、单下划线样式，匹配Word默认超链接的显示效果

代码示例 #

import org.apache.poi.hwpf.HWPFDocument;
import org.apache.poi.hwpf.usermodel.*;
import java.io.*;

public class HWPFAddHyperlink {
    public static void main(String[] args) throws IOException {
        // 加载本地doc文件
        HWPFDocument doc = new HWPFDocument(new FileInputStream("原始文件.doc"));
        Range docRange = doc.getRange();

        // 示例：新增超链接文本，也可通过搜索匹配已有文本的起止偏移量
        String showText = "测试超链接";
        CharacterRun linkRun = docRange.insertAfter(showText);
        // 设置超链接默认显示样式
        linkRun.setColor(0x0000FF); // 蓝色
        linkRun.setUnderline(UnderlinePatterns.SINGLE);

        // 插入超链接字段关联文本范围
        int startPos = linkRun.getStartOffset();
        int endPos = linkRun.getEndOffset();
        Fields docFields = doc.getFields();
        // 第二个参数为跳转地址，注意加双引号包裹
        docFields.insertField(startPos, endPos, FieldType.HYPERLINK, "\"https://示例地址.com\"");

        // 输出修改后的文件
        FileOutputStream outputStream = new FileOutputStream("输出文件.doc");
        doc.write(outputStream);
        outputStream.close();
        doc.close();
    }
}

注意：如果是给文档中已存在的文本添加超链接，不需要调用insertAfter插入新文本，直接通过范围搜索获取目标文本的起止偏移量即可。

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