如何使用Apache POI读写Office文档中的非标准属性？

针对你遇到的这类不属于核心、自定义、扩展属性的meta:just-a-name属性，结合文件版本较新无法使用HPSF的情况，分两种常见格式给出解决方案：

一、若文件为OOXML格式（.docx/.xlsx/.pptx等） #

这类属性通常存储在OOXML包的元数据XML部件中，你可以直接操作包内的XML文件来读写：

1. 获取文档的OPCPackage实例，遍历相关元数据部件
2. 解析XML找到目标属性，修改后写回部件

示例代码：

import org.apache.poi.openxml4j.opc.OPCPackage;
import org.apache.poi.openxml4j.opc.PackagePart;
import org.w3c.dom.Document;
import org.w3c.dom.Element;
import org.w3c.dom.NodeList;
import javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;
import javax.xml.transform.Transformer;
import javax.xml.transform.TransformerFactory;
import javax.xml.transform.dom.DOMSource;
import javax.xml.transform.stream.StreamResult;
import java.io.OutputStream;
import java.util.regex.Pattern;

// 假设document是你的POIXMLDocument实例（如XWPFDocument/XSSFWorkbook）
OPCPackage pkg = document.getPackage();

// 遍历所有docProps下的XML元数据部件
for (PackagePart part : pkg.getPartsByName(Pattern.compile("/docProps/.*\\.xml"))) {
    Document xmlDoc = DocumentBuilderFactory.newInstance().newDocumentBuilder().parse(part.getInputStream());
    
    // 注意：需根据实际XML的命名空间调整，这里假设属性在meta命名空间下
    NodeList metaNodes = xmlDoc.getElementsByTagNameNS("urn:your-meta-namespace", "just-a-name");
    if (metaNodes.getLength() > 0) {
        Element targetMeta = (Element) metaNodes.item(0);
        // 修改属性值
        targetMeta.setAttribute("content", "新的属性值");
        
        // 将修改后的XML写回部件
        try (OutputStream os = part.getOutputStream()) {
            Transformer transformer = TransformerFactory.newInstance().newTransformer();
            transformer.transform(new DOMSource(xmlDoc), new StreamResult(os));
        }
        break;
    }
}

// 保存修改后的文档
document.write(out);

提示：如果不确定属性所在的命名空间和XML部件，可以将文档后缀改为.zip解压，查看内部XML文件找到just-a-name对应的位置。

二、若文件为ODF格式（.odt/.ods/.odp等） #

ODF格式的这类meta:前缀属性属于标准元数据范畴，POI的ODF API已封装了读写方法：

示例代码：

import org.apache.poi.odf.usermodel.ODFDocument;
import org.apache.poi.odf.usermodel.ODFMetadata;

// 假设document是你的ODFDocument实例
ODFDocument odfDoc = (ODFDocument) document;
ODFMetadata metadata = odfDoc.getMetadata();

// 读取属性值
String oldValue = metadata.getMetaAttribute("just-a-name");
// 设置新属性值
metadata.setMetaAttribute("just-a-name", "新的属性值");

// 保存修改后的文档
odfDoc.write(out);

通用思路 #

所有Office开放格式本质都是ZIP压缩包，若上述方法不适用，可直接解压文档，找到存储目标属性的XML文件，修改后重新压缩成文档。这种方法虽然繁琐，但适用于所有非标准属性场景。

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