使用Apache POI操作Office文件的元数据与属性

Apache POI 是一个开源的 Java 库，用于操作 Microsoft Office 格式的文件，例如 Word、Excel 和 PowerPoint。除了读写文件的内容，还可以使用 Apache POI 对文件的元数据和属性进行操作，为文件添加更多的信息和特性。

添加文件属性

使用 Apache POI 可以为 Office 文件添加各种属性，如作者、标题、主题、关键字等。下面是一个简单的例子，展示如何为 Word 文件添加属性：

import org.apache.poi.xwpf.usermodel.XWPFDocument;
import org.apache.poi.xwpf.usermodel.XWPFProperties;
import org.openxmlformats.schemas.officeDocument.x2006.extendedProperties.CTProperties;

import java.io.FileOutputStream;
import java.io.IOException;

public class WordPropertiesExample {
    public static void main(String[] args) throws IOException {
        XWPFDocument document = new XWPFDocument();
        
        // 获取文件属性对象
        XWPFProperties properties = document.getProperties();
        CTProperties extendedProperties = properties.getExtendedProperties().getUnderlyingProperties();

        // 添加属性值
        extendedProperties.setTitle("My Document");
        extendedProperties.setSubject("Example");
        extendedProperties.setKeywords("Apache POI, Word, Metadata");
        extendedProperties.setAuthor("John Doe");

        // 保存文件
        FileOutputStream outputStream = new FileOutputStream("example.docx");
        document.write(outputStream);
        outputStream.close();
        
        document.close();
    }
}

通过 XWPFProperties 对象可以获取文件的属性，并通过 CTProperties 对象设置属性的值。在上面的例子中，我们为 Word 文件添加了标题、主题、关键字和作者属性，并将文件保存为 example.docx。

类似的，Apache POI 还提供了操作 Excel 文件和 PowerPoint 文件属性的 API，可以根据需求选择合适的类和方法进行操作。

读取文件属性

除了添加属性，Apache POI 也支持读取 Office 文件的属性。下面是一个读取 Excel 文件属性的例子：

import org.apache.poi.POIXMLProperties;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;

import java.io.FileInputStream;
import java.io.IOException;

public class ExcelPropertiesExample {
    public static void main(String[] args) throws IOException {
        // 加载文件
        FileInputStream inputStream = new FileInputStream("example.xlsx");
        XSSFWorkbook workbook = new XSSFWorkbook(inputStream);

        // 获取文件属性对象
        POIXMLProperties properties = workbook.getProperties().getCoreProperties();

        // 读取属性值
        String title = properties.getTitle();
        String subject = properties.getSubject();
        String keywords = properties.getKeywords();
        String author = properties.getCreator();

        // 输出属性值
        System.out.println("Title: " + title);
        System.out.println("Subject: " + subject);
        System.out.println("Keywords: " + keywords);
        System.out.println("Author: " + author);

        workbook.close();
        inputStream.close();
    }
}

在上面的例子中，我们使用 POIXMLProperties 对象读取 Excel 文件的属性，并将属性的值打印到控制台。

总结

使用 Apache POI 可以方便地操作 Office 文件的元数据和属性，为文件添加更多的信息和特性。无论是添加属性还是读取属性，都可以通过相应的 API 进行操作。通过合理使用 Apache POI，可以优化文件的管理和使用体验。