Java 读取或删除 Excel 文件文档属性：Spire.XLS for Java 实用指南

Excel文件不仅仅是数据表格，它们还承载着重要的元数据，即"文档属性"。这些属性（如作者、标题、公司、创建日期等）在文件管理、信息溯源和数据合规性方面扮演着关键角色。然而，在Java应用中如何高效地读取或删除这些属性，常常是开发者面临的痛点。本文将深入探讨如何利用功能强大的Spire.XLS for Java库，轻松实现Excel文档属性的读写与删除操作，为你的数据处理工作提供实用解决方案。

Spire.XLS for Java 库简介与安装

Spire.XLS for Java 是一个专业的Java Excel API，专注于提供高性能、高质量的Excel文件处理能力。它支持各种Excel操作，包括创建、读取、写入、转换和打印Excel文档，且无需依赖Microsoft Office。其直观的API设计使得开发者可以便捷地操作Excel的各种元素，包括单元格、行、列、图表、图片以及我们今天要讨论的文档属性。

要将Spire.XLS for Java引入你的项目，只需在Maven配置文件中添加相应的依赖即可。

Maven 依赖：

xml 复制代码

    
    
    
  <repositories>
    <repository>
        <id>com.e-iceblue</id>
        <name>e-iceblue</name>
        <url>https://repo.e-iceblue.cn/repository/maven-public/</url>
    </repository>
</repositories>
<dependencies>
    <dependency>
        <groupId>e-iceblue</groupId>
        <artifactId>spire.xls</artifactId>
        <version>15.11.3</version>
    </dependency>
</dependencies>

Java 获取 Excel 文件的文档属性

Excel文档属性分为两类：内置属性 (Built-in Properties) 和自定义属性 (Custom Properties)。内置属性是Excel预定义的，如标题、主题、作者、公司、创建日期等。自定义属性则允许用户根据需要添加额外的信息。

以下代码示例展示了如何使用Spire.XLS for Java来读取Excel文件的这些文档属性：

java 复制代码

    
    
    
  import com.spire.xls.*;

public class ReadProperties {
    public static void main(String[] args) {
        //加载Excel文档
        Workbook wb = new Workbook();
        wb.loadFromFile("AddProperties.xlsx");

        //读取Excel内置文档属性
        System.out.println("标题： " + wb.getDocumentProperties().getTitle());
        System.out.println("主题： " + wb.getDocumentProperties().getSubject());
        System.out.println("作者： " + wb.getDocumentProperties().getAuthor());
        System.out.println("单位： " + wb.getDocumentProperties().getCompany());
        System.out.println("主管： " + wb.getDocumentProperties().getManager());
        System.out.println("类别： " + wb.getDocumentProperties().getCategory());
        System.out.println("关键字： " + wb.getDocumentProperties().getKeywords());

        //获取Excel自定义文档属性
        DocumentProperty property = (DocumentProperty) wb.getCustomDocumentProperties().get(0);
        //读取第一个自定义文档属性的名称和值
        System.out.println("名称： " + property.getName());
        System.out.println("值： " + property.getValue());
    }
}

代码说明：

Workbook.loadFromFile()：加载指定的Excel文件。
Workbook.getDocumentProperties().get()：获取文档属性对象。
Workbook.getCustomDocumentProperties().get()：获取自定义文档属性集合。

Java 删除 Excel 的文档属性

删除文档属性的场景通常是为了保护隐私信息、清理不必要的元数据或确保文件合规性。Spire.XLS for Java 提供了灵活的方式来删除特定的自定义属性或清空所有自定义属性。

以下代码示例展示了如何删除Excel文件的文档属性：

java 复制代码

    
    
    
  import com.spire.xls.*;

public class RemoveProperties {
    public static void main(String[] args) {
        //加载Excel文档
        Workbook wb = new Workbook();
        wb.loadFromFile("AddProperties.xlsx");

        //通过将对应文档属性的值设置为空来删除该内置属性
        wb.getDocumentProperties().setTitle("");
        wb.getDocumentProperties().setSubject("");
        wb.getDocumentProperties().setAuthor("");
        wb.getDocumentProperties().setCompany("");
        wb.getDocumentProperties().setManager("");
        wb.getDocumentProperties().setCategory("");
        wb.getDocumentProperties().setKeywords("");
        wb.getDocumentProperties().setComments("");

        //根据自定义文档属性的名称来移除该自定义文档属性
        wb.getCustomDocumentProperties().remove("编辑");
        wb.getCustomDocumentProperties().remove("联系电话");

        //保存文档
        wb.saveToFile("RemoveProperties.xlsx", ExcelVersion.Version2010);
        wb.dispose();
    }
}

代码说明：

Workbook.getCustomDocumentProperties().remove()：通过属性名称删除指定的自定义属性。
对于内置属性，通常通过setXXX("")或setXXX(null)来将其值置空，达到"删除"的效果。
Workbook.saveToFile("...", ExcelVersion.Version2013)：将修改后的工作簿保存到新的Excel文件，并指定Excel版本。

结论

通过本文的介绍，你已经掌握了如何使用Spire.XLS for Java库来读取和删除Excel文件的文档属性。无论是获取重要的元数据，还是进行敏感信息的清理，Spire.XLS for Java都提供了简洁高效的API支持。它极大地简化了Java开发者在处理Excel文档属性时的复杂性，是Java生态中处理Excel文件的强大工具。鼓励你进一步探索Spire.XLS for Java的更多高级功能，以满足更复杂的Excel操作需求。