FineReport 報表插件開發與除錯實戰教學

在專案開發過程中，報表插件的除錯向來是痛點：修改程式碼、編譯、打包、卸載舊版、安裝新版，流程繁瑣且無法即時斷點除錯。本文介紹如何在 Eclipse 中建立獨立 Java 專案，直接啟動 FineReport 設計器進行插件開發與除錯，大幅提升開發效率。

一、環境準備：建立 Java 專案並引入依賴

1. 在 Eclipse 中建立一個標準 Java 專案。
2. 將 FineReport 設計器所需的所有 JAR 包加入 Build Path，主要包含三類：

• Jetty 相關 JAR： 內嵌伺服器運行所需。
• 設計器核心 JAR： fr-core.jar、fr-design.jar 等。
• 第三方依賴 JAR： 如資料庫驅動、POI、JSON 等。

提示：若啟動時出現 ClassNotFoundException，逐一補齊缺失的 JAR 即可。

二、撰寫 Main 類啟動設計器

import com.fr.start.Designer;

public class MainFrame {
    public static void main(String[] args) {
        new Designer(args);
    }
}

執行此 Main 類即可啟動設計器介面。控制台可能出現部分插件缺失的錯誤訊息，不影響核心功能除錯；若追求完美，可將對應插件 JAR 同步加入。

三、開發自訂插件範例

以下示範兩個簡單的設計器擴充插件：

1. 國際化資源定位器

package com.fr.plugin.designer;

import com.fr.stable.fun.impl.AbstractLocaleFinder;

public class ActualLocaleFinder extends AbstractLocaleFinder {
    @Override
    public String find() {
        return "com/fr/plugin/designer/resource/locale/search";
    }
}

2. 模板搜尋動作按鈕

package com.fr.plugin.designer;

import com.fr.base.BaseUtils;
import com.fr.design.actions.UpdateAction;
import com.fr.general.Inter;
import javax.swing.*;
import java.awt.event.ActionEvent;

public class SearchTemplateAction extends UpdateAction {
    public SearchTemplateAction() {
        this.setName(Inter.getLocText("FR-Designer_Template-Tree-Search"));
        this.setSmallIcon(BaseUtils.readIcon("/com/fr/plugin/designer/resource/search.png"));
    }

    @Override
    public void actionPerformed(ActionEvent e) {
        JOptionPane.showMessageDialog(null, "This is Search Demo");
        // 此處可進一步操作 TemplateFileTree 進行模板搜尋邏輯
    }
}

四、即時除錯驗證

• 在程式碼中設定中斷點（如 actionPerformed 內）。
• 以 Debug 模式啟動 MainFrame。
• 在設計器 UI 中觸發對應動作，程式會自動中斷，支援變數檢視、單步執行等完整除錯功能。

五、常見問題與技巧

• 資源檔案路徑： 國際化 .properties 檔與圖示需放置在 src/main/resources 對應包路徑下，並確保打包時被複製到輸出目錄。
• 熱部署： 修改程式碼後重新啟動 Main 類即可生效，無需打包安裝。
• 依賴衝突： 若專案引入的第三方庫版本與設計器內建版本衝突，優先使用設計器提供的版本。

掌握此工作流，即可告別「改代碼→打包→安裝→驗證」的低效循環，專注於插件業務邏輯的打磨。