在日常開發中，我們經常需要自動化生成 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 文件中添加以下依賴即可：

<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 來訪問和修改這些屬性。

以下代碼示例演示瞭如何設置這些內置屬性：

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 還允許用户添加自定義文檔屬性。這些屬性以鍵值對的形式存在，非常適合存儲一些特定的、與業務邏輯相關的元數據，例如“項目編號”、“版本號”、“審核人”等。這對於文件的自動化管理和數據檢索提供了極大的便利。

以下代碼演示瞭如何添加、修改和刪除自定義文檔屬性：

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 更多強大的功能吧！