还在担心报表不好做？不用怕，试试这个方法

葡萄城控件

发布于 2024-01-31 08:12:57

1270

发布于 2024-01-31 08:12:57

文章被收录于专栏：葡萄城控件技术团队

前言

在各种业务场景中，我们经常需要生成各种报表，例如学校中的学生成绩表、商业场景中的销售单和发票单、测量检测场景中的检测报告等等。这些报表对于组织和管理数据非常重要，因为它们提供了直观、清晰的方式来展示和分析数据。

一般情况下，使用Excel设计和生成这些报表就可以，但是随着业务规模的扩大，需求也会逐渐由人工转变为电脑自动批量生成，这个时候再用Excel设计就非常慢了，因此今天小编为大家介绍一下如何使用编程语言来设计一个报表。

操作步骤

下图是一个简单的学生成绩表，以下表为例给大家介绍一下操作的具体步骤：

1. 抽象数据结构

首先按照报表中的字段（学号、姓名等）抽象对应的数据结构：

class Data {
    public String School;
    public int Grade;
    public int Class;
    public String PrintDate;
    public ArrayList<Score> Scores = new ArrayList<>();
}

class Score {
    public int SID;
    public String SName;
    public int Chinese;
    public int Math;
    public int English;

    public Score(int sid, String sName, int chinese, int math, int english) {
        this.SID = sid;
        this.SName = sName;
        this.Chinese = chinese;
        this.Math = math;
        this.English = english;
    }
}

2. 传数据

第二步小编将数据传入到第一步生成数据结构的Scores 队列中。

private static Data CreateData() {
    Data data = new Data();
    data.School = "高新第六小学";
    data.Grade = 1;
    data.Class = 2;
    data.PrintDate = "2023年1月5日";

    data.Scores.add(new Score(1, "李明", 98, 100, 96));
    data.Scores.add(new Score(2, "王芳", 96, 97, 98));
    data.Scores.add(new Score(3, "张锋", 99, 99, 95));
    data.Scores.add(new Score(4, "高明", 94, 96, 100));
    data.Scores.add(new Score(5, "沈梦", 90, 94, 93));
    data.Scores.add(new Score(6, "张菲", 93, 94, 95));
    data.Scores.add(new Score(7, "白洁", 95, 92, 94));
    data.Scores.add(new Score(8, "王鹏", 96, 97, 99));
    data.Scores.add(new Score(9, "刘玲", 96, 93, 94));
    data.Scores.add(new Score(10, "李丽", 94, 98, 99));
    return data;
}

3. 生成报表逻辑

生成数据之后，下面是编写生成一个报表的代码，该代码创建了一个工作簿并添加了一个工作表。除了添加数据外，还配置了报表所需的样式。

可以看到，该代码量不小且与业务高度相关。如果报表的样式或布局发生变化，就需要调整代码，这种情况下，维护成本会很高。

Data data = CreateData();

Workbook workbook = new Workbook();
IWorksheet worksheet = workbook.getWorksheets().get(0);

worksheet.getRange("A1").setValue(data.School);
worksheet.getRange("A3").setValue("年级");
worksheet.getRange("B3").setValue(data.Grade);
worksheet.getRange("D3").setValue("班级");
worksheet.getRange("E3").setValue(data.Class);

Object[] array = new Object[]{"学号", "姓名", "语文", "数学", "英语"};
worksheet.getRange("A5:E5").setValue(array);

worksheet.getRange("D7").setValue("打印日期");
worksheet.getRange("E7").setValue("2023年1月5日");

//报表样式
worksheet.getRange("A1:E1").setColumnWidthInPixel(140);
worksheet.getRange("1:2").setRowHeightInPixel(50);

worksheet.getRange("A1:E1").merge();
worksheet.getRange("A1").getFont().setSize(16);
worksheet.getRange("A1").setHorizontalAlignment(HorizontalAlignment.Center);

worksheet.getRange("B3,E3").getBorders().get(BordersIndex.EdgeBottom).setColor(Color.GetBlack());
worksheet.getRange("A3:E3,D7").setHorizontalAlignment(HorizontalAlignment.Center);

worksheet.getRange("E7").setHorizontalAlignment(HorizontalAlignment.Right);


int baseRow = 5;
int dataRowCount = data.Scores.size();
worksheet.getRange(5, 0, dataRowCount, 1).getEntireRow().insert(InsertShiftDirection.Down);
for (int i = 0; i < data.Scores.size(); i++) {
    worksheet.getRange(baseRow + i, 0).setValue(data.Scores.get(i).SName);
    worksheet.getRange(baseRow + i, 1).setValue(data.Scores.get(i).SID);
    worksheet.getRange(baseRow + i, 2).setValue(data.Scores.get(i).Chinese);
    worksheet.getRange(baseRow + i, 3).setValue(data.Scores.get(i).Math);
    worksheet.getRange(baseRow + i, 4).setValue(data.Scores.get(i).English);
}

worksheet.getRange("A5:E5").getInterior().setColor(Color.FromArgb(21, 96, 130));
worksheet.getRange("A5:E5").getFont().setColor(Color.GetWhite());
worksheet.getRange("A5:E5").setHorizontalAlignment(HorizontalAlignment.Center);

worksheet.getRange(baseRow, 0, dataRowCount, 5).getInterior().setColor(Color.FromArgb(192, 230, 245));
worksheet.getRange(baseRow - 1, 0, dataRowCount + 1, 5).getBorders().setColor(Color.FromArgb(68, 179, 225));
worksheet.getRange(baseRow - 1, 0, dataRowCount + 1, 2).setHorizontalAlignment(HorizontalAlignment.Center);

worksheet.getSheetView().setDisplayGridlines(false);

4. 通过模板简化生成报表逻辑代码

通过第三步的代码可以发现，许多样式，如字体、列宽、行高和颜色等都是相同的，但数据和布局却与业务密切相关，并随着报表而变化。为了解决上述问题，可以将报表抽象为一个Excel模板，并保留不变的内容，移除可变的内容，如下图所示：

这样小编就可以简化报表样式部分的代码，保留核心代码，如下所示：

Data data = CreateData();

Workbook workbook = new Workbook();
workbook.open("template.xlsx");
IWorksheet worksheet = workbook.getWorksheets().get(0);

worksheet.getRange("A1").setValue(data.School);
worksheet.getRange("B3").setValue(data.Grade);
worksheet.getRange("E3").setValue(data.Class);
worksheet.getRange("E8").setValue("2023年1月5日");

int baseRow = 5;
int dataRowCount = data.Scores.size();
worksheet.getRange(baseRow + 1, 0, dataRowCount - 1, 1).getEntireRow().insert(InsertShiftDirection.Down);
worksheet.getRange(baseRow, 0, 1, 5).copy(worksheet.getRange(baseRow + 1, 0, dataRowCount - 1, 5));
//循环给报表中的字段传值
for (int i = 0; i < data.Scores.size(); i++) {
    worksheet.getRange(baseRow + i, 0).setValue(data.Scores.get(i).SName);
    worksheet.getRange(baseRow + i, 1).setValue(data.Scores.get(i).SID);
    worksheet.getRange(baseRow + i, 2).setValue(data.Scores.get(i).Chinese);
    worksheet.getRange(baseRow + i, 3).setValue(data.Scores.get(i).Math);
    worksheet.getRange(baseRow + i, 4).setValue(data.Scores.get(i).English);
}

可以看到，剥离掉样式的代码，简化了很多。但是，布局的调整，尤其是需要根据数据量调整行列，还是没有做到完全的业务解耦。

5. 使用模板语言二次简化代码

为了进一步解决第四步中的问题，我们可以通过模板语言，将报表改造成模板文件，来彻底做到业务解耦。将业务需求留在模板文件中，大大降低了代码维护的成本。下面小编对第四步的模板进行一些改造，如下图所示：

可以看到，和第四步的模板相比，新的模板将字段（年龄、班级等）对应的值以参数值表示，以{{ds.School}}为例，模板语言由两个大括号组成，中间的字符串表示从名为ds的数据源中，将School字段填充至 C1 单元格中。

下面是使用报表语言后简化后的代码：

Workbook workbook = new Workbook();
workbook.open("template.xlsx");
workbook.addDataSource("ds",CreateData());
workbook.processTemplate();
workbook.save("reprot.xlsx");

展示效果：