Java 自动化设置 Excel 文件文档属性

在日常开发中，我们经常需要自动化生成 Excel 报表。然而，仅仅填充数据是远远不够的。一个专业的 Excel 文件，其文档属性（如作者、标题、公司、甚至自定义属性）往往能大大提升文件的可管理性和可检索性。你是否曾为如何通过 Java 代码设置这些属性而烦恼？别担心，本文将为你揭示如何利用强大的 Spire.XLS for Java 库，轻松实现这一目标！

Spire.XLS for Java 库介绍与安装

Spire.XLS for Java 是一个功能丰富的 Excel 处理组件，专门用于在 Java 应用程序中创建、读取、编辑和转换 Excel 文件。它的最大优势在于无需安装 Microsoft Office 软件即可独立运行，这对于服务器端应用尤其重要。它支持多种 Excel 格式，并提供了对单元格、行、列、工作表、图表、图像、公式乃至文档属性等全方位的操作接口。

Maven 依赖配置：

如果你使用 Maven 项目，只需在 pom.xml 文件中添加以下依赖即可：

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>

你也可以直接从 Spire.XLS for Java 官网下载 JAR 包手动导入项目。

Java 设置内置的 Excel 文档属性

Excel 文件内置了多种标准文档属性，用于描述文件的基本信息，例如标题、作者、主题、公司、类别、关键字和备注等。Spire.XLS for Java 提供了简单直观的 API 来访问和修改这些属性。

以下代码示例演示了如何设置这些内置属性：

scss 复制代码

import com.spire.xls.ExcelVersion;
import com.spire.xls.Workbook;

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

        //给文档设置标题、主题、作者等内置文档属性
        workbook.getDocumentProperties().setTitle("设置文档属性");
        workbook.getDocumentProperties().setSubject("Spire.XLS for Java Demo");
        workbook.getDocumentProperties().setAuthor("张丽");
        workbook.getDocumentProperties().setManager("王刚");
        workbook.getDocumentProperties().setCompany("E-iceblue");
        workbook.getDocumentProperties().setCategory("Spire.XLS for Java");
        workbook.getDocumentProperties().setKeywords("Excel文档属性");

        //保存结果文档
        workbook.saveToFile("BuiltinDocumentProperties.xlsx", ExcelVersion.Version2013);
    }
}

运行上述代码后，打开生成的 BuiltInDocumentProperties.xlsx 文件，在"文件"->"信息"->"属性"中，你就可以看到这些被设置好的属性了。

Java 设置自定义的 Excel 文档属性

除了内置属性，Excel 还允许用户添加自定义文档属性。这些属性以键值对的形式存在，非常适合存储一些特定的、与业务逻辑相关的元数据，例如"项目编号"、"版本号"、"审核人"等。这对于文件的自动化管理和数据检索提供了极大的便利。

以下代码演示了如何添加、修改和删除自定义文档属性：

typescript 复制代码

import com.spire.xls.ExcelVersion;
import com.spire.xls.Workbook;

import java.util.Date;

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

        //给文档添加自定义文档属性
        workbook.getCustomDocumentProperties().add("_MarkAsFinal", true);
        workbook.getCustomDocumentProperties().add("编辑", "E-iceblue");
        workbook.getCustomDocumentProperties().add("联系电话", 81705109);
        workbook.getCustomDocumentProperties().add("更新日期", new Date());

        //保存结果文档
        workbook.saveToFile("CustomDocumentProperties.xlsx", ExcelVersion.Version2013);
    }
}

运行上述代码，打开生成的 CustomDocumentProperties.xlsx 文件，在"文件"->"信息"->"属性"->"显示所有属性"或"高级属性"中，你就能看到这些自定义属性了。

总结

通过本文的详细教程，我们学习了如何利用 Spire.XLS for Java 库，在 Java 应用程序中轻松设置 Excel 文件的内置和自定义文档属性。这不仅能让你的自动化生成的 Excel 报表看起来更加专业，还能极大地提升文件的可管理性和检索效率，在自动化办公和数据管理中发挥重要作用。现在，是时候将这些技巧应用到你的项目中了，去探索 Spire.XLS for Java 更多强大的功能吧！