在日常的數據處理工作中，我們經常需要在 Excel 表格中添加批註來解釋數據、提供背景信息或標記待辦事項。然而，手動操作效率低下，尤其當需要批量處理或集成到自動化流程中時。本文將深入探討如何利用 Spire.XLS for Java 這一強大庫，在 Java 應用程序中高效地實現 Excel 批註的添加與刪除，助您告別繁瑣，提升開發效率。

Spire.XLS for Java 庫介紹與安裝

Spire.XLS for Java 是一個專業級的 Java Excel API，專門用於創建、讀取、編輯、轉換和打印 Excel 文件，而無需安裝 Microsoft Office。它支持多種 Excel 功能，包括單元格格式、公式、圖表、圖片、批註等。其優勢在於功能全面、性能卓越，且提供豐富的API接口，極大簡化了 Java 操作 Excel 的複雜性。

Maven 依賴配置：

在您的 pom.xml 文件中添加以下依賴，即可引入 Spire.XLS for Java 庫：

<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.10.5</version>
    </dependency>
</dependencies>

獲取和引入庫：

您可以從 Spire.XLS for Java 官網下載 JAR 包並手動添加到項目構建路徑中。對於 Maven/Gradle 用户，配置好依賴後，構建工具會自動下載並引入庫。

Java 在 Excel 中添加批註

使用 Spire.XLS for Java 添加批註非常直觀。核心步驟包括加載 Excel 文件、選擇目標單元格、創建批註對象並設置其屬性，最後保存文件。

添加批註的步驟：

• 創建或加載 Workbook 對象： 表示一個 Excel 工作簿。
• 獲取目標 Worksheet： 通過索引或名稱獲取要操作的工作表。
• 獲取目標 CellRange： 定位到需要添加批註的單元格。
• 調用 CellRange.getComment().setText() 方法： 在 CellRange 對象上創建批註。
• 設置批註屬性： 包括批註文本、作者、可見性、尺寸等。
• 保存 Workbook： 將更改寫入 Excel 文件。

代碼示例：

import com.spire.xls.*;

public class InsertComments {
    public static void main(String[] args){
        //新建Excel文檔
        Workbook workbook = new Workbook();
        //獲取第一張工作表
        Worksheet sheet = workbook.getWorksheets().get(0);

        //創建字體
        ExcelFont font = workbook.createFont();
        font.setFontName("Arial");
        font.setSize(11);
        font.setKnownColor(ExcelColors.Orange);
        ExcelFont fontBlue = workbook.createFont();
        fontBlue.setKnownColor(ExcelColors.LightBlue);
        ExcelFont fontGreen = workbook.createFont();
        fontGreen.setKnownColor(ExcelColors.LightGreen);

        //給指定的Excel單元格添加普通批註
        CellRange range = sheet.getCellRange("A1");
        range.setText("Spire.XLS");
        range.getComment().setText("Excel文檔處理組件");
        range.autoFitColumns();

        //給指定的Excel單元格添加富文本批註
        range = sheet.getCellRange("A2");
        range.setText("Spire.XLS");
        range.getRichText().setFont(0, 8, font);
        range.autoFitColumns();
        range.getComment().getRichText().setText("Excel文檔處理組件");
        range.getComment().getRichText().setFont(0, 4, fontGreen);
        range.getComment().getRichText().setFont(5, 6, fontBlue);

        //保存結果文檔
        workbook.saveToFile("AddComments.xlsx", ExcelVersion.Version2013);
    }
}

批註關鍵屬性設置速覽：

Java 刪除 Excel 中的批註

刪除 Excel 批註同樣簡單，Spire.XLS for Java 提供了直接的方法來移除單元格上的批註。

刪除批註的步驟：

• 加載 Workbook 對象： 加載包含批註的 Excel 文件。
• 獲取目標 Worksheet： 獲取要操作的工作表。
• 獲取目標 CellRange： 定位到包含批註的單元格。
• 調用 ExcelCommentObject.remove() 方法： 從 Excel 中移除批註。
• 保存 Workbook： 將更改寫入 Excel 文件。

代碼示例：

import com.spire.xls.*;

public class deleteComment {
    public static void main(String[] args) {

        //創建Workbook類的對象
        Workbook wb = new Workbook();

        //載入Excel文件
        wb.loadFromFile("新員工信息.xlsx");

        //獲取載入的工作簿的第一個工作表
        Worksheet sheet = wb.getWorksheets().get(0);

        //獲取指定單元格的批註並刪除
        sheet.getRange().get("A4").getComment().remove();

        //保存文件
        wb.saveToFile("刪除批註.xlsx", ExcelVersion.Version2013);
        wb.dispose();
    }
}

總結

通過 Spire.XLS for Java，Java 開發者可以輕鬆實現 Excel 批註的添加與刪除，無論是單個單元格操作還是批量處理，都能高效完成。其清晰的 API 設計和豐富的功能，使其成為 Java 處理 Excel 文件的理想選擇。掌握這些技巧，您的 Java 應用將能更好地與 Excel 數據進行交互，為數據分析、報表生成等場景提供更靈活、強大的支持，從而顯著提升數據處理的自動化水平。