透過程式碼建立範本

1.1 應用場景

有時候需要批量生成 cpt 範本，手動操作比較繁瑣；可以藉助 FineReport 的 API 透過 Java 程式碼批量生成 cpt 範本。

1.2 實現思路

建立一個 WorkBook 後設定範本內容後將其匯出成 cpt 範本。

下面實現通程式式實現建立一個 cpt 檔案 company.cpt 。

2.1 準備編譯環境

編譯程式前，需先建立一個 Java 工程環境，並且需要一個 Java 編輯器，如 Eclipse 或 idea 。

在編輯器工程中引入 FineReport 工程 JAR 包。包括安裝的報表工程

• %FR_HOME%\webapps\webroot\WEB-INF\lib目錄下 fine 開頭的 12 個 JAR 包。

• %FR_HOME%\webapps\webroot\WEB-INF\lib目錄下的 sqlite-jdbc.jar

• %Tomcat_HOME%\libTomcat目錄下的 servlet-api.jar

• %JAVA_HOME%\jdk\lib JDK 目錄下的 tools.jar

• slf4j-simple-1.7.25.jar ，點選可下載：slf4j-simple-1.7.25.rar

• 如果報表中需要查詢資料庫，還需要匯入對應的 jdbc 驅動或者插件的 JAR 包（如使用 JSON 資料集，就要引入 JSON 資料集插件下的 JAR 包）。

詳細引入程式可參考：編譯Java程式 

2.2 編寫 Java 程式

在編輯器中編寫 Java 程式 CreateGenericTemplate.java，即引入必要類後，獲取範本，將範本匯出成指定格式的檔案。完整程式碼可參見：

注：使用者使用時，注意將範例程式碼中的工程路徑、範本名稱和匯出路徑取代為使用者自己工程下的。

package com.fr.io;

import com.fr.base.TableData;
import com.fr.base.operator.common.CommonOperator;
import com.fr.chart.activator.ChartBaseActivator;
import com.fr.cluster.engine.activator.standalone.StandaloneModeActivator;
import com.fr.config.activator.BaseDBActivator;
import com.fr.config.activator.ConfigurationActivator;
import com.fr.data.impl.DBTableData;
import com.fr.data.impl.NameDatabaseConnection;
import com.fr.env.operator.CommonOperatorImpl;
import com.fr.general.I18nResource;
import com.fr.general.data.TableDataColumn;
import com.fr.health.activator.ModuleHealActivator;
import com.fr.main.impl.WorkBook;
import com.fr.module.Module;
import com.fr.module.tool.ActivatorToolBox;
import com.fr.report.ReportActivator;
import com.fr.report.RestrictionActivator;
import com.fr.report.cell.DefaultTemplateCellElement;
import com.fr.report.cell.TemplateCellElement;
import com.fr.report.cell.cellattr.core.group.DSColumn;
import com.fr.report.module.ReportBaseActivator;
import com.fr.report.worksheet.WorkSheet;
import com.fr.report.write.WriteActivator;
import com.fr.scheduler.SchedulerActivator;
import com.fr.store.StateServiceActivator;
import com.fr.workspace.simple.SimpleWork;

import java.io.File;
import java.io.FileOutputStream;
import java.util.HashMap;

public class CreateGenericTemplate {
    public static void main(String[] args) throws Exception {
        // 首先需要定義執行所在的環境，這樣才能正確讀取資料庫資訊
        // 定義報表運作環境,用於執行報表
        Module module = ActivatorToolBox.simpleLink(new BaseDBActivator(),
                new ConfigurationActivator(),
                new ResourceRepositoryActivator(),
                new StandaloneModeActivator(),
                new ModuleHealActivator(),
                new StateServiceActivator(),
                new ChartBaseActivator(),
                new SchedulerActivator(),
                new ReportBaseActivator(),
                new RestrictionActivator(),
                new ReportActivator(),
                new WriteActivator());
        SimpleWork.supply(CommonOperator.class, new CommonOperatorImpl());
        String envpath = "//Applications//FineReport10_325//webapps//webroot//WEB-INF";//工程路徑
        SimpleWork.checkIn(envpath);
        I18nResource.getInstance();
        module.start();


        WorkBook wb = new WorkBook();
        //新增新的範本資料集
        TableData td = genericTableData("FRDemoTW", "SELECT * FROM Equipment");
        wb.putTableData("公司資訊", td);
        //建立第一個report 也就是sheet頁
        WorkSheet report = new WorkSheet();
        wb.addReport(report);
        //資料庫暫時先不讀，弄點假資料
        HashMap<Integer, String> map = new HashMap<Integer, String>();
        map.put(0, "Company");
        map.put(1, "Tel");
        //新增欗頭
        DefaultTemplateCellElement title = genericCell(0, 0, null, "這是標題");
        title.setRowSpan(2);
        title.setColumnSpan(2);
        report.addCellElement(title);
        //新增資料欄
        for (Integer key : map.keySet()) {
            TemplateCellElement cellHeaer = genericCell(2, key, null, map.get(key));
            report.addCellElement(cellHeaer);
            TemplateCellElement cell = genericCell(3, key, "公司資訊", map.get(key));
            report.addCellElement(cell);
        }
        //匯出範本
        FileOutputStream outputStream = new FileOutputStream(new File("//Users//susie//Downloads//company.cpt"));
        wb.export(outputStream);
        outputStream.close();
        module.stop();
        System.out.println("finished");
    }
    /*
     *生成TableData
     */
    private static TableData genericTableData(String conString, String sqlQuery) {
        NameDatabaseConnection database = new NameDatabaseConnection(conString);
        TableData td = new DBTableData(database, sqlQuery);
        return td;
    }
    /**
     * 新增儲存格
     * row 列號
     * column 欗號
     * dsName 資料集名稱 如 ds1
     * 資料欄名稱如 ds1中的id欗，則輸入 id
     */
    private static DefaultTemplateCellElement genericCell(int row, int column, String dsName, String columnName) {
        DefaultTemplateCellElement dtCell = new DefaultTemplateCellElement(row, column);
        if (dsName != null) {
            DSColumn dsColumn = new DSColumn();
            dsColumn.setDSName(dsName);
            dsColumn.setColumn(TableDataColumn.createColumn(columnName));
            dtCell.setValue(dsColumn);
        } else {
            dtCell.setValue(columnName);
        }
        return dtCell;
    }
}
//自動執行儲存程式，從裏面獲取結果集結的部分等研究一下jdbc再補

2.3 編譯 Java 檔案

Java 程式編寫完成後，在編譯器中編譯 CreateGenericTemplate.java ，編譯透過後，就會在程式碼中匯出路徑的資料夾下生成 company.cpt 檔案。如下圖所示：

設計器中開啟該範本，如下圖：