天天看点

ExcelReport第二篇:ExcelReport源码解析

针对上一篇随笔收到的反馈,在展开对ExcelReport源码解析之前,我认为把编写该组件时的想法分享给大家是有必要的。

编写该组件时,思考如下:

为什么要将样式、格式与数据分离呢?恩,你不妨想一想在生成报表时,那些是变的而那些又是不变的。我的结论是:变的是数据。

有了这个想法,很自然的想到用模板去承载不变的部分(常量内容的样式、格式、数据及变量内容的样式、格式),在程序中控制变的部分(变量内容的数据)。

这里以上一篇中的例子标识:

ExcelReport第二篇:ExcelReport源码解析

变量内容已使用粉红色边框标出,其余为常量内容。好了,相信“内容的数据”大家都知道那个是那个的。下面截图,内容的样式和格式。

ExcelReport第二篇:ExcelReport源码解析
ExcelReport第二篇:ExcelReport源码解析

现在我们回到上篇中使用的模板,相信你应该知道它承载那些东西了。

ExcelReport第二篇:ExcelReport源码解析

啰嗦了这么多,总结一下样式、格式与数据分离的好处:它让我们编写程序时关注更少(只需关心“变量内容的数据”)。

为什么要抽象一个“元素格式化器”的概念呢?我们看数据源,我们有可能要将某个类型的数据填充到某个单元格、也可能将一个集合填充到多行、有可能将一张图片填充到某个位置、也有可能就将某个字符串合并到某个单元格的内容中......如此种种。那么它们有什么共同点呢?它们都是填充“变量内容的数据”到模板的。

有了上面的背景,这张UML想必不难理解了。

ExcelReport第二篇:ExcelReport源码解析

当然,如果你还是觉得复杂, 没关系。我会先介绍一下这里面几个重点关系。

这是一个静态类,非常简单。只有两个静态方法:ExportToLocal()、ExportToWeb()分别将生成的文件导出到本地和Web。这多半是废话了,下面是重点:

ExcelReport第二篇:ExcelReport源码解析

这便引出了SheetFormatterContainer类,SheetFormatterContainer类是何许也?

SheetFormatterContainer是一个存储“格式化一个Sheet用到的元素格式化器集合”的容器。

说到这,顺便说下:ElementFormatter类和SheetFormatterContext类。

ElementFormatter:元素格式化器。

SheetFormatterContext:Sheet格式化上下文。

回到Export:

如上代码,在执行导出的过程中,将每一个SheetFormatterContainer对象转换成了SheetFormatterContext对象。然后SheetFormatterContext对象调用自身的Format()方法格式化Sheet。

Formatters就是从SheetFormatterContainer传过来的“元素格式化器”集合。

ExcelReport第二篇:ExcelReport源码解析

抽象的“元素格式化器”:

ExcelReport第二篇:ExcelReport源码解析

至此,ExcelReport组件的核心部分已经介绍完成了,下面附上代码(如下代码仅供参考,了解ExcelReport组件最新动态,请到GitHub下载最新源码)。

ExcelReport第二篇:ExcelReport源码解析

SheetFormatterContainer.cs

SheetFormatterContext.cs

ElementFormatter.cs

CellFormatter.cs

TableFormatter.cs

ExportHelper.cs

Export.cs

Parameter.cs

ParameterCollection.cs

ExcelReport第二篇:ExcelReport源码解析

本文版权归作者和博客园共有,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接,否则保留追究法律责任的权利。

本文转自韩兆新博客博客园博客,原文链接:http://www.cnblogs.com/hanzhaoxin/p/4240398.html,如需转载请自行联系原作者

继续阅读